DynaPDF Manual - Page 108
Previous Page 107 Index Next Page 109
Table Functions
Page 108 of 839
SetCellOrientation
Syntax:
LBOOL tblSetCellOrientation(
const ITBL* Table, // Table pointer
SI32 Row,
// Row index or -1
SI32 Col,
// Column index or -1
SI32 Orientation)
// 0, 90 or a multiple of 90 degrees
The function sets the cell orientation. The cell orientation is inherited from the table, column, row,
and finally from the cell. The contents in a cell can be rotated in 90 degrees steps. Positive values
rotate the cell content counter clockwise and negative values clockwise.
The row height should be set to value greater zero if a cell uses a landscape orientation. This is
important if the height cannot be computed from the cell contents. This is the case if a cell contains
text and if the flag tfNoLineBreak was not set.
The orientation can be set to the table, rows, columns, and cells as follows:
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 1. If the function fails the return value is 0.
SetCellTable
Syntax:
LBOOL tblSetCellTable(
const ITBL* Table,
// Table pointer
UI32 Row,
// Row index
UI32 Col,
// Column index
TCellAlign HAlign,
// Horizontal alignment
TCellAlign VAlign,
// Vertical alignment
const ITBL* SubTable) // Pointer of the sub table
The function inserts a sub table into the specfied cell. A sub table is always a foreground object that
has a strong width and height. That means, if the cell is not large enough it will be expanded.
Note that the function creates no copy of the table. Do not delete the sub table when it is used by
another table. The C#, VB. Net, VB, and PHP interfaces make sure that a sub table cannot be deleted
before the tables which contain references of it will be deleted.
In programming languages which use reference counting like VB or PHP, it is important to delete
tables in the right order. Delete first the tables which contain references to sub tables. Finally, delete
the sub tables.
Previous topic: SetCellImageEx
Next topic: SetCellTemplate