WP lire sous section

4D v20


WP lire sous section ( objCible ) \| (wpSection ; typeSousSection ) -> Résultat

Paramètre	Type	Description
objCible	Objet	Plage ou élément
wpSection	Objet	Section 4D Write Pro
typeSousSection	Entier long	Type de sous-section (wk first page, wk left page ou wk right page)
Résultat	Objet	Sous-section

Description

La commande WP lire sous section retourne soit la première sous-section intersectée par la plage ou par l'élément objCible, soit la sous-section typeSousSection spécifiée de la section wpSection.

Avec la première syntaxe (utilisant le paramètre objCible), la commande retourne la première sous-section qui intersecte la plage ou l'élément. Si aucune sous-section n'intersecte la plage ou l'élément, un objet null est retourné. Vous pouvez passer dans objCible :
- une plage, ou
- un élément (tableau / ligne / paragraphe / corps / zone de texte / en-tête / pied ).
Si la plage ou l'élément est ou est associé(e) à un en-tête, un pied ou une zone de texte, WP lire sous section retourne la sous-section à laquelle l’objCible est associé. Si l’objCible n'est pas associé à une sous-section, un objet null est retourné.
Si la plage ou l'élément est associé(e) à une image ancrée, une erreur est retournée.

Avec la deuxième syntaxe (utilisant les paramètres wpSection et typeSousSection), la commande retourne un objet wpSubSection (enfant de wpSection) de type typeSousSection. Passez l'une des constantes suivantes dans le paramètre typeSousSection :

Constante	Type	Valeur
wk first page	Entier long	1
wk left page	Entier long	2
wk right page	Entier long	3

Si aucune sous-section typeSousSection n'est définie pour la wpSection spécifiée, la commande retourne un objet indéfini (aucune erreur n'est retournée).

Exemple

Vous souhaitez appliquer un fond bleu aux pages de gauche :

 C_OBJET($section;$subsection)

  //Récupère la référence de la première section

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

  //Récupère la référence de la première sous-section gauche de la première section

 $subsection:=WP lire sous section($section;wk left page)

 

  //Si la sous-section existe, fixe le fond en bleu

 Si($subsection#Null)

    WP FIXER ATTRIBUTS($subsection;wk background color;"#87CEEB")

 Sinon

    ALERTE("Veuillez créer des sous-sections gauche et droite")

 Fin de si

Voir aussi

WP Creer sous section
WP Lire section
WP SUPPRIMER SOUS SECTION