Type: Integer
Availability: Read or write at any time for pictures, read or write at run time only for tables
The stretch property determines how a picture stretches to fit the size of a Picture control. The stretch property settings for a Picture control are listed in the following table.
| Picture Class Constant | Value | Description |
|---|---|---|
| Stretch_None | 0 | The picture box size does not change to fit the picture size. If the picture is too large, the image is clipped. |
| Stretch_ToControl | 1 | The picture is resized to fit the control size. This may cause distortion of the image. |
| Stretch_ControlTo | 2 | The control stretches to fit the picture size. If the picture is large, the control may be enlarged so that it overlaps other controls or no longer fits on the form. |
| Stretch_Proportional | 3 | The control is sized proportionally to the picture. The picture is then stretched to fit the control. This means that the picture is always drawn in isotropic proportions to its original size. When the control size is determined, the width or the height decreases (not increases) to keep the same proportional view of the picture. |
| Stretch_Pic_Proportional | 4 | The picture is sized proportionally to fit the control. The picture is centered horizontally or vertically if the resized picture does not fill the control height or width. |
| Stretch_CenterPicture | 5 | The picture is centered on the control. |
If the value of the stretch property for a Picture control is non-zero, resizing the control also resizes the picture it contains. In addition, animated .gif picture files are not drawn stretched. The stretch property is used to resize the control to the GIF image if required, but the animation is always drawn at its normal size.
For an image containing transparency to display correctly in a Picture control or a JadeMask control as part of a Web-enabled application:
Set the stretch property of the control to Stretch_ToControl (1)
Do not use the drawing methods of the Window class (for example, the drawLine method) on the control
In the case of a JadeMask control, do not set the caption property
For a Table control, the stretch property determines whether:
Pictures placed in the cells of the table are drawn to fit the cell (after the text is displayed).
Pictures are drawn to their actual size.
A picture or text in a cell gets preference when there is insufficient space to fully display both the picture and the text.
The settings of the stretch property for a Table control are listed in the following table.
| Table Class Control | Value | Description |
|---|---|---|
| Stretch_None | 0 | All pictures displayed in cells in the table are drawn at actual size. If the picture is too large to fit the available space in the cell, the picture is truncated on the right or the bottom. If there is insufficient room for the picture and the text within a cell, the picture is truncated. |
| Stretch_Cell (the default value) | 1 | All pictures are stretched proportional to the size of each cell less the size of the text. |
| Stretch_None_Picture_First | 2 | No cell picture is stretched. If there is insufficient room for the picture and the text within a cell, the text is truncated. |
| Stretch_Cell_Picture_First | 3 | All pictures are stretched proportional to the size of the cell but no bigger than the actual picture image. The text is then displayed in any remaining space in the cell and may be truncated. |
The stretch property of the Table control applies globally to all cells on all sheets of the table.
The code fragment in the following example shows the use of the stretch property.
table1.stretch := comboStretch.listIndex - 1;