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

A list item whose checked state is tracked separately from selection and can be synchronized with a bound data item.

Definition

Namespace:Telerik.WinControls.UI

Assembly:Telerik.WinControls.UI.dll

Syntax:

C#
public class RadCheckedListDataItem : RadListDataItem, IDisposable, INotifyPropertyChanged, ICustomTypeDescriptor, IDataItem

Inheritance: objectDisposableObjectRadObjectRadListDataItemRadCheckedListDataItem

Derived Classes: CheckAllDataItemDescriptionTextCheckedListDataItem

Implements: ICustomTypeDescriptorIDataItemIDisposableINotifyPropertyChanged

Inherited Members RadListDataItem.HeightPropertyRadListDataItem.ActivePropertyRadListDataItem.SelectedPropertyRadListDataItem.ValuePropertyRadListDataItem.dataLayerRadListDataItem.ownerElementRadListDataItem.OnPropertyChanged(RadPropertyChangedEventArgs)RadListDataItem.ToString()RadListDataItem.GetBoundValue()RadListDataItem.GetUnboundValue()RadListDataItem.SetUnboundValue(object)RadListDataItem.TagRadListDataItem.IsDataBoundRadListDataItem.OwnerControlRadListDataItem.HeightRadListDataItem.TextWrapRadListDataItem.RowIndexRadListDataItem.DisplayValueRadListDataItem.ValueRadListDataItem.ActiveRadListDataItem.SelectedRadListDataItem.EnabledRadListDataItem.TextRadListDataItem.ImageRadListDataItem.SvgImageRadListDataItem.TextImageRelationRadListDataItem.ImageAlignmentRadListDataItem.TextAlignmentRadListDataItem.TextOrientationRadListDataItem.FontRadListDataItem.ForeColorRadListDataItem.IsVisibleRadListDataItem.VisualItemRadListDataItem.MeasuredSizeRadListDataItem.IndexRadListDataItem.DataBoundItemRadObject.BindingContextPropertyRadObject.RadTypeRadObject.ReplaceDefaultDescriptors(PropertyDescriptorCollection)RadObject.DisposeManagedResources()RadObject.ClearPropertyStore()RadObject.SuspendPropertyNotifications()RadObject.ResumePropertyNotifications()RadObject.GetPropertyValue(RadProperty)RadObject.SetDefaultValueOverride(RadProperty, object)RadObject.GetValue(RadProperty)RadObject.SetValue(RadProperty, object)RadObject.ResetValue(RadProperty)RadObject.ResetLocalValue(RadProperty)RadObject.ResetValue(RadProperty, ValueResetFlags)RadObject.UpdateValue(RadProperty)RadObject.GetValueSource(RadProperty)RadObject.GetRegisteredRadProperty(string)RadObject.UpdateValueCore(RadPropertyValue)RadObject.SetValueCore(RadPropertyValue, object, object, ValueSource)RadObject.ResetValueCore(RadPropertyValue, ValueResetFlags)RadObject.GetDefaultValue(RadPropertyValue, object)RadObject.CoerceValue(RadPropertyValue, object)RadObject.ShouldSerializeProperty(RadProperty)RadObject.CanRaisePropertyChangeNotifications(RadPropertyValue)RadObject.BindProperty(RadProperty, RadObject, RadProperty, PropertyBindingOptions)RadObject.UnbindProperty(RadProperty)RadObject.AddStylePropertySetting(IPropertySetting)RadObject.GetInheritedValue(RadProperty)RadObject.OnPropertyChanging(RadPropertyChangingEventArgs)RadObject.OnNotifyPropertyChanged(PropertyChangedEventArgs)RadObject.OnShouldSerializeProperty(ShouldSerializePropertyEventArgs)RadObject.IsPropertyCancelable(RadPropertyMetadata)RadObject.PropertyValuesRadObject.PropertyFilterRadObject.RadObjectTypeRadObject.BindingContextRadObject.PropertyChangedRadObject.RadPropertyChangedRadObject.RadPropertyChangingDisposableObject.GetBitState(long)DisposableObject.SetBitState(long, bool)DisposableObject.OnBitStateChanged(long, bool, bool)DisposableObject.Dispose()DisposableObject.Dispose(bool)DisposableObject.PerformDispose(bool)DisposableObject.DisposeUnmanagedResources()DisposableObject.BitStateDisposableObject.EventsDisposableObject.IsDisposingDisposableObject.IsDisposedDisposableObject.DisposedDisposableObject.Disposing...

Constructors

Initializes an unchecked list item.

C#
public RadCheckedListDataItem()

Initializes a list item with the specified display text and checked state.

C#
public RadCheckedListDataItem(string text, bool check)
Parameters:textstring

The text displayed for the item.

checkbool

The initial checked state.

Initializes an unchecked list item with the specified display text.

C#
public RadCheckedListDataItem(string text)
Parameters:textstring

The text displayed for the item.

Fields

Identifies the property-system value that stores this item's checked state.

C#
public static readonly RadProperty CheckedProperty

Properties

Gets or sets whether this item is checked; a matching public checked member supplies the state for an attached data-bound item.

C#
public virtual bool Checked { get; set; }

For an item with a valid owner element tree, checked-state changes pass through the owner's changing event and then this item's PropertyChanging event, and either handler can cancel the change. An unattached item has no such cancellation callbacks. When an item with a valid owner element tree reports a state change, the owner updates its checked-items collection and raises the changed event.

Gets the list element that hosts this item; when attached, the item is also registered with the checked drop-down list.

C#
public override RadListElement Owner { get; }

Overrides: RadListDataItem.Owner

Methods

Processes a property-change notification, updating the checked-list owner when propertyName is Checked.

C#
protected override void OnNotifyPropertyChanged(string propertyName)
Parameters:propertyNamestring

The name of the property that changed.

Overrides: RadObject.OnNotifyPropertyChanged(string)

For checked-state changes with a valid owner element tree, invokes the owner's cancellable item event before this item's changing event. For an unattached item, both callbacks are skipped; changes to other properties raise this item's event only.

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

The property-change data whose cancellation state is shared with the callbacks when they are raised.

Returns:

bool

true if a raised callback leaves the change canceled.

Creates property-change event data and passes it through the cancellable notification path.

C#
protected virtual bool OnNotifyPropertyChanging(string propertyName)
Parameters:propertyNamestring

The name of the property about to change.

Returns:

bool

true if a handler cancels the change.

Provides a subclass hook invoked after this item's checked state changes.

C#
protected virtual void OnSelectedItemChanged(EventArgs e)
Parameters:eEventArgs

The event data supplied by the state-change caller; the built-in callers pass Empty.

Assigns the underlying data object and initializes the checked state from the configured checked member.

C#
protected override void SetDataBoundItem(bool dataBinding, object value)
Parameters:dataBindingbool

Indicates whether the assignment comes from the data-binding engine.

valueobject

The underlying data object to store.

Overrides: RadListDataItem.SetDataBoundItem(bool, object)

Events

Occurs before a property change. For Checked, it is raised only when this item has a valid owner element tree. Setting Cancel cancels the change.

C#
public event PropertyChangingEventHandlerEx PropertyChanging