Checked
property for PowerScript controls
Applies to
CheckBox, RadioButton controls, and Menu objects
Ribbon 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.
|
1 |
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.