BaseCheckedListBoxControl.ItemChecking Event

Enables you to restrict item state changes.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v18.1.dll

Declaration

C#

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

VB.NET

<DXCategory("Behavior")>
Public Event ItemChecking As ItemCheckingEventHandler

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.
NewValue	Gets or sets a new checked state for the item.
OldValue	Gets the item’s previous checked state.

Remarks

The ItemChecking event is raised when the item’s state is about to be changed (a mouse click or the SPACE key is pressed). The event parameter’s Index property represents the index of the item being changed. The potential new state can be identified by the NewValue parameter. The current state is identified by the OldValue parameter. To prevent the modification, set the Cancel parameter to true.