|
<< Click to display table of contents >> TRVBackgroundProperties |
The class defines the position, size, and repetition (tiling) of the background image.
Unit [VCL/FMX]: RVBack / fmxRVBack.
Syntax
TRVBackgroundProperties = class (TPersistent);
(introduced in version 24)
TObject
TPersistent
By default, a background image is not shown. Assign Visible = True to enable it.
The position and size of the background image are set separately for horizontal and vertical directions, but there are some dependencies. In particular, the values rvbszContain and rvbszCover are applied to HorizontalSizeKind and VerticalSizeKind simultaneously, while rvbszAuto sets one dimension proportionally to the other.
When the size/offset is specified as a percentage, it refers to the percentage of the whole background area, not of the background image itself.
When the image is repeated, the position properties refers to a single instance of the background image; the others are generated by repeating it.
However, the rvbrpSpace mode of HorizontalRepeat/VerticalRepeat is an exception: in this mode, the image is always repeated from one side to the other (with added spacing between images), and all positioning properties of the image are ignored.
Size properties:
▪HorizontalSizeKind and ImageWidth
▪VerticalSizeKind and _ImageHeight
Positioning properties:
▪HorizontalAlignment, HorizontalOffset and HorizontalOffsetKind
▪VerticalAlignment, VerticalOffset and VerticalOffsetKind
Other properties: