split
Creates a split screen with exactly two components. The split is either horizontal (with a left component and a right component, separated by a vertical split bar) or vertical (with a top component and a bottom component separated by a horizontal split bar). If only one component is defined under the split tag, the split is removed and the single component is returned.
Note: It is an error to put more than 2 component tags under a split tag.
Syntax
<split container attributes>
<component child component attributes> </component>
<component child component attributes> </component>
</split>
Container Attributes
In addition to General Attributes, the following attributes may be specified to the <split> tag:
Attribute |
Values |
Restrictions |
Description |
orientation |
horizontal
|
|
The first component will be on the left and the second component will be on the right. |
vertical |
The first component will be on the top and the second component will be on the bottom. |
Default values shown in bold.
Child Component Attributes
In addition to General Attributes, the following attributes may be specified to child components:
Attribute |
Values |
Restrictions |
Description |
weight |
Double value between +0.0 and 1.0 |
|
Specifies how much of the screen should be devoted to each side of the split. If the weight is defined for both components, the split is determined by weight / total weight. |
minw |
Positive integer |
|
The minimum width of the component in pixels. This is considered a hint and may or may not be honored by DashBoard. |
minh |
Positive integer |
|
The minimum height of the component in pixels. This is considered a hint and may or may not be honored by DashBoard. |
maxw |
Positive integer |
|
The maximum width of the component in pixels. This is considered a hint and may or may not be honored by DashBoard. |
maxh |
Positive integer |
|
The maximum height of the component in pixels. This is considered a hint and may or may not be honored by DashBoard. |
Example
The following example creates a split container with a horizontal split:
· Left side contains an abs container with 4 buttons placed in a 2x2 grid.
· Right side contains an abs container with 4 buttons placed in a 2x2 grid.
<split height="150" width="300" orientation="horizontal">
<abs weight="0.5" height="100" width="100">
<button left="5" top="5" width="25" height="25" name="1"/>
<button left="30" top="5" width="25" height="25" name="2"/>
<button left="5" top="30" width="25" height="25" name="3"/>
<button left="30" top="30" width="25" height="25" name="4"/>
</abs>
<abs weight="0.5" height="100" width="100">
<button left="5" top="5" width="25" height="25" name="5"/>
<button left="30" top="5" width="25" height="25" name="6"/>
<button left="5" top="30" width="25" height="25" name="7"/>
<button left="30" top="30" width="25" height="25" name="8"/>
</abs>
</split>