A row is a dcl container with horizontal orientation: it places all
its child tiles besides each other, from left to right.
Note: if a vertical alignment of a row and sibling child tiles with
a uniform space distribution is desired, it is required to enable
the fixed_height
attribute for the row tile. Otherwise, the row occupies more space.
Also, the row and its siblings should be placed into a column
container, rather than directly inside the dialog.
related attributes
These attributes are predefined for cluster tiles only:
These attribute will set the default
value of the alignment, fixed_height or fixed_width attribute of
the children of this cluster. The possible values are the same as
for the respective attributes. If the respective attribute is also
specified in a child of this container, the value specified in the
child definition will be used. Mind that this attribute is not
applied recursively: the default alignment value is only applied to
the immediate children, not to the grand children.
boxed
This attribute controls the appearance
of a surrounding line or box. A row with a non-empty label
attribute will also appear with a surrounding line, interrupted by
the displayed label at the top-left of the row. A predefined
clusters containing boxed in its name has the attribute boxed with
value true.
These attributes are predefined for every tile and consequently
for a row as well:
key
value
The attribute "value" makes sense for
a row only if it contains radio_button tiles. The value of a row is
the key of the currently selected radio_button it contains. If the
row does not contain any radio_button, an empty string will
returned.
tooltip
label
A row with a non-empty label attribute
appear with a surrounding line, interrupted by the displayed label
at the top-left of the row. If the label attribute of a row tile is
not empty, the attribute boxed will be overruled.
A row can send a callback only if it contains one or more
radio_buttons. On selection of a contained radio_button, a row will
send a callback with reason CBR_SELECT. See action_tile for more on
callbacks.