RibbonToolbarCheckBox Class

Assembly: DevExpress.WinUI.Ribbon.v21.1.dll

Declaration

C#
VB.NET

public class RibbonToolbarCheckBox :
    RibbonToggleItemBase,
    IRibbonToolbarItem,
    IRibbonItemBase,
    IVisualItem

Public Class RibbonToolbarCheckBox
    Inherits RibbonToggleItemBase
    Implements IRibbonToolbarItem,
               IRibbonItemBase,
               IVisualItem

Remarks

The following code sample displays a RibbonToolbarCheckBox in a RibbonToolbarControl:

XAML

<Ribbon:RibbonToolbarControl>
    <Ribbon:RibbonToolbarTab Caption="Page Layout" >
        <Ribbon:RibbonToolbarGroup Caption="Sheet Options">
            <Ribbon:RibbonToolbarCheckBox Content="View Gridlines" IsChecked="False"/>
            <Ribbon:RibbonToolbarCheckBox Content="Print Gridlines" IsChecked="True"/>
        </Ribbon:RibbonToolbarGroup>
    </Ribbon:RibbonToolbarTab>
</Ribbon:RibbonToolbarControl>

Indeterminate State

The IsChecked property specifies a checkbox’s state.

The following sample creates a checkbox with the indeterminate state. The IsChecked property is bound to a Nullable Boolean object.

Set the IsThreeStateMode property to true to allow users to set the indeterminate state.

The default checkbox state is indeterminate. Users can change the state in the following order: Indeterminate -> Checked -> Unchecked -> Indeterminate, and so on.

If the IsThreeStateMode is set to false, users can switch states in the following order: Indeterminate (default) -> Checked -> Unchecked -> Checked -> Unchecked, and so on.

Customize Appearance

You can use the following properties to customize the RibbonToolbarCheckBox appearance:

Property	Description
Background	Gets or sets a RibbonToolbarCheckBox background.
BorderBrush	Gets or sets a RibbonToolbarCheckBox border brush.
BorderThickness	Gets or sets a RibbonToolbarCheckBox border thickness.
Foreground	Gets or sets a RibbonToolbarCheckBox state foreground.
Height	Gets or sets a RibbonToolbarCheckBox height.
Margin	Gets or sets a RibbonToolbarCheckBox margin.
Opacity	Gets or sets RibbonToolbarCheckBox opacity.
ToolTipService.ToolTip	Gets or sets a RibbonToolbarCheckBox tooltip.
ToolTipService.Placement	Gets or sets a RibbonToolbarCheckBox tooltip position.
Visibility	Gets or sets RibbonToolbarCheckBox visibility.
Width	Gets or sets a RibbonToolbarCheckBox width.