<Document variable>.InsertTable (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / WLanguage functions / Controls, pages and windows / Word Processing functions

Handling a Table programmatically

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

<Document variable>.InsertTable (Function)

In french: <Variable Document>.InsèreTableau

Inserts a table in a Document variable.

Example

// Récupération du document
MonDocument is Document <- TT_Tableau
// Insère un tableau à la position 1 de taille 3x3
MonDocument.InsertTable(1, 3, 3)

// Récupération du document
MonDocument is Document <- TT_Tableau
// Insère un tableau à la position du curseur de taille 3 colonnes et 2 lignes
MonDocument.InsertTable(TT_Tableau.Curseur, 3, 2)

Syntax

Inserting a table into a Word Processing document Hide the details

<Result> = <Document>.InsertTable(<Position> [, <Number of columns> [, <Number of rows>]])

<Result>: docFragment variable

docFragment variable with the inserted fragment.

<Document>: Document variable

Name of the Document variable to be used.

<Position>: Integer

Position where the table will be inserted. This position is expressed in number of characters.

<Number of columns>: Optional integer

Number of columns in the table. This parameters corresponds to 1 by default.

<Number of rows>: Optional integer

Number of rows in the table. This parameters corresponds to 1 by default.

Remarks

Handling a Table programmatically

A table in a Word Processing document can be handled by the WLanguage functions for managing arrays.

For example:

<Array>.Add or <Array>.Add to add rows or columns,
<Array>.Delete or <Array>.Delete to delete rows, columns, or the table itself.

// Récupération du document
MonDocument is Document <- TT_ExempleTT
// Insère un tableau à la position 1 de taille 3x3
MonDocument.InsertTable(1, 3, 3)
// Définition d'un fragment correspondant au tableau
f is docFragment(TT_ExempleTT.Valeur, TT_ExempleTT.Curseur, 0)
let para <- f.Paragraph[1]
IF para.Table = Null THEN
	RETURN
END
doc is Document <- TT_ExempleTT.Valeur
// Ajoute une ligne au tableau
nIndice is int = Add(para.Table.Rows)
// Saisie dans la cellule 2,2
para.Table.Cells[2,2].Content.Text = "Je suis dans la cellule 2,2"
// Supprime la ligne 3
Delete(para.Table.Rows, 3)
// Supprime la colonne 3
Delete(para.Table.Columns, 3)
// Supprime le tableau entier où se trouve le curseur
Delete(doc.Paragraph, para.ParagraphIndex)

Component: wd300mdl.dll