Customizer's Guide > Working with XUI (XML-based User Interface) Dialog Boxes > XUI Element Reference > <colordropdown> Element
  
<colordropdown> Element
The <colordropdown> element displays a color selection control from which the user picks a color. value is set to the value of the selected color.
The <colordropdown> element can have the following child element:
<script>
The <colordropdown> 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.
command = CDATA
Specifies the Arbortext ACL command to execute. (Colordropdown toolbar buttons 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.
palette = foreground | background
Default is foreground. If foreground, the foreground color palette is displayed. If background, the background color palette 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 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.
value = CDATA
Specifies the selected color. Values are 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.
valuetype = name | spec
Default is name. If set to a value of name, when a color is selected in the color dropdown control and a standard HTML color name exists for the color, the value attribute of the <colordropdown> element is set to the name of the color. When no HTML color name exists for the selected color, the value attribute of the <colordropdown> element is set to the hexidecimal color code specifying the red, green, and blue intensity values defining the color.
If valuetype is set to a value of spec, the value attribute of the <colordropdown> element will is always set to the hexidecimal color code defining the color selected in the color dropdown control.
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.