backBrushStyle

Type: Integer

Default: 0

Availability: Read or write at any time

The backBrushStyle property of the Window class controls the way in which the Control class and Form class backBrush property images are displayed, as shown in the Form class load method in the following example.

load() updating;
begin
   self.backBrushStyle := Form.BackBrushStyle_Center;
end;

If the value of the backBrush property is null (""), the backBrushStyle property is ignored.

If the value of the backBrush property has an assigned image, the backBrushStyle property determines the display style, as indicated by the following Window class constant values.

Window Class Constant Integer Value The image is...
BackBrushStyle_Tile 0 Converted to a brush and the brush is tiled over the entire client area of the window.
BackBrushStyle_Stretch 1 Stretched to cover the entire client area.
BackBrushStyle_Center 2 Displayed at actual size in the center of the client area.
BackBrushStyle_StretchProport 3

Drawn in isotropic proportions to its original size to fit the client area of the window.

If the resized image is narrower than the client width, it is centered horizontally. If the resized image is narrower than the client height, it is centered vertically.