WP SET ATTRIBUTES

4D v20

WP SET ATTRIBUTES


WP SET ATTRIBUTES ( objCible ; nomAttribut ; valeurAttribut {; nomAttribut2 ; valeurAttribut2 ; ... ; nomAttributN ; valeurAttributN} )

Paramètre	Type	Description
objCible	Objet	Plage ou élément ou document 4D Write Pro
nomAttribut	Texte	Nom d'attribut dont vous souhaitez fixer la valeur
valeurAttribut	Texte, Numérique, Objet, Collection, Image, Date	Nouvelle valeur de l'attribut

Description

La commande WP SET ATTRIBUTES vous permet de fixer la valeur d'un ou plusieurs attribut(s) dans une plage, un élément ou un document 4D Write Pro. Cette commande donne accès à tous les types d'attributs internes de 4D Write Pro : caractère, paragraphe, tableau, document ou image.

Dans objCible, vous pouvez passer :

un objet plage 4D Write Pro, ou
un élément (en-tête / pied / corps / tableau / ligne / image en ligne ou ancrée / paragraphe / section / sous-section / feuille de style), ou
un document 4D Write Pro.

Dans nomAttribut, passez le nom de l'attribut à modifier pour la cible et dans valeurAttribut, passez la valeur à définir. Pour une liste complète des attributs que vous pouvez passer dans nomAttribut ainsi que les valeurs que vous pouvez passer dans valeurAttribut, veuillez vous référer à la section Attributs 4D Write Pro.

Vous pouvez passer autant de paires nomAttribut / valeurAttribut que vous voulez.

Note : Si vous devez définir plusieurs attributs pour la même cible, il est plus optimisé d'effectuer un appel unique à WP SET ATTRIBUTES avec toutes les paires attributs/valeurs, que d'appeler plusieurs fois WP SET ATTRIBUTES.

Exemple 1

Dans cette zone 4D Write Pro, vous sélectionnez un mot :

Si vous exécutez le code suivant :

 $range:=WP Get selection(*;"WParea") //récupérer la plage sélectionnée

 

  // fixer le décalage d'ombre en pt pour la sélection

 WP SET ATTRIBUTES($range;wk text shadow offset;1)

  //définir la marge intérieure du paragraphe

 WP SET ATTRIBUTES($range;wk padding;1)

  //définir une bordure de 10 pt

 WP SET ATTRIBUTES($range;wk border style;wk solid;wk border width;10)

  //définir les couleurs de bordure

 WP SET ATTRIBUTES($range;wk border color;"blue";wk border color bottom;"#00FA9A";wk border color right;"#00FA9A")

Vous obtenez le résultat suivant :

Exemple 2

Cet exemple illustre le rôle des constantes wk inside et wk outside :

 $wpRange:=WP Get selection(writeProdoc)

 WP SET ATTRIBUTES($wpRange;wk border style+wk inside;wk dotted)

 WP SET ATTRIBUTES($wpRange;wk border style+wk outside;wk solid)

 WP SET ATTRIBUTES($wpRange;wk border color+wk outside;"#00FA9A")

En supposant que tout le contenu était sélectionné, le résultat est :

Exemple 3

Vous souhaitez définir une image de fond pour le document :

 C_OBJECT(WParea)

 WParea:=WP New

 

 READ PICTURE FILE("C:\\Pictures\\boats.jpg";$picture)

 

 WP SET ATTRIBUTES(WParea;wk background image;$picture)

Le résultat est le suivant :

Vous souhaitez définir une image de fond qui recouvre la totalité de la zone d'impression :

 C_OBJECT(WParea)

 WParea:=WP New

 

 READ PICTURE FILE("C:\\Pictures\\boats.jpg";$picture)

 

 WP SET ATTRIBUTES(WParea;wk background image;$picture)

 WP SET ATTRIBUTES(WParea;wk background clip;wk paper box)

 WP SET ATTRIBUTES(WParea;wk background origin;wk paper box)

Le résultat est le suivant :

Note : La valeur wk paper box peut être appliquée uniquement aux documents ou aux sections.

Exemple 4

Vous souhaitez définir des tabulations à intervalles variés et définir un caractère comme étant le caractère principal pour la différente tabulation :

 $tab1:=New object()

 $tab1[wk type]:=wk left

 $tab1[wk offset]:="3cm"

 $tab1[wk leading]:=""

 

 $tab2:=New object()

 $tab2[wk type]:=wk center

 $tab2[wk offset]:="8cm"

 $tab2[wk leading]:=""

 

 $tab3:=New object()

 $tab3[wk type]:=wk right

 $tab3[wk offset]:="12cm"

 $tab3[wk leading]:="."

 

 $_tabs:=New collection($tab1;$tab2;$tab3)

 WP SET ATTRIBUTES(wpArea;wk tabs;$_tabs)

Le résultat est du type :

Voir aussi

Attributs 4D Write Pro
WP GET ATTRIBUTES
WP RESET ATTRIBUTES