PicturePosition Property

Applies To

CheckBox control, CommandButton control, Label control, OptionButton control, ToggleButton control.

Description

Specifies the location of the picture relative to its caption.

Syntax

object.PicturePosition [= fmPicturePosition]

The PicturePosition property syntax has these parts:

Part

Description

object

Required. A valid object.

fmPicturePosition

Optional. How the picture aligns with its container.


Settings

The settings for fmPicturePosition are:

Constant

Value

Description

fmPicturePositionLeftTop

0

The picture appears to the left of the caption. The caption is aligned with the top of the picture.

fmPicturePositionLeftCenter

1

The picture appears to the left of the caption. The caption is centered relative to the picture.

fmPicturePositionLeftBottom

2

The picture appears to the left of the caption. The caption is aligned with the bottom of the picture.

fmPicturePositionRightTop

3

The picture appears to the right of the caption. The caption is aligned with the top of the picture.

fmPicturePositionRightCenter

4

The picture appears to the right of the caption. The caption is centered relative to the picture.

fmPicturePositionRightBottom

5

The picture appears to the right of the caption. The caption is aligned with the bottom of the picture.

fmPicturePositionAboveLeft

6

The picture appears above the caption. The caption is aligned with the left edge of the picture.

fmPicturePositionAboveCenter

7

The picture appears above the caption. The caption is centered below the picture (default).

fmPicturePositionAboveRight

8

The picture appears above the caption. The caption is aligned with the right edge of the picture.

fmPicturePositionBelowLeft

9

The picture appears below the caption. The caption is aligned with the left edge of the picture.

fmPicturePositionBelowCenter

10

The picture appears below the caption. The caption is centered above the picture.

fmPicturePositionBelowRight

11

The picture appears below the caption. The caption is aligned with the right edge of the picture.

fmPicturePositionCenter

12

The picture appears in the center of the control. The caption is centered horizontally and vertically on top of the picture.


Remarks

The picture and the caption, as a unit, are centered on the control. If no caption exists, the picture's location is relative to the center of the control.

This property is ignored if the Picture property does not specify a picture.

See Also

Picture property, PictureAlignment property, PictureSizeMode property, PictureTiling property.

Example

See the Picture property example.