<treecontrol> Element
The <treecontrol> element creates an outline list of items (defined by <treenode> elements). The element can have the following child elements:
<script>, <treenode>
The <treecontrol> 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.
• branchimage = IDREF
Specifies by reference a graphical image to be displayed for a branch in the tree. The value of branchimage matches the value of the image element id attribute specifying the desired graphic file.
• 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.
• extraimage = IDREF
Specifies by reference a second graphical image to be displayed for a branch or leaf in the tree. The value of extraimage matches the value of the image element id attribute specifying the desired graphic file.
• 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.
• haslines = true | false
Default is true. If true, dotted lines will be displayed among tree nodes to indicate the hierarchy of tree nodes.
• 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.
• leafimage = IDREF
Specifies by reference the graphical image to be displayed for a leaf in the tree. The value of leafimage matches the value of the image element id attribute specifying the desired graphic file. If not specified, the default MFC image is displayed.
• openbranchimage = IDREF
Specifies by reference the graphical image to be displayed for an open branch in the tree. The value of openbranchimage matches the value of the image element id attribute specifying the desired graphic file. If not specified, the default MFC image is displayed.
• 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.
• selectedimage = IDREF
Specifies by reference the graphical image to be displayed for a selected item in the tree. The value of selectedimage matches the value of the image element id attribute specifying the desired graphic file. If not specified, the default MFC image is displayed.
• seltype = single | multiple
Default is single. If single, only one only one tree node can be selected at a time. If multiple, more than one tree node can be selected at one time.
• statustext = CDATA
Specifies the text to display in status windows.
• type = normal | checkboxes | radiobuttons
Default is normal. If checkboxes, a check box will be displayed with each node. If radiobuttons, a radio button control will be displayed with each node. If normal, only the node will be 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.