WP Lire elements

4D v17

WP Lire elements


WP Lire elements ( objCible {; typeElement} ) -> Résultat

Paramètre	Type	Description
objCible	Objet	Plage ou référence d'élément ou document 4D Write Pro
typeElement	Entier long	Choix du type d'éléments à retrouver
Résultat	Collection	Collection contenant des références d'éléments

Description

La commande WP Lire elements retourne une collection d'objets contenant des références aux paragraphes, images, tableaux et/ou lignes de tableaux.

Dans le paramètre objCible, vous pouvez passer :

une plage, ou
une référence à un élément (tableau / ligne / paragraphe / corps / en-tête / pied), ou
un document 4D Write Pro

Si une plage ou une référence typée est passée, la commande renverra une collection contenant uniquement les éléments du type correspondant (sauf si vous spécifiez un type grâce au paramètre typeElement, voir ci-dessous). Sinon, la commande retourne une collection contenant tous les éléments disponibles dans objCible.

Vous pouvez passer le paramètre optionnel typeElement pour spécifier les types d'éléments à renvoyer dans la collection. Les types suivants sont disponibles :

Constante	Valeur	Comment
wk type default	0	Type de plage par défaut
wk type image	2	Images ancrées et/ou en ligne
wk type image anchored	200	Référence d'image ancrée pour objets documents
wk type image inline	100	Référence d'image en ligne pour objets documents
wk type paragraph	1	Plage de type paragraphe
wk type table	4	Référence de tableau
wk type table row	5	Référence de ligne de tableau

Note :

Si vous passez le sélecteur wk type default, la commande renvoie une collection non filtrée.
Si vous passez le sélecteur wk type paragraph, wk type image ou wk type table, la collection retournée contiendra uniquement les éléments du type indiqué, même s'ils diffèrent du type spécifié dans le paramètre typeElement.
Les éléments de la collection retournée sont classés en fonction de leur ordre d'apparition dans objCible, sauf lors de la transmission d'une référence de document 4D Write Pro. Dans ce cas, les éléments seront classés par leur ID.
Si une plage indiquée dans objCible contient un élément qui n'est pas entièrement contenu dans la plage, l'élément entier sera inclus dans les résultats. Par exemple, si la plage inclut une partie d'un tableau (mais pas tout le tableau), la référence de l'élément tableau entier est renvoyée, en revanche seules les références de cellules (paragraphes) comprises dans la plage sont incluses.

Exemple 1

Vous voulez récupérer une collection de tous les paragraphes dans un document :

 C_COLLECTION($docElements)

 $docElements:=WP Lire elements($myDoc;wk type paragraph)

  //retourne une collection contenant seulement les éléments paragraphes

Exemple 2

Vous souhaitez alterner l'alignement et la couleur des paragraphes dans un document :

 C_COLLECTION($col)

 C_OBJET($obj)

 C_OBJET($body)

 C_ENTIER LONG($i;$n)

 $col:=Creer collection

 $body:=WP Lire corps(myDoc)

 $col:=WP Lire elements($body;wk type paragraph)

 $i:=0

 $n:=$col.length

 Boucle($i;0;$n-1)

    $obj:=$col[$i]

    WP REINITIALISER ATTRIBUTS($obj)

    WP FIXER ATTRIBUTS($obj;wk font bold;wk false)

    WP FIXER ATTRIBUTS($obj;wk font italic;wk false)

    Si($i%2=0)

       WP FIXER ATTRIBUTS($obj;wk text align;wk left)

       WP FIXER ATTRIBUTS($obj;wk font bold;wk true)

       WP FIXER ATTRIBUTS($obj;wk text color;"#804040")

       WP FIXER ATTRIBUTS($obj;wk margin right;"5cm")

       WP FIXER ATTRIBUTS($obj;wk margin left;"1cm")

    Sinon

       WP FIXER ATTRIBUTS($obj;wk text align;wk right)

       WP FIXER ATTRIBUTS($obj;wk font italic;wk true)

       WP FIXER ATTRIBUTS($obj;wk text color;"#404020")

       WP FIXER ATTRIBUTS($obj;wk margin left;"5cm")

       WP FIXER ATTRIBUTS($obj;wk margin right;"1cm")

    Fin de si

 Fin de boucle

Voir aussi

WP Creer plage tableaux
WP Lire element par ID