C1ToolBarCheckButton defines a toolbar check button on a toolbar. By default, the C1ToolBarCheckButton includes an image for the rectangular box and text that indicates a choice a user can make by selecting the button. Check buttons enable users to choose from one or more options that are not mutually exclusive. The C1ToolBarCheckButton changes between two states when clicked.
There are two types of C1ToolBarCheckButtons: simple or indeterminate. The simple check button has two states and the indeterminate has three states.
The two states check button includes a checked (a check mark inside the box) or unchecked (no check mark). The three states check button includes a checked, unchecked, and indeterminate state (a shaded box inside the check box). The indeterminate state might indicate that the user has not made a choice.
The C1ToolBarCheckButton can have the following states:
Checked The button includes a checkmark and it appears pressed.
Unchecked The button does not have a check mark and it appears unpressed.
Indeterminate The button includes a grey checkmark and it appears upressed.
A distinct appearance reflects each state as shown in the following image:
You can control how the check button behaves when it is rendered using the following properties:
|
Property |
Definition |
|
Gets or sets a value indicating whether the C1ToolBarButtonItem is pressed or not. | |
|
Gets or sets a value indicating whether the C1ToolBarCheckButton should automatically appear pressed in and not pressed in when clicked. | |
|
Gets or sets a value indicating whether the C1ToolBarCheckButton is in the pressed state or not pressed state by default, or is in an indeterminate state. |
The appearance of the check button can be modified through its CSS selectors included in the C1ToolBar installation with each visual style. For more information on C1ToolBarCheckButton styles, see C1ToolBar Check Button Styles.
|
