New to Telerik UI for WinForms? Start a free 30-day trial

Represents a group header in a RadListView and exposes the items belonging to that group. Its Expanded state controls whether those items are displayed; a group can represent either a data-view group or a custom group.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
[TypeConverter(typeof(ListViewDataItemGroupTypeConverter))]
public class ListViewDataItemGroup : ListViewDataItem, IDataItem, INotifyPropertyChanged, INotifyPropertyChangingEx, IDisposable

Inheritance: objectListViewDataItemListViewDataItemGroup

Implements: IDataItemIDisposableINotifyPropertyChangedINotifyPropertyChangingEx

Inherited Members ListViewDataItem.IsSelectedStateListViewDataItem.IsEnabledStateListViewDataItem.IsVisibleStateListViewDataItem.IsLastInRowStateListViewDataItem.IsCurrentStateListViewDataItem.IsMeasureValidStateListViewDataItem.MajorBitStateListViewDataItem.bitStateListViewDataItem.IndexOf(string)ListViewDataItem.GetBoundValue()ListViewDataItem.GetUnboundValue()ListViewDataItem.SetUnboundValue(object)ListViewDataItem.SetBoundValue(object)ListViewDataItem.SetDataBoundItem(bool, object)ListViewDataItem.GetValue(string)ListViewDataItem.GetDisplayValue()ListViewDataItem.GetFormattedValue(object)ListViewDataItem.GetBoundCheckedValue()ListViewDataItem.FormatToggleStateDataSourceValue(object)ListViewDataItem.FormatToggleStateValue(ToggleState, PropertyDescriptor)ListViewDataItem.OnNotifyPropertyChanged(string)ListViewDataItem.OnNotifyPropertyChanging(string)ListViewDataItem.KeyListViewDataItem.ImageKeyListViewDataItem.ImageIndexListViewDataItem.SizeListViewDataItem.CurrentListViewDataItem.ActualSizeListViewDataItem.HasStyleListViewDataItem.GroupListViewDataItem.TagListViewDataItem.ListViewListViewDataItem.OwnerListViewDataItem.ValueListViewDataItem.TextListViewDataItem.EnabledListViewDataItem.VisibleListViewDataItem.CheckStateListViewDataItem.ImageListViewDataItem.SvgImageListViewDataItem.TextImageRelationListViewDataItem.TextAlignmentListViewDataItem.ImageAlignmentListViewDataItem.FontListViewDataItem.ForeColorListViewDataItem.BackColorListViewDataItem.BackColor2ListViewDataItem.BackColor3ListViewDataItem.BackColor4ListViewDataItem.BorderColorListViewDataItem.GradientAngleListViewDataItem.GradientPercentageListViewDataItem.GradientPercentage2ListViewDataItem.GradientStyleListViewDataItem.NumberOfColorsListViewDataItem.DataBoundItemListViewDataItem.FieldCountListViewDataItem.this[string]ListViewDataItem.this[int]ListViewDataItem.this[ListViewDetailColumn]ListViewDataItem.PropertyChangedListViewDataItem.PropertyChanging...

Constructors

Creates an empty group with its items initially expanded.

C#
public ListViewDataItemGroup()

Creates an empty, initially expanded group with the specified header text.

C#
public ListViewDataItemGroup(string text)
Parameters:textstring

The text displayed for the group header.

Fields

Mask for the group's expanded state in the inherited item state vector.

C#
protected const int ExpandedState = 64

Properties

Gets the data group that is assigned to this group.

C#
[Browsable(false)]
public Group<ListViewDataItem> DataGroup { get; }

Gets or sets a value indicating whether the group's items should be displayed.

C#
[Browsable(true)]
public bool Expanded { get; set; }

Gets whether this group object is bound directly to a data source. The group itself is not a bound item; its DataGroup may still represent a group created from bound data.

C#
[Browsable(false)]
public override bool IsDataBound { get; }
Property Value:

Always false.

Overrides: ListViewDataItem.IsDataBound

Gets the items in this group.

C#
[Browsable(false)]
public ListViewGroupedItemsCollection Items { get; }

Gets whether the group is selected. In multi-select mode, this state reflects whether all items in the group are selected.

C#
[Browsable(false)]
public override bool Selected { get; }
Property Value:

true when the group is selected; otherwise, false.

Overrides: ListViewDataItem.Selected

Methods

Clears the group's item associations, disposes its item collection, and releases base item resources.

C#
public override void Dispose()

Overrides: ListViewDataItem.Dispose()

Propagates owner changes to the group's items and notifies the owner after the expanded state changes.

C#
protected override void OnNotifyPropertyChanged(PropertyChangedEventArgs args)
Parameters:argsPropertyChangedEventArgs

The property-change event data.

Overrides: ListViewDataItem.OnNotifyPropertyChanged(PropertyChangedEventArgs)

Cancels an expansion change if either the item's property-changing notification or the owning list view's group-expanding event cancels it.

C#
protected override bool OnNotifyPropertyChanging(PropertyChangingEventArgsEx args)
Parameters:argsPropertyChangingEventArgsEx

The property-changing event data for the requested change.

Returns:

bool

true if the expansion change is cancelled; otherwise, false.

Overrides: ListViewDataItem.OnNotifyPropertyChanging(PropertyChangingEventArgsEx)