| C1Elastic Reference > C1Elastic Properties > PicturePos Property (C1Elastic) |
Returns or sets the position of the picture in the control.
[form!]C1Elastic.PicturePos[ = PicturePosSettings ]
All pictures are drawn within the Elastic's borders, determined by the BorderWidth property.
The settings for the PicturePos property are described below:
|
Constant |
Value |
Description |
|
ppLeftTop |
0 |
Align picture to left top corner of the control's client area. |
|
ppLeftCenter |
1 |
Align picture to left and to the center of the control's client area. |
|
ppLeftBottom |
2 |
Align picture to left bottom corner of the control's client area. |
|
ppCenterTop |
3 |
Align picture to center and to the top of the control's client area. |
|
ppCenterCenter |
4 |
Align picture to center of the control's client area. |
|
ppCenterBottom |
5 |
Align picture to center and to the bottom of the control's client area. |
|
ppRightTop |
6 |
Align picture to right top corner of the control's client area. |
|
ppRightCenter |
7 |
Align picture to right and to the center of the control's client area. |
|
ppRightBottom |
8 |
Align picture to right bottom corner of the control's client area. |
|
ppStretch |
9 |
Stretch the picture so it fills the control's client area. |
|
ppTile |
10 |
Copy the picture, in its original size, until it fills the control's client area. |
|
ppZoom |
11 |
Stretch the picture so it fills the control's client area, while keeping its original aspect ratio. |
When using the Elastic as a progress indicator, you can flood the control by stretching or tiling the Picture over the flooded area. To do that, set the FloodStyle property to 2 - fsPicture and set the PicturePos property to 9 - ppStretch or 10 - ppTile.
Setting 11 - ppZoom is often the best choice for displaying pictures of unknown dimensions -- possibly selected by the user at run time. This setting will result in the best match between control and picture size, while at the same time avoiding distortions (the picture will be stretched evenly in the horizontal and vertical directions).
PicturePosSettings (Enumeration)