WP Get subsection

4D v20

WP Get subsection


WP Get subsection ( 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 Get subsection 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 Get subsection 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_OBJECT($section;$subsection)

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

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

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

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

 

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

 If($subsection#Null)

    WP SET ATTRIBUTES($subsection;wk background color;"#87CEEB")

 Else

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

 End if

Voir aussi

WP DELETE SUBSECTION
WP Get section
WP New subsection