Skip to main content

BaseCheckedListBoxControl.CheckOnClick Property

Gets or sets whether one or two mouse clicks are required to toggle the check state of an unfocused (unselected) item.

Namespace: DevExpress.XtraEditors

Assembly: DevExpress.XtraEditors.v24.1.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

[DefaultValue(false)]
[DXCategory("Behavior")]
public bool CheckOnClick { get; set; }

Property Value

Type Default Description
Boolean false

true if a single mouse click is required to toggle the check state of an unfocused (unselected) item; false if two mouse clicks are required.

Remarks

Two clicks are required to change the check state of an unfocused item. The first click moves focus to the item and the second toggles its check state. Set the CheckOnClick property to true to focus the item and toggle its check state in one click.

The CheckOnClick property is in effect in two cases:

Note

The CheckOnClick property is ignored when multiple item selection is enabled.

The editor raises the ItemCheck event when an item’s check state changes.

Use the CheckedItems and CheckedIndices properties to obtain checked items and their indices.

See Also