Specifies how the image is laid out within the cell.
Usage
Set_Property(OLECtrlEntID, "OLE.CellImageLayout[field; record]", OptionValue)
Values
OptionValue can be set to one of the following valid options:
| Value | Abbr. | Description |
|---|---|---|
| Clip | C | Draws the image according to the CellAlignment property and clips the image within the cell |
| Stretch | S | Draws the image stretched/shrunken to fit the cell |
| Thumbnail | TH | Draws the image to fit within the cell while preserving aspect ratio |
| Tile | T | Draws the image repeatedly at its original size filling up the cell's area |
Default: Clip
Indices
| Index | Description |
|---|---|
| field | Index to an existing field |
| record | Index to an existing record |
Remarks
The CellImageLayout property allows you to specify how the image is laid out within the cell. By default, all images are positioned according to the 3rd field of the CellAlignment property and clipped within the cell. However, you may set this to any of the other above mentioned layouts for more effects. (New layouts will be added over time).
Clip
This layout is the default layout. Essentially, it draws the image in it's original size next to or behind the cell's text, which is determined by the CellAlignment property. The image is clipped so that it doesn't appear anywhere outside the cell.
Stretch
This layout simply stretches or shrinks the image to fill the cell's entire background. Thus, the CellAlignment setting is ignored. Note that the image's aspect ration is not preserved. This is a useful setting if you want to customize a cell's background. Text will always appear in front of the image.
Example
// Stretch the image to fit the cell for all cells in column 1 Set_Property(@Window:".OLE_EDITTABLE", "OLE.CellImageLayout[1; All]", "S")
