Applies to
CheckBox, RadioButton controls, and Menu objects
Ribbon item controls (including RibbonTabButtonItem, RibbonLargeButtonItem, RibbonSmallButtonItem, RibbonCheckBoxItem, and RibbonMenuItem)
Description
When the value of the Checked property is TRUE, the item or control is selected.
|
Control |
Displayed when selected |
|---|---|
|
CheckBox |
X displays in the check box |
|
Menu item |
Check mark displays next to the item |
|
RadioButton |
Center of button becomes dark |
If Checked is false, the item or control is not selected.
Usage
In a painter
To set the Checked property on a control:
-
Select the Checked check box on the General page of the control's Properties view.
To set the Checked property on a menu item:
-
Select the menu item in the Menu painter.
-
Select the Checked check box on the General page.
In scripts
The Checked property takes a boolean value. The following example sets the Checked property of a RadioButton to true, which causes the button to be selected.
rb_1.Checked = TRUE
For menu items in drop-down or cascading menus, you can also use the Check and Uncheck functions. See the descriptions of those functions for examples of equivalent syntax.
