The
docTable type is used to define the advanced characteristics of a Table paragraph found in a Word Processing document. The characteristics of this table can be defined and modified by several WLanguage properties.
CAUTION: This type must not be used directly. It must only be used via the
docParagraph variables corresponding to a table.
// Retrieve the document
MyDocument is Document <- WP_Table
// Retrieve the table, here the paragraph 1
pTable is docParagraph <- MyDocument.Paragraph[1]
// Browses the rows
FOR I = 1 _TO_ pTable.Table.Rows.Occurrence
// Browses the columns
FOR I = 1 _TO_ pTable.Table.Columns.Occurrence
Trace("Value of cell [[%I%]][[%j%]] = " +
pTable.Table.Cells[I, j].Content.Text)
END
END
Remarks
Properties specific to the description of docTable variables
The following properties can be used to handle a docTable variable:
| | | |
| Property name | Type used | Effect |
|---|
| Cells[Row,Column] | Table of table cells (docCell) | Accessing the cells of a Table paragraph. The type of table cells is docCell. |
| Columns | | docColumn variable | Used to handle the table columns. For example, to insert a column at the 3rd column of a table:
Insert(pTable.Table.Columns, 3)
|
| Columns.WidthMillimeters | Real | Width of row (in millimeters). |
| Columns.WidthMode | Integer constant | Mode for calculating the column width: - docWidthModeNone: Special case.
- docWidthModeAutomatic: The column width is automatically calculated according to the text found in the current column and to the one found in the other columns.
- docWidthModeUndefined: The mode for calculating the column width is not defined because column cells have different widths.
- docWidthModePercent: The mode for calculating the column width is performed in percentage of total table width.
- docWidthModeValue: The mode for calculating the width of columns is performed according to a width supplied in millimeters. This mode is automatically selected if Columns.WidthMillimeters is specified.
This property is read-only. |
| Rows | | docRow variable | Used to handle the table rows. For example, to insert a row at the 3rd row of a table:
Insert(pTable.Table.Rows, 3)
|
| Rows.Height | Integer | Height of row (in millimeters). |
| Rows.HeightMode | Integer constant | Mode for calculating the row height: - docHeightModeAtLeast: The row height will be at least the one defined with the Height property.
- docHeightModeAutomatic: The row height is automatically calculated according to the text in the row cells.
- docHeightModeExact: The row height will be the one defined with the Height property.
- docHeightModeUndefined: The mode for calculating the row height is not defined (the automatic caculation mode is performed by default).
|
| Rows.CellCount | Integer | Number of row cells. This property is read-only. |