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.v23.2.dll

NuGet Package: DevExpress.Win.Navigation

Declaration

C#

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

VB.NET

<DXCategory("Behavior")>
<DefaultValue(False)>
Public Property CheckOnClick As Boolean

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:

• Item hot-tracking is disabled (the HotTrackItems property is set to false).
• Item hot-tracking is enabled, the HotTrackSelectMode property is set to SelectItemOnClick, and the HighlightedItemStyle property is set to Default or Skinned.

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.