User Interface Controls > Common Properties > Layout > Types > Checkbox |
A checkbox control is used to place a check box on the rollout. The user can click to successively switch between states.
checkbox <name> [<caption>] [checked:<boolean>] [triState:<integer>][tooltip:<string>] [iconName:<filename> iconSize:<point3>]
The default alignment of checkbox items is #left .
Initial state of the check box, defaults to false (unchecked).
An integer value controlling the checked state of the checkbox as follows:
2 - indeterminate (checked:true)
When set to 2 (indeterminate), the checkbox will be displayed as greyed out and checked at the same time. Note that triState : has a higher priority than checked : which means that if you set the parameter checked : to false and the parameter triState : to 2 , the . checked property will return true . The checked : parameter / property remains <boolean> for backwards compatibility.
Clicking an indeterminate checkbox changes its state to unchecked.
A string defining the tooltip to be displayed when the mouse rolls over the checkbox. Available in 3ds Max 2009 and higher.
iconName:
The filename of an icon to use as an image on the button. If iconName is specified, the caption is ignored. The iconSize specifies the iconName size at 100% DPI scaling. If not specified, the default [24,24] is assumed.
iconSize:
The size of the icon specified by iconName at 100% DPI scaling.
The state of the check box, on ( true ) or off ( false ).
Get/Set the state of the checkbox to checked, unchecked or indeterminate. See the triState: parameter for details.
Get/set the tooltip of the checkbox. Available in 3ds Max 2009 and higher.
Called when the user clicks the check box to check or uncheck it. The <arg> argument contains the new state of the check box, on ( true ) or off ( false ).
Called when the Checkbox control is right-clicked.
Available in 3ds Max 2010 and higher.