PictureAlignment Property

PictureAlignment Property

See Also                  Applies To        

Specifies the location of a background picture.

Syntax

object.PictureAlignment [=PictureAlignment]

The PictureAlignment property syntax has these parts:

Part Description
object Required. A valid object.
PictureAlignment Optional. The position where the picture aligns with the control.

Settings

The settings for PictureAlignment are:

Value Description
0 The top left corner.
1 The top right corner.
2 The center.
3 The bottom left corner.
4 The bottom right corner.

Remarks

The PictureAlignment property identifies which corner of the picture is the same as the corresponding corner of the control or container where the picture is used.

For example, setting PictureAlignment to 0 means that the top left corner of the picture coincides with the top left corner of the control or container. Setting PictureAlignment to 2 positions the picture in the middle, relative to the height as well as the width of the control or container.

If you tile an image on a control or container, the setting of PictureAlignment affects the tiling pattern. For example, if PictureAlignment is set to 0, the first copy of the image is laid in the upper left corner of the control or container and additional copies are tiled from left to right across each row. If PictureAlignment is 2, the first copy of the image is laid at the center of the control or container, additional copies are laid to the left and right to complete the row, and additional rows are added to fill the control or container.

Note Setting the PictureSizeMode property to 2 overrides PictureAlignment. When PictureSizeMode is set to 2, the picture fills the entire control or container.