WP Inserer tableau

4D v17

WP Inserer tableau


WP Inserer tableau ( objPlage ; mode {; miseAJourPlage {; nbCols {; nbLignes}}} ) -> Résultat

Paramètre	Type	Description
objPlage	Objet	Plage 4D Write Pro
mode	Entier long	Mode d'insertion
miseAJourPlage	Entier long	Mode de mise à jour de la plage de sélection
nbCols	Entier long	Nombre de colonnes à créer dans le tableau
nbLignes	Entier long	Nombre de lignes à créer dans le tableau
Résultat	Objet	Objet listant les propriétés du tableau

Description

La commande WP Inserer tableau insère un nouveau tableau dans la plage objPlage en fonction du mode d'insertion spécifié et retourne le nouvel objet correspondant. Optionnellement, vous pouvez passer le paramètre miseAJourPlage ainsi qu'un nombre prédéfini de colonnes et de lignes dans nbCols et nbLignes.

Dans objPlage, passez une plage standard 4D Write Pro.

Note : L'insertion d'un tableau dans un autre tableau n'est pas possible (une erreur est retournée).

Dans le paramètre mode, passez une des constantes suivantes pour indiquer le mode d'insertion à utiliser pour insérer le tableau dans le document :

Constante	Type	Valeur	Comment
wk append	Entier long	2	Insère le contenu à la fin de la cible
wk prepend	Entier long	1	Le contenu est inséré au début de la cible
wk replace	Entier long	0	Remplace le contenu de la cible

Dans le paramètre optionnel miseAJourPlage, vous pouvez passer une des constantes suivantes pour spécifier si le tableau inséré fait partie ou pas de la plage :

Constante	Type	Valeur	Comment
wk exclude from range	Entier long	1	Le contenu inséré n'est pas inclus dans la plage mise à jour
wk include in range	Entier long	0	Le contenu inséré est inclus dans la plage mise à jour (défaut)

Si vous ne passez pas le paramètre miseAJourPlage, par défaut, le tableau inséré est inclus dans la plage.

Vous pouvez passer dans nbCols et nbLignes le nombre de colonnes et de lignes du tableau inséré. Par défaut, si nbCols et nbLignes sont omis, un nouveau tableau avec 0 colonne et 0 ligne est créé. Vous pouvez alors ajouter ces éléments en utilisant la commande WP Tableau ajouter ligne.

La commande retourne le nouveau tableau en tant qu'objet, que vous pouvez passer ensuite à une autre commande tableau 4D Write Pro. Le tableau est créé avec police, bordure, et attributs couleur par défaut, que vous pouvez personnaliser en utilisant la commande WP FIXER ATTRIBUTS.

Exemple

Dans un document vide, vous souhaitez ajouter un nouveau tableau avec 3 colonnes et 2 lignes :

 C_OBJET($WPRange;$WPTable)

 $WPRange:=WP Creer plage(WParea;wk start text;wk end text)

 $WPTable:=WP Inserer tableau($WPRange;wk append;wk exclude from range;3;2)

Résultat :

Voir aussi

WP Tableau ajouter ligne
WP Tableau lire lignes