Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server (Not)   Client   Old   Guides   Examples
New in version: 6.2   6.3   6.4   6.5   7.0   7.1   7.2   7.3   7.4   7.5    Statistic  

DynaPDF.Table.SetCellImage

Inserts an image horizontally and vertically aligned as specified.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
DynaPDF 3.5 Yes Yes Yes Yes Yes

MBS( "DynaPDF.Table.SetCellImage"; Table; Row; Col; ForeGround; HAlign; VAlign; Width; Height; ImagePath { ; Index } )

Parameters

Parameter Description Example value
Table The identifier for the table. $Table
Row The row number. Range from 0 to DynaPDF.Table.GetNumRows-1. Pass -1 for all rows. 0
Col The column number. Range from 0 to DynaPDF.Table.GetNumCols-1. Pass -1 for all columns. 0
ForeGround If 1, the cell will be expanded if necessary. 1
HAlign The horizontal alignment. Can be left, center or right. "center"
VAlign The vertical alignment. Can be bottom, center or top. "center"
Width The image width. Must be greater or equal zero. 50
Height The image height. Must be greater or equal zero. 50
ImagePath The native path to the image file. $Path
Index Optional
The index of the image in the file.
1

Result

Returns OK or error.

Description

Inserts an image horizontally and vertically aligned as specified.
The image will be loaded when the table is drawn. Therefore, please use an absolute path.
If the image is inserted as a background object, then it will be clipped if it does not fit into the cell boundary. A cell can contain a background and a foreground object.
An image can also be added to the table as background object.
Foreground objects have a strong width and height. That means the cell will be expanded if necessary.
Image formats which support no transparency are inserted opaque. Transparent GIF images are inserted transparent and alpha channels in images will be considered. Images should normally be inserted in the native image color space. To achieve this, set the flag UseImageCS with DynaPDF.Table.SetFlags.
Images can be scaled into the cell as follows:
The parameters Width and Height are not exchanged if the cell uses a landscape orientation.

This function needs a native path. Please use Path.FileMakerPathToNativePath function in order to convert a FileMaker style path to a native path.

Examples

Add row and insert picture:

Set Variable [$subrow; Value:MBS("DynaPDF.Table.AddRow"; $subtable)]
Set Variable [$r; Value:MBS("DynaPDF.Table.SetCellImageEx"; $subtable; $subrow; 0; 1; "left"; "top"; 200; 0; Images::Image)]

See also


DynaPDF.Table.SetBoxProperty   -   DynaPDF.Table.SetCellImageEx

Feedback: Report problem or ask question.




Links
MBS FileMaker tutorial videos