Customizer's Guide > Working with XUI (XML-based User Interface) Dialog Boxes > XUI Element Reference > <checkbox> Element
  
<checkbox> Element
The <checkbox> element creates a check box control. The element can have the following child element:
<script>
The <checkbox> element has the following attributes:
backgroundcolor = CDATA
Specifies the color to use in drawing the control's background. Values can be the standard HTML named colors plus the Arbortext colors gray1, gray2, gray3, gray4, gray5. Colors can also be a string of a # followed by three two-digit hexadecimal numbers specifying the red, green, and blue (RGB) intensity values defining a color.
checked = true | false
Default is false. If true, the control has a checked state.
checkstate = checked | unchecked | indeterminate
Default is unchecked. If checked, the item is selected. If unchecked, the item is not selected. If indeterminate, the item displays no state. (It is disabled.)
command = CDATA
Specifies the Arbortext ACL command to execute. (Checkbox toolbar button only.)
disabled = true | false
Default is false. If true, the control ignores all user interface events directed toward the control.
family = CDATA
Specifies the font family.
fontposture = italic | upright
Default is upright. Specifies the control's font posture.
fontsize = CDATA
Specifies the control's font size in points.
fontstyle = monsanserif | monoserif | sanserif | serif
Default is sanserif. Specifies the control's font style.
fontweight = bold | medium
Default is medium. Specifies the control's font weight.
foregroundcolor = CDATA
Specifies the color to use in drawing the control's foreground. Values can be the standard HTML named colors plus the Arbortext colors gray1, gray2, gray3, gray4, gray5. Colors can also be a string of a # followed by three two-digit hexadecimal numbers specifying the red, green, and blue (RGB) intensity values defining a color.
height = CDATA
Number specifying the height in pixels to allocate for this control.
helpid = CDATA
Number specifying the help topic to display for this control.
hidden = true | false
Default is false. If true, the space for the control is allocated, but the control itself is not displayed.
id = ID
Identifies the control.
image = IDREF
Specifies by reference the graphical image to be displayed in this control. The value of image matches the value of the image element id attribute specifying the desired graphic file.
label = CDATA
Specifies the text to display next to the control.
resize = none | both | height | width | natural
Default is natural. If width, the control allows horizontal resizing only. If height, the control allows vertical resizing only. If both, the control allows resizing in both directions. If none, the control doesn't resize in either direction. If natural, the control is not resizeable.
statustext = CDATA
Specifies the text to display in status controls.
tiptext = CDATA
Specifies the text to display as context-sensitive help for this control.
type = twostate | threestate
Default is twostate. If twostate, the control can be either checked or unchecked (specified by checked). If threestate, the control can be checked, unchecked, or indeterminate (specified by checkstate).
width = CDATA
Number specifying the width in pixels to allocate for this control.
withdraw = true | false
Default is false. If true, the control (and any children) is ignored and not displayed.