Customizer's Guide > Working with XUI (XML-based User Interface) Dialog Boxes > XUI Element Reference > <tablecontrol> Element
  
<tablecontrol> Element
The tablecontrol element creates a multi-column list with column headers. The element can have the following child elements:
<header>, <row>, <script>
The tablecontrol 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.
columns = CDATA
Specifies the number of columns.
contextmenu = CDATA
The id or name of a shortcut (context) menu for this control. 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.
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.
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.
gridlines = true | false
Default is false. If true, the table will have visible grid lines. If false, no gird lines will be displayed.
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.
nosortheader = true | false
Default is false. If true, clicking on the column heading will not resort the column contents.
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 allows horizontal and vertical resizing.
showimages = true | false
Default is false. If true, images are displayed to the left of each row with an image defined.
sortedcolumn = CDATA
Number specifying the column to use when sorting rows. Setting sortedcolumn to 0 sorts on the first column. Setting sortedcolumn to 1 sorts on the second column, and so on. Setting sortedcolumn to -1 disables column sorting.
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 = single | multiple | cell
Default is single. If single, only one row can be selected in the table at one time. If multiple, more than one row can be selected in the table. If cell, clicking in the table selects a single cell and sets the cell element's selected attribute to true.
value = CDATA
Specifies the text in the first column of the selected row.
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.