Skip to main content

BaseCheckedListBoxControl.ItemChecking Event

Fires before an item’s check state changes and allows you to cancel the action.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.2.dll

Declaration

[DXCategory("Behavior")]
public event ItemCheckingEventHandler ItemChecking

Event Data

The ItemChecking event's data class is ItemCheckingEventArgs. The following properties provide information specific to this event:

Property Description
Cancel Gets or sets a value indicating whether the event should be canceled. Inherited from CancelEventArgs.
Index Gets the index of the item whose checked state is about to be changed.
IsBoundUpdatingEditValue For internal use. Inherited from ChangingEventArgs.
IsTextChanging For internal use. Inherited from ChangingEventArgs.
ModifiedByUser Gets whether a user changed the value. Inherited from ChangingEventArgs.
NewValue Gets or sets a new checked state for the item.
OldValue Gets the item’s previous checked state.

Remarks

The ItemChecking event fires when an item’s check state is about to be changed by the user or in code. The OldValue and NewValue event arguments return the current check state and the state that is about to be set. The Index event argument returns the processed item’s index. If items in the list box are filtered (see SearchControl), this argument returns the item’s index in the filtered list. To cancel the action, set the Cancel parameter to true.

The ItemCheck event fires after the check state changes.

See Also