Customizer's Guide > Working with XUI (XML-based User Interface) Dialog Boxes > XUI Element Reference > <window> Element
  
<window> Element
The <window> element is the top level element of a XUI dynamic dialog box. It represents the window frame.
The element can have the following child elements:
<activex>, <box>, <button>, <checkbox>, <colordropdown>, <combobox>, <description>, <grid>, <groupbox>, <imagegroup>, <label>, <listbox>, <menubar>, <morph>, <picturebox>, <radio>, <radiogroup>, <script>, <separator>, <slider>, <spacer>, <spinner>, <tabbox>, <tablecontrol>, <textbox>, <toolbargroup>, <treecontrol>, <unitdimensionbox>
The <window> 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 window background. Values can be the standard HTML named colors, the Arbortext colors gray1, gray2, gray3, gray4, gray5, or transparent. 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.
A value of transparent specifies that embedded dialog boxes are to have no background 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..
dock = none | bottom | left | right | top
Specifies the docking state of the dockable dialog box. The default value of dock is none. The value of dock must be one of the locations specified by enabledocking. Otherwise, dock will be ignored.
The modal attribute in the <window> element takes precedence over the enabledocking attribute. If modal has a value of true, the XUI file will be displayed as a standard modal dialog box regardless of the value of enabledocking.
enabledocking = none | any | bottom | left | right | top | topbottom | topleft | topright | bottomleft | bottomright | leftright | topbottomleft | topbottomright | topleftright | bottomleftright
Specifies the edges of the edit window the dialog box can dock to. The default value of enabledocking is none. If enabledocking is none, the XUI file will be displayed as a non-dockable (standard) dialog box.
focus = IDREF
Specifies by ID the element currently with focus.
foregroundcolor = CDATA
Specifies the color to use in drawing the window 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.
helpfile = CDATA
Specifies the path and file name of the Microsoft WinHelp or Microsoft HTML Help file containing help for this dialog box.
id = ID
Identifies the control.
margin = CDATA
Default is 12. Specifies the margin around the content of the dialog box in pixels.
For example, if the value of margin is 6, each of the left, right, top, and bottom margins of the dialog box will be 6 pixels. If the value is 0, the dialog box will have no margins. If margin is not specified each margin will be 12 pixels.
modal = true | false
Default is false. If true, the dialog box must be acknowledged before other windows can be accessed.
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.
status = IDREF
Specifies the id of the control displaying the statustext value of the control with focus.
title = CDATA
The text displayed in the frame title bar.
width = CDATA
Number specifying the width in pixels to allocate for this control.
windowname = NMTOKEN
Text to identify the window.
withdraw = true | false
Default is false. If true, the control (and any children) is ignored and not displayed.
xmlns:ev = CDATA
Specifies the XML events namespace URL.