DynaPDF Manual - Page 107

Previous Page 106   Index   Next Page 108

Table Functions
Page 107 of 839
Width > 0 and Height = 0 or Width = 0 and Height > 0 -> The image is scaled to the given width
or height. The aspect ratio will be preserved. If the flag tfScaleToRect is set, the image is
scaled so that both sides fit into the given width or height and into cell width or height
depending on which side is missing. If the parameter Height and the row height are zero then
the flag tfScaleToRect has no effect.
Width > 0 and Height > 0 -> The image is scaled to the given width and height. The aspect ratio
is not preserved. If the flag tfScaleToRect is set, the image is scaled so that both sides fit into
the given width and height and the aspect ratio is preserved.
The parameters Width and Height are not exchanged if the cell uses a landscape orientation.
Remarks:
The function is available in an Ansi and Unicode compatible variant. Unicode paths are converted to
UTF-8 on non-Windows operating systems. Ansi strings are interpreted as UTF-8 if the flag
gfAnsiStringIsUTF8 is set the in the associated PDF instance. See SetGStateFlags() for further
information.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
SetCellImageEx
Syntax:
LBOOL tblSetCellImageEx(
const ITBL* Table,
// Table pointer
SI32 Row,
// Row index or -1
SI32 Col,
// Column index or -1
LBOOL ForeGround,
// If true, the cell will be expanded if necessary
TCellAlign HAlign,
// Horizontal alignment
TCellAlign VAlign,
// Vertical alignment
float Width,
// Must be greater or equal zero
float Height,
// Must be greater or equal zero
const void* Buffer, // Image buffer
UI32 BufSize,
// Buffer size
UI32 Index)
// Image index (TIFF images only)
The function inserts an image in the same way as SetCellImage() but accepts a file buffer instead of a
file path. See SetCellImage() for further information. The function creates a copy of the image buffer.
Return values:
If the function succeeds the return value is 1. If the function fails the return value is 0.
 

Previous topic: SetCellImage

Next topic: SetCellOrientation, SetCellTable