<button> Element
The <button> element creates a button control. The element can have the following child element:
<script>
The <button> 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 # followed by three two-digit hexadecimal numbers specifying the red, green, and blue (RGB) intensity values defining a color.
• command = CDATA
Specifies the Arbortext ACL command to execute. (Toolbars only.)
• disabled = true | false
Default is false. If true, the control ignores all user interface events directed toward the control.
• dropdown = CDATA
The id or name of a dropdown menu for this control that is displayed when the button is activated. The value can be specified in an id attribute of a <popupmenu> element, or it can be the name of a shortcut menu loaded from a menu configuration file.
Adding a drop down menu to a button visually changes the button. A down arrow is displayed in the button to the right of the label.
If this attribute has no value, or if the value is not the id of a menu defined in the XUI dialog box file or that of a name loaded from a menu configuration file, no menu is displayed and the button performs its default activation behavior.
• 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 within 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 windows.
• tiptext = CDATA
Specifies the text to display as context-sensitive help for this control.
• type = accept | cancel | help
Specifies a key event that activates the button when the event occurs within the dialog box. accept is typically activated by the Enter key being pressed. cancel is typically activated by the ESC key being pressed.
• 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.