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>