BarSplitCheckItem Class

Combines a checkbox and dropdown buttons in one item.

Assembly: DevExpress.Xpf.Core.v19.1.dll

Declaration

C#
VB.NET

public class BarSplitCheckItem :
    BarSplitButtonItem,
    IBarCheckItem

Public Class BarSplitCheckItem
    Inherits BarSplitButtonItem
    Implements IBarCheckItem

Remarks

The BarSplitCheckItem supports the drop-down functionality, displaying a drop-down window when clicking the item link. The BarSplitCheckItem contains the main check button, displaying the item’s content and glyph, and a Down Arrow button.

Clicking the check button toggles the item’s check state and fires the BarSplitCheckItem.CheckedChanged event and a command (BarItem.Command).

Clicking the Down Arrow button invokes the drop-down control, specified by the inherited BarSplitButtonItem.PopupControl property.

BarSplitCheckItem

You can hide the Down Arrow button via the inherited BarSplitButtonItem.ActAsDropDown property. In this instance, clicking the main button invokes the CheckedChanged events and the specified command. And, in addition, the assigned drop-down control pops up.

If the BarSplitCheckItem.IsThreeState property is set to false, two states are supported for the check button - Checked and Unchecked. If this property is set to true, the check button supports three states - Checked, Unchecked and Indeterminate. To change the button’s check state in code, use the BarSplitCheckItem.IsChecked property.