property

A property for the picture background.
Properties and their settings are listed in the table that follows.
Picture properties are used only when the datawindow.brushmode value
is 6. These properties are not available for RichText, Graph, or
OLE DataWindow objects.

value

The value to be assigned to the property.
For picture properties, value can
be a quoted DataWindow expression.

Clip.Bottom

An integer specifying the percentage
to clip from the bottom edge of the background picture.

Painter: Background tab, Picture group.

Clip.Left

An integer specifying the percentage
to clip from the left edge of the background picture.

Painter: Background tab, Picture group.

Clip.Right

An integer specifying the percentage
to clip from the right edge of the background picture.

Painter: Background tab, Picture group.

Clip.Top

An integer specifying the percentage
to clip from the top edge of the background picture.

Painter: Background tab, Picture group.

File

Painter: Background tab, Picture group.

A string indicating the pathname for the picture file to be
used for the DataWindow background. Supported formats are BMP, GIF,
JPEG, RLE, WMF, and PNG.

Mode

An integer indicating the orientation
and size of the background picture, and whether it is tiled. Tiling
also depends on the Scale.X and Scale.Y values.

Values are:

• 0 – Original
  Size

• 1 – Fit to Width

  2 – Fit to Height

  3 – Preserve Aspect Ratio/Max to Rect

  4 – Stretch to Fit

  5 – Tile

• 6 – Flip X

• 7 – Flip Y

• 8 – Flip XY

Painter: Background tab, Picture group.

Scale.X

An integer from 0 to 100 that indicates
the horizontal size of the bitmap in relation to the horizontal
size of the DataWindow object. If you set the Scale.X and Scale.Y properties
to 100, the background picture will cover the entire DataWindow
object. This property is used only when picture.tilemode is set
to 5, 6, 7, or 8.

Painter: Background tab, Picture group.

Scale.Y

An integer from 0 to 100 that indicates
the vertical size of the bitmap in relation to the vertical size
of the DataWindow object. If you set the Scale.X and Scale.Y properties
to 100, the background picture will cover the entire DataWindow
object. This property is used only when picture.tilemode is set
to 5, 6, 7, or 8.

Painter: Background tab, Picture group.

Tranparency

An integer in the range 0 to 100, where
0 means that the background bitmap is opaque and 100 that it is
completely transparent.

Painter: Background tab, Picture group.

0 – Original Size

The image is centered and not tiled to
fit the DataWindow.

1 – Fit to Width

The image is stretched or compressed
(depending on the aspect ratio) until its width matches that of
the DataWindow control).

2 – Fit to Height

The image is stretch or compressed (depending
on the the aspect ratio) until its height matches that of the DataWindow
control.

3 – Preserve Aspect Ratio/Max
to Rect

The image is stretched or compressed
(without distortion) until its width or height matches that of the
DataWindow control without either of them exceeding the bounds of
the DataWindow control.

4 – Stretch to Fit

The image is stretched to fill the DataWindow
control, without preserving the aspect ratio.

5 – Tile

The image is tiled to fill the DataWindow.
The number of repetitions will be affected by the values of picture.scale.x, picture.scale.y,
and the picture.clip properties.

6 – Flip X

The image is used to fill the DataWindow
by tiling and then it is flipped horizontally as you move from one
tile to the next in a row. The number of repetitions will be affected
by the values of picture.scale.x, picture.scale.y, and the picture.clip
properties.

7 – Flip Y

The image is used to fill the DataWindow
by tiling and then it is flipped vertically as you move from one
tile to the next in a column. The number of repetitions will be affected
by the values of picture.scale.x, picture.scale.y, and the picture.clip
properties.

8 – Flip XY

The image is used to fill the DataWindow
by tiling and then it is flipped horizontally as you move along
the rows and vertically as you move along the columns. The number of
repetitions will be affected by the values of picture.scale.x, picture.scale.y,
and the picture.clip properties.