2.367 .tilestyle

For grouping objects, the attribute .tilestyle controls the layout of the background image.

This attribute defines the position of the picture (.picture) inside the image object. In case there is no picture, this is handled like there was a picture whose width and height are 0.

  • Data type

    enum

  • Access

    get, set

  • changed event

    yes

Grouping Objects

Value range

tilestyle_tiled

The background image is repeated horizontally and vertically until the background is covered entirely.

tilestyle_centered (not on Motif)

The background image is drawn in the center. If a virtual size is set, this will be used to calculate the position.

tilestyle_stretched (not on Motif)

The background image is resized to cover the entire plain. If a virtual size is set, the image will cover the complete virtual plain.

tilestyle_parent_tile

The setting of the parent object is taken on. The object appears to be transparent. This value is not applicable for statusbar, toolbar and window.

Remark

To avoid positioning according to virtual sizes with tilestyle_centered and filling the whole virtual plain with tilestyle_stretched, tilestyle_parent_tile can be used and the background image can be set on the parent object (possibly inserting a groupbox as an intermediate parent.

image

Value range

tilestyle_icon

The picture is placed above the text with a distance defined by the attribute .spacing. The picture is centered horizontally; the text is positioned horizontally inside the image object according to the .alignment attribute (default: centered). Vertically picture and text are treated as a unit which gets placed in the middle. If the picture is scalable, the text is positioned at the bottom of the image and the picture covers the remaining space.

tilestyle_left

The picture is placed on the left edge of the image object. The display area for the text starts to the right of the picture, with a distance defined by the attribute .spacing, and extends to the right edge of the image. The text is positioned horizontally inside its display area according to the .alignment attribute. Both picture and text are vertically centered. If the picture is scalable, the text is placed on the right edge of the image, regardless of the .alignment attribute. The picture then covers the remaining space.

tilestyle_right

The picture is placed on the right edge of the image object. The display area for the text starts to the left of the picture, with a distance defined by the attribute .spacing, and extends to the left edge of the image. The text is positioned horizontally inside its display area according to the .alignment attribute. Both picture and text are vertically centered. If the picture is scalable, the text is placed on the left edge of the image, regardless of the .alignment attribute. The picture then covers the remaining space.

tilestyle_top

The picture is placed on the top edge of the image object. The text is displayed below the picture with a distance defined by the attribute .spacing. The picture is centered horizontally; the text is positioned horizontally inside the image object according to the .alignment attribute. If the picture is scalable, the text is positioned at the bottom of the image and the picture covers the remaining space.

tilestyle_bottom

The picture is placed on the bottom edge of the image object. The text is displayed above the picture with a distance defined by the attribute .spacing. The picture is centered horizontally; the text is positioned horizontally inside the image object according to the .alignment attribute. If the picture is scalable, the text is positioned at the top of the image and the picture covers the remaining space.

tilestyle_background

The picture is displayed as background. The text is shown in front of the picture. The picture is centered horizontally; the text is positioned horizontally inside the image object according to the .alignment attribute. Both picture and text are vertically centered. If the picture is scalable, it covers the complete space provided by the image object.

See also

Attributes .alignment, .spacing