WP Tableau inserer lignes

4D v20


WP Tableau inserer lignes ( objCible \| {refTableau ; numLigne} {; nbLignes} ) -> Résultat

Paramètre	Type	Description
objCible	Objet	Plage ou élément ou document 4D Write Pro
refTableau	Objet	Référence de tableau
numLigne	Entier long	Numéro d'indice de ligne
nbLignes	Entier long	Nombre de lignes à insérer (valeur par défaut = 1)
Résultat	Objet	Plage de lignes du tableau

Description

La commande WP Tableau inserer lignes 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 objCible n'intersecte pas une plage tableau ou une plage texte là où des lignes peuvent être insérées, la commande ne fait rien et retourne Null (aucune erreur n'est générée).

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 :

 C_OBJET($row)

 C_OBJET($table;$row)

 C_ENTIER LONG($rowNum)

 

 $table:=WP Lire element par ID(WParea;"Invoice") //récupère le tableau "Invoice"

 

 Si($table#Null)

    $rowNum:=$table.rowCount+1 //ajoute 1 à la dernière ligne pour désigner l'emplacement des nouvelles lignes

    $row:=WP Tableau inserer lignes($table;$rowNum;2)

 Fin de si

Cela insèrera les deux nouvelles lignes à l'emplacement souhaité :

Voir aussi

WP Tableau inserer colonnes