4D v16

WP LIRE ATTRIBUTS

Accueil

 
4D v16
WP LIRE ATTRIBUTS

WP LIRE ATTRIBUTS 


 

WP LIRE ATTRIBUTS ( objPlage | wpDoc ; nomAttribut ; valeurAttribut {; nomAttribut2 ; valeurAttribut2 ; ... ; nomAttributN ; valeurAttributN} ) 
Paramètre Type   Description
objPlage | wpDoc  Objet in Plage ou document 4D Write Pro
nomAttribut  Chaîne in Nom d'attribut dont vous souhaitez lire la valeur
valeurAttribut  Chaîne, Réel, Booléen, Tableau in Valeur courante de l'attribut

La commande WP LIRE ATTRIBUTS retourne la valeur courante d'attribut(s) dans une plage ou un document 4D Write Pro. Cette commande donne accès à tous les types d'attributs internes de 4D Write Pro : caractère, paragraphe, document ou image.

Dans le premier paramètre, vous pouvez passer soit un objet plage 4D Write Pro (objPlage) soit une référence de document 4D Write Pro (wpDoc). Un objPlage représente une portion du document 4D Write Pro et peut être créé par différentes commandes. Le tableau suivant précise les éléments cibles de la commande WP LIRE ATTRIBUTS en fonction du premier paramètre objPlage | wpDoc et des attributs :

ParamètreAttributs communs (hormis "verticalAlign")Attributs de document uniquementAttributs de paragraphes uniquementAttributs de caractères uniquement (et "verticalAlign")
objPlage créé par WP Lire paragraphesparagraphesdocumentparagraphesparagraphes
objPlage créé par WP Lire imagesimagesdocument--
objPlage créé par WP Lire plage ou paragraphes pour la plagedocumentparagraphes pour la plage (intersection paragraphes)caractères pour la plage
wpDocdocumentdocumentparagraphes pour tout le documentcaractères pour tout le document

Les attributs communs (tels que "margin", "padding", etc.) sont communs aux documents, paragraphes et images.

Pour une liste complète des attributs que vous pouvez passer dans nomAttribut ainsi que leurs valeurs respectives retournées dans valeurAttribut, veuillez vous référer à la section Attributs 4D Write Pro.

S'il y a des valeurs différentes pour un même attribut dans la plage ou le document passé en paramètre, la commande retourne :

  • pour les valeurs numérique, wk mixed
  • pour un tableau, un tableau vide (tabulations, couleur si valeurAttribut est défini en tant que tableau), avec une exception pour l'attribut wk text shadow offset pour lequel la valeur du tableau contiendra toujours 2 éléments qui peuvent être fixés séparément à wk mixed si soit le décalage horizontal soit le décalage vertical (ou les deux) sont mélangés.
  • pour les valeurs chaîne, une chaîne vide
  • pour les valeurs image, une image vide

Exemple  

Vous souhaitez obtenir la couleur de fond de la zone sélectionnée :

 $range:=WP Lire selection(*;"WParea")
 WP LIRE ATTRIBUTS($range;wk background color;$bcol)



Voir aussi  

Attributs 4D Write Pro
Constantes 4D Write Pro
WP FIXER ATTRIBUTS
WP REINITIALISER ATTRIBUTS

 
PROPRIÉTÉS 

Produit : 4D
Thème : 4D Write Pro - Langage
Nom intl. : WP GET ATTRIBUTES

Commande(s) éligible(s) à l'exécution dans un process préemptif

 
HISTORIQUE 

Créé : 4D v15 R4

 
UTILISATION DE L'ARTICLE

4D Write Pro ( 4D v16)