WP Lire section

4D v20

WP Lire section


WP Lire section ( objCible ) \| (docWP ; indexSection ) -> Résultat

Paramètre	Type	Description
objCible	Objet	Plage ou élément
docWP	Objet	Document 4D Write Pro
indexSection	Entier long	Index section
Résultat	Objet	Section 4D Write Pro

Description

La commande WP Lire section retourne soit la première section intersectée par la plage ou par l'élément objCible, soit l'indexSection spécifié du document docWP.

Avec la première syntaxe (utilisant le paramètre objCible), la commande retourne la première section intersectée par la plage ou par l'élément. Vous pouvez passer dans objCible :
- une plage, ou
- un élément (tableau / ligne / paragraphe / corps / zone de texte / en-tête / pied). Vous ne pouvez passer ni une sous-section ni une image ancrée (dans ce cas, une erreur est retournée).
Si la plage ou l'élément est associé(e) à un en-tête ou à un pied de page, WP Lire section retourne la section à laquelle l'en-tête ou le pied de page est associé. Si la plage ou l'élément est ou est associé(e) à une zone de texte, WP Lire section retourne toujours la première section, sauf s'il est ancré à une section (dans ce cas, la section est renvoyée).

Avec la deuxième syntaxe (utilisant le paramètre docWP), la commande retourne la section correspondant à la section indexSection spécifiée (la valeur d'indexSection doit être >=1).
Si aucune section n'est définie pour l'indexSection spécifié, la commande retourne un objet indéfini (aucune erreur n'est retournée).

Note : Utilisez la commande WP lire sous section pour lire une sous-section depuis une section ou depuis une plage.

Exemple

Vous souhaitez lire la première section :

 C_OBJET($section)

  // lire la référence de la première section

 $section:=WP Lire section(wpDoc;1)

Voir aussi

WP Lire sections
WP lire sous section