<groupbox> Element
The <groupbox> element creates a group box control. The element can have the following child elements:
<box>, <button>, <checkbox>, <colordropdown>, <combobox>, <description>, <grid>, <groupbox>, <label>, <listbox>, <morph>, <picturebox>, <radio>, <radiogroup>, <script>, <separator>, <slider>, <spacer>, <spinner>, <tabbox>, <tablecontrol>, <textbox>, <treecontrol>, <unitdimensionbox>
The <groupbox> element has the following attributes:
• align = start | center | end
Default is start. Specifies how space not used by the children is laid out. start places space below children. center evenly distributes space above and below children. end places space above children.
• 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.
• childrensize = vary | equalwidth | equalheight | equal
Specifies whether the children of this control will have the same height and width as each other. Default is vary. If vary, the height and width of the children will not be restricted. If equalwidth, the width of the children will be the same as that of the widest child. If equalheight, the height of the children will be the same as that of the tallest child. If equal, the width of the children will be the same as that of the widest child and the height of the children will be the same as that of the tallest child..
• clip = true | false
Default is false. If true, controls that do not fit within the groupbox control are truncated. If false, the controls are not truncated.
The value of clip is ignored if scroll is set to none.
• disabled = true | false
Default is false. If true, the control ignores all user interface events directed toward the control.
• 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.
• 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.
• label = CDATA
Specifies the text that appears in the border.
• orient = vertical | horizontal
Default is horizontal. Specifies the layout for the container children.
• pack = start | center | end | spread | stretch
Default is spread. Specifies how space not used by the children is laid out. start places space after children. center evenly distributes space before and after children. end places space before children. spread evenly distributes space before, between, and after children. stretch evenly distributes space between children, with no space before or after children.
• 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 resizes if necessary depending on size changes in its children.
• scroll = none | both | vertical | horizontal
Default is none. Specifies which, if any, scroll bars are displayed in the control. none specifies that no scroll bars are displayed. vertical specifies that only a vertical scroll bar is displayed. horizontal specifies that only a horizontal scroll bar is displayed. both specifies that vertical and horizontal scroll bars are displayed.
• 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.