WP Table insert columns

4D v20 R7


WP Table insert columns ( objCible \| {refTableau ; numCol} {; nbCols} ) -> Résultat

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

Description

La commande WP Table insert columns insère une ou plusieurs colonnes 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 colonnes 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 numCol, la commande insèrera la/les colonne(s) dans le tableau désigné, suivant l'indice de colonne spécifié. Si numCol est supérieur au nombre de colonnes dans refTableau, les colonnes ne sont pas insérées dans le tableau, mais elles y sont annexées.

Le paramètre optionnel nbCols définit le nombre de colonnes à insérer dans objCible ou refTableau. Par défaut, si ce paramètre est omis, une colonne est insérée.

Résultat

La commande retourne une plage de colonne représentant une ou plusieurs colonnes insérées, ou retourne Null si rien n'a été inséré.

Exemple

Vous souhaitez insérer deux colonnes après la première colonne du tableau Invoice. Le code suivant :

 C_OBJECT($column)

 C_OBJECT($table)

 

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

 

 $column:=WP Table insert columns($table;2;3) //2e position, ajoute 3 colonnes

Insèrera la nouvelle colonne à l'emplacement souhaité :

Voir aussi

WP Table insert rows