WP Table insert rows
WP Table insert rows ( objCible | {refTableau ; numLigne} {; nbLignes} ) -> Résultat
| Paramètre | Type | Description | |
|---|---|---|---|
| objCible | Object | → | Plage ou élément ou document 4D Write Pro |
| refTableau | Object | → | Référence de tableau |
| numLigne | Integer | → | Numéro d'indice de ligne |
| nbLignes | Integer | → | Nombre de lignes à insérer (valeur par défaut = 1) |
| Résultat | Object | ← | Plage de lignes du tableau |
Description
La commande WP Table insert rows insère une ou plusieurs lignes dans un tableau 4D Write Pro.
Cette commande prend en charge deux syntaxes :
- Si vous passez objCible comme premier paramètre, la commande insèrera la/les colonne(s) du premier tableau qui intersecte la cible. objCible peut contenir :
- une plage, ou
- un élément (ligne / paragraphe / corps / en-tête/ pied / image en ligne / section / sous-section), ou
- un document 4D Write Pro.
- Si vous passez les paramètres refTableau et numLigne, la commande insèrera la/les ligne(s) dans le tableau désigné, suivant l'indice de ligne spécifié. Si numLigne est supérieur au nombre de lignes dans refTableau, les lignes ne sont pas insérées dans le tableau, mais elles y sont annexées.
Le paramètre optionnel nbLignes définit le nombre de lignes à insérer dans objCible ou refTableau. Par défaut, si ce paramètre est omis, une ligne est insérée.
Résultat
La commande retourne une plage de ligne représentant un ou plusieurs ligne insérées, ou retourne Null si rien n'a été inséré.
Exemple
Vous souhaitez insérer deux lignes à la fin du tableau Invoice :
var $row : Object
var $table;$row : Object
var $rowNum : Integer
$table:=WP Get element by ID(WParea;"Invoice") //récupère le tableau "Invoice"
If($table#Null)
$rowNum:=$table.rowCount+1 //ajoute 1 à la dernière ligne pour désigner l'emplacement des nouvelles lignes
$row:=WP Table insert rows($table;$rowNum;2)
End if
Cela insèrera les deux nouvelles lignes à l'emplacement souhaité :
