A newer version of this page is available. Switch to the current version.

CheckedListBoxItem.Enabled Property

Gets or set whether an end-user can change the item's state.

Namespace: DevExpress.XtraEditors.Controls

Assembly: DevExpress.XtraEditors.v19.2.dll

Declaration

[DefaultValue(true)]
[DXCategory("Behavior")]
public virtual bool Enabled { get; set; }

Property Value

Type Default Description
Boolean

true

true if the item is enabled and an end-user can change its state; otherwise, false.

Remarks

Use the Enabled property to temporarily disable an item. The disabled item is displayed grayed and doesn't respond to mouse events. An end-user cannot change its state, i.e. the BaseCheckedListBoxControl.ItemChecking event is not raised when clicking the item.

The image below shows the CheckedListBox control with enabled and disabled items.

CheckedListBoxItem_Enabled

Note: the item's checked state can be changed via code regardless of the Enabled property's value.

To disable specific items in bound mode, handle the BaseCheckedListBoxControl.GetItemEnabled event.

See Also