WP Tableau lire colonnes

4D v20


WP Tableau lire colonnes ( objCible ) \| ( refTableau ; debutCol {; 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
debutCol	Entier long	Position de la première colonne
nbCols	Entier long	Nombre de colonnes à lire
Résultat	Objet	Nouvelle plage colonne contenant les colonnes sélectionnées

Description

La commande WP Tableau lire colonnes retourne un nouvel objet plage colonne contenant la sélection de colonnes de objCible ou de refTableau (définies par debutCol et nbCols).

Passez soit :

objCible :
- 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 de tableau ou de texte là où une sélection de colonnes peut être récupérée, la commande retourne Null.

refTableau - la référence du tableau contenant la sélection de colonnes à lire.
debutCol - pointe vers la première colonne du tableau à retourner, et
(optionnel) nbCols - indique le nombre de colonnes à retourner. Si nbCols est omis, l'unique colonne de debutCol est retournée.

Si debutCol plus nbCols excède le nombre de colonnes dans refTableau, ou si debutCol est plus grand que le nombre de colonnes dans refTableau, la plage retournée contient le maximum de colonnes.

Exemple 1

Vous souhaitez modifier des attributs des deux dernières colonnes du tableau :

 C_OBJET($wpTable;$wpRange;$wpRow1;$wpRow2;$wpRow3;$wpRow4;$wpRow5;$cols)

 $wpRange:=WP Plage texte(WParea;wk start text;wk end text)

 $wpTable:=WP Insérer tableau($wpRange;wk append)

 $wpRow1:=WP Tableau ajouter ligne($wpTable;"Paul";"Smith";25)

 $wpRow2:=WP Tableau ajouter ligne($wpTable;"John";"Richmond";40)

 $wpRow3:=WP Tableau ajouter ligne($wpTable;"Mary";"Trenton";18)

 $wpRow4:=WP Tableau ajouter ligne($wpTable;"Christopher";"Lee";53)

 $wpRow5:=WP Tableau ajouter ligne($wpTable;"Henry";"Cartier";42)

 

 $cols:=WP Tableau lire colonnes($wpTable;2;2)

 WP FIXER ATTRIBUTS($cols;wk background color;0x00E0E0E0;wk text color;"red";wk height;"36pt";wk text align;wk center)

Résultat :

Exemple 2

Vous souhaitez obtenir une plage de colonnes à compter de la 10e jusqu'à la dernière :

WP Tableau lire colonnes(tableRef;10;MAXLONG)

Exemple 3

Vous souhaitez récupérer les colonnes sélectionnées par un utilisateur :

 C_OBJET($userSelection;$columns)

 

 $userSelection:=WP Plage selection(myWPArea)

 

 $columns:=WP Tableau lire colonnes($userSelection)

Voir aussi

WP Tableau lire cellules
WP Tableau lire lignes