Back to Devexpress

BaseCheckedListBoxControl.ItemChecking Event

windowsforms-devexpress-dot-xtraeditors-dot-basecheckedlistboxcontrol-6e38c35b.md

latest3.9 KB
Original Source

BaseCheckedListBoxControl.ItemChecking Event

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

Namespace : DevExpress.XtraEditors

Assembly : DevExpress.XtraEditors.v25.2.dll

NuGet Package : DevExpress.Win.Navigation

Declaration

csharp
[DXCategory("Behavior")]
public event ItemCheckingEventHandler ItemChecking
vb
<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:

PropertyDescription
CancelGets or sets a value indicating whether the event should be canceled. Inherited from CancelEventArgs.
IndexGets the index of the item whose checked state is about to be changed.
IsBoundUpdatingEditValueFor internal use. Inherited from ChangingEventArgs.
IsTextChangingFor internal use. Inherited from ChangingEventArgs.
ModifiedByUserGets whether a user changed the value. Inherited from ChangingEventArgs.
NewValueGets or sets a new checked state for the item.
OldValueGets 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

ItemCheck

CheckMode

BaseCheckedListBoxControl Class

BaseCheckedListBoxControl Members

DevExpress.XtraEditors Namespace