docTable (Type of variable)

WINDEV, WEBDEV AND WINDEV MOBILE
ONLINE HELP

Version:

Home | Sign in | English

Properties specific to the description of docTable variables

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

docTable (Type of variable)

In french: docTableau

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.

Caution: This documentation presents the last features of the Word Processing control. Make sure that all the necessary modules are updated.This type of variable is available from version 220059U (module dated 05/17/2017).

Example

// 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)
	Versions 23 and later Columns..WidthMillimeters New in version 23 Columns..WidthMillimeters Columns..WidthMillimeters	Real	Width of row (in millimeters).
	Versions 23 and later Columns..WidthMode New in version 23 Columns..WidthMode 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 available in 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 equal to the one defined by ..Height. docHeightModeAutomatic: The row height is automatically calculated according to the text found in the row cells. docHeightModeExact: The row height will be the one defined by ..Height. 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 available in read-only.

Remark: These properties can be handled by using one of the following syntaxes:

<Variable name>..<Property name>
<Variable name>.<Property name>