WP Get section

4D v20 R7

WP Get section


WP Get 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 Get 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 Get 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 Get 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 Get subsection pour lire une sous-section depuis une section ou depuis une plage.

Exemple

Vous souhaitez lire la première section :

 C_OBJECT($section)

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

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

Voir aussi

WP Get sections
WP Get subsection