DynaPDF Manual - Page 102

Previous Page 101   Index   Next Page 103

Table Functions
Page 102 of 839
GetFlags
float tblGetFlags(
const ITBL* Table, // Table pointer
SI32 Row,
// Row index or -1
SI32 Col)
// Column index or -1
The function returns the current flags of the table, row, column, or cell:
Row
Col
Applies to
-1
-1
Table
-1
>= 0
Column
>= 0
-1
Row
>= 0
>= 0
Cell
Return values:
If the function succeeds the return value is greater or equal zero. If the function fails, the return value
is a negative error code.
GetNextHeight
Syntax:
float tblGetNextHeight(
const ITBL* Table, // Table pointer
float MaxHeight,
// Maximum height or zero to avoid page breaks
SI32* NextRow)
// Can be set to NULL if not needed
The function calculates the height of the table. If the parameter MaxHeight is zero, then the full height
will be returned. If MaxHeight is greater zero, then the height of the table is calculated that fits into
the output height. This is the same height that DrawTable() would produce when drawing the table
with the same parameters. This function can be useful if the height of the table must be known
before it can be drawn. The function caches the result so that multiple calls with a different max
height can be computed fast as possible.
The function must be called within an open page.
Return values:
If the function succeeds the return value is the table height if drawn with the same parameters. If the
function fails the return value is -1.
 

Previous topic: DrawTable, GetFirstRow

Next topic: GetNextRow, GetNumCols, GetNumRows, GetPDFInstance, GetTableHeight