« Back to index

Layout

Table of Contents:

• HorizontalArrangement
• HorizontalScrollArrangement
• TableArrangement
• VerticalArrangement
• VerticalScrollArrangement

HorizontalArrangement

Use a horizontal arrangement component to display a group of components laid out from left to right.

This component is a formatting element in which you place components that should be displayed from left to right. If you want to have components displayed one over another, use VerticalArrangement instead.

In a HorizontalArrangement, components are arranged along the horizontal axis, vertically center-aligned.

If a HorizontalArrangement’s Height property is set to Automatic, the actual height of the arrangement is determined by the tallest component in the arrangement whose Height property is not set to Fill Parent. If a HorizontalArrangment’s Height property is set to Automatic and it contains only components whose Height properties are set to Fill Parent, the actual height of the arrangement is calculated using the automatic heights of the components. If a HorizontalArrangement’s Height property is set to Automatic and it is empty, the Height will be 100.

If a HorizontalArrangement’s Width property is set to Automatic, the actual width of the arrangement is determined by the sum of the widths of the components. If a HorizontalArrangement’s Width property is set to Automatic, any components whose Width properties are set to Fill Parent will behave as if they were set to Automatic.

If a HorizontalArrangement’s Width properties are set to Fill Parent will equally take up the width not occupied by other components.

Properties

AlignHorizontal

A number that encodes how contents of the HorizontalArrangement are aligned horizontally. The choices are: 1 = left aligned, 2 = right aligned, 3 = horizontally centered. Alignment has no effect if the HorizontalArrangement’s Width is Automatic.

AlignVertical

A number that encodes how the contents of the HorizontalArrangement are aligned vertically. The choices are: 1 = aligned at the top, 2 = vertically centered, 3 = aligned at the bottom. Alignment has no effect if the HorizontalArrangement’s Height is Automatic.

BackgroundColor

Specifies the background color of the HorizontalArrangement as an alpha-red-green-blue integer. If an Image has been set, the color change will not be visible until the Image is removed.

Height

Specifies the HorizontalArrangement’s vertical height, measured in pixels.

HeightPercent

Specifies the HorizontalArrangement’s vertical height as a percentage of the Screen’s Height.

Image

Specifies the path of the background image of the HorizontalArrangement.

Visible

Specifies whether the HorizontalArrangement should be visible on the screen. Value is true if the HorizontalArrangement is showing and false if hidden.

Width

Specifies the horizontal width of the HorizontalArrangement, measured in pixels.

WidthPercent

Specifies the horizontal width of the HorizontalArrangement as a percentage of the Screen’s Width.

Events

None

Methods

None

HorizontalScrollArrangement

A formatting element in which to place components that should be displayed from left to right. If you wish to have components displayed one over another, use VerticalScrollArrangement instead.

This version is scrollable.

Properties

AlignHorizontal

A number that encodes how contents of the HorizontalScrollArrangement are aligned horizontally. The choices are: 1 = left aligned, 2 = right aligned, 3 = horizontally centered. Alignment has no effect if the HorizontalScrollArrangement’s Width is Automatic.

AlignVertical

A number that encodes how the contents of the HorizontalScrollArrangement are aligned vertically. The choices are: 1 = aligned at the top, 2 = vertically centered, 3 = aligned at the bottom. Alignment has no effect if the HorizontalScrollArrangement’s Height is Automatic.

BackgroundColor

Specifies the background color of the HorizontalScrollArrangement as an alpha-red-green-blue integer. If an Image has been set, the color change will not be visible until the Image is removed.

Height

Specifies the HorizontalScrollArrangement’s vertical height, measured in pixels.

HeightPercent

Specifies the HorizontalScrollArrangement’s vertical height as a percentage of the Screen’s Height.

Image

Specifies the path of the background image of the HorizontalScrollArrangement.

Visible

Specifies whether the HorizontalScrollArrangement should be visible on the screen. Value is true if the HorizontalScrollArrangement is showing and false if hidden.

Width

Specifies the horizontal width of the HorizontalScrollArrangement, measured in pixels.

WidthPercent

Specifies the horizontal width of the HorizontalScrollArrangement as a percentage of the Screen’s Width.

Events

None

Methods

None

TableArrangement

Use a table arrangement component to display a group of components in a tabular fashion.

This component is a formatting element in which you place components that should be displayed in tabular form.

In a TableArrangement, components are arranged in a grid of rows and columns, with not more than one component visible in each cell. If multiple components occupy the same cell, only the last one will be visible.

Within each row, components are vertically center-aligned.

The width of a column is determined by the widest component in that column. When calculating column width, the automatic width is used for components whose Width property is set to Fill Parent. However, each component will always fill the full width of the column that it occupies.

The height of a row is determined by the tallest component in that row whose Height property is not set to Fill Parent. If a row contains only components whose Height properties are set to Fill Parent, the height of the row is calculated using the automatic heights of the components.

Properties

Columns

Determines the number of columns in the table.

Height

Specifies the TableArrangement’s vertical height, measured in pixels.

HeightPercent

Specifies the TableArrangement’s vertical height as a percentage of the Screen’s Height.

Rows

Determines the number of rows in the table.

Visible

Specifies whether the TableArrangement should be visible on the screen. Value is true if the TableArrangement is showing and false if hidden.

Width

Specifies the horizontal width of the TableArrangement, measured in pixels.

WidthPercent

Specifies the horizontal width of the TableArrangement as a percentage of the Screen’s Width.

Events

None

Methods

None

VerticalArrangement

Use a VerticalArrangement component to display a group of components laid out from top to bottom, left-aligned.

This component is a formatting element in which you place components that should be displayed one below another. The first child component is stored on top, the second beneath it, and so on. If you want to have components displayed next to one another, use HorizontalArrangement instead.

In a VerticalArrangement, components are arranged along the vertical axis, left-aligned.

If a VerticalArrangement’s Width property is set to Automatic, the actual width of the arrangement is determined by the widest component in the arrangement whose Width property is not set to Fill Parent. If a VerticalArrangement’s Width property is set to Automatic and it contains only components whose Width properties are set to Fill Parent, the actual width of the arrangement is calculated using the automatic widths of the components. If a VerticalArrangement’s Width property is set to Automatic and it is empty, the width will be 100.

If a VerticalArrangement’s Height property is set to Automatic, the actual height of the arrangement is determined by the sum of the heights of the components. If a VerticalArrangement’s Height property is set to Automatic, any components whose Height properties are set to Fill Parent will behave as if they were set to Automatic.

If a VerticalArrangement’s Height property is set to Fill Parent or specified in pixels, any components whose Height properties are set to Fill Parent will equally take up the height not occupied by other components.

Properties

AlignHorizontal

A number that encodes how contents of the VerticalArrangement are aligned horizontally. The choices are: 1 = left aligned, 2 = right aligned, 3 = horizontally centered. Alignment has no effect if the VerticalArrangement’s Width is Automatic.

AlignVertical

A number that encodes how the contents of the VerticalArrangement are aligned vertically. The choices are: 1 = aligned at the top, 2 = vertically centered, 3 = aligned at the bottom. Alignment has no effect if the VerticalArrangement’s Height is Automatic.

BackgroundColor

Specifies the background color of the VerticalArrangement as an alpha-red-green-blue integer. If an Image has been set, the color change will not be visible until the Image is removed.

Height

Specifies the VerticalArrangement’s vertical height, measured in pixels.

HeightPercent

Specifies the VerticalArrangement’s vertical height as a percentage of the Screen’s Height.

Image

Specifies the path of the background image of the VerticalArrangement.

Visible

Specifies whether the VerticalArrangement should be visible on the screen. Value is true if the VerticalArrangement is showing and false if hidden.

Width

Specifies the horizontal width of the VerticalArrangement, measured in pixels.

WidthPercent

Specifies the horizontal width of the VerticalArrangement as a percentage of the Screen’s Width.

Events

None

Methods

None

VerticalScrollArrangement

A formatting element in which to place components that should be displayed one below another. (The first child component is stored on top, the second beneath it, etc.) If you wish to have components displayed next to one another, use HorizontalScrollArrangement instead.

This version is scrollable.

Properties

AlignHorizontal

A number that encodes how contents of the VerticalScrollArrangement are aligned horizontally. The choices are: 1 = left aligned, 2 = right aligned, 3 = horizontally centered. Alignment has no effect if the VerticalScrollArrangement’s Width is Automatic.

AlignVertical

A number that encodes how the contents of the VerticalScrollArrangement are aligned vertically. The choices are: 1 = aligned at the top, 2 = vertically centered, 3 = aligned at the bottom. Alignment has no effect if the VerticalScrollArrangement’s Height is Automatic.

BackgroundColor

Specifies the background color of the VerticalScrollArrangement as an alpha-red-green-blue integer. If an Image has been set, the color change will not be visible until the Image is removed.

Height

Specifies the VerticalScrollArrangement’s vertical height, measured in pixels.

HeightPercent

Specifies the VerticalScrollArrangement’s vertical height as a percentage of the Screen’s Height.

Image

Specifies the path of the background image of the VerticalScrollArrangement.

Visible

Specifies whether the VerticalScrollArrangement should be visible on the screen. Value is true if the VerticalScrollArrangement is showing and false if hidden.

Width

Specifies the horizontal width of the VerticalScrollArrangement, measured in pixels.

WidthPercent

Specifies the horizontal width of the VerticalScrollArrangement as a percentage of the Screen’s Width.

Events

None

Methods

None