Les attributs 4D Write Pro vous permettent de contrôler tous les aspects graphiques du texte et des images contenus dans vos documents. Ces attributs sont gérés par les commandes suivantes :
Note : Les commandes 4D génériques OB SET et OB Get permettent également de manipuler les attributs des zones 4D Write Pro, avec toutefois une limitation concernant l'utilisation directe d'images (pour plus d'informations, veuillez vous reporter à la description de ces commandes).
Les attributs de fond (background) permettent de définir des effets d'arrière-plan dans vos documents. Ces attributs s'appliquent aux éléments suivants :
Documents
Paragraphes
Caractères
Images
X
X
X
Constante
Comment
wk background clip
Définit la zone de fond. Valeurs possibles :
wk border box (défaut) : le fond est jusqu'au bord extérieur de la bordure
wk content box : le fond est à l'intérieur de la zone "content"
wk padding box : le fond est jusqu'au bord extérieur du padding (ou jusqu'au bord interne de la bordure, le cas échéant)
wk background color
Définit la couleur de fond d'un élément. Valeurs possibles :
une couleur CSS ("#010101" ou "#FFFFFF" ou "red").
une valeur de couleur 4D (entier long, voir commande OBJECT SET COLOR)
un tableau entier long contenant un élément pour chaque composante R, G, B (0-255)
La valeur par défaut pour les documents est "#FFFFFF" et wk transparent ou "transparent" pour les paragraphes et les images.
wk background image
Définit une image à utiliser en fond. Valeurs possibles en écriture :
URL d'image (chaîne). Peut être absolu ou relatif au fichier de structure.
Champ ou variable image.
Valeur retournée (WP GET ATTRIBUTES) : URI (URL réseau ou URI de données). Cette valeur peut ne pas être égale à l'URL initial pour une image non référencée par un URL réseau (seuls les URLs réseau sont conservés). Pour les URLs de fichiers locaux, le flux d'image (stream) lui-même est conservé dans le document et donc l'URL retourné est un URI de données avec le flux d'image encodé en base64.
wk background origin
Définit la position de l'image de fond. Valeurs possibles :
wk padding box (défaut) : l'image de fond débute au rectangle de padding (ou à l'intérieur de la bordure)
wk border box : l'image de fond débute au rectangle de la bordure (bord extérieur)
wk content box : l'image de fond au rectangle "content"
wk background position h
Définit la position horizontale de départ d'une image de fond. Valeurs possibles :
wk left (défaut) : l'image de fond débute horizontalement à gauche de l'élément
wk center : l'image de fond débute horizontalement au centre de l'élément
wk right : l'image de fond débute horizontalement à droite de l'élément
wk background position v
Définit la position verticale de départ d'une image de fond. Valeurs possibles :
wk top (défaut) : l'image de fond débute verticalement en haut de l'élément
wk middle : l'image de fond débute verticalement au centre de l'élément
wk bottom : l'image de fond débute verticalement à droite de l'élément
wk background repeat
Définit si et comment une image de fond est répétée. Valeurs possibles :
wk repeat (défaut) : l'image de fond est répétée verticalement et horizontalement
wk no repeat : l'image de fond n'est pas répétée
wk repeat x : l'image de fond est répétée horizontalement uniquement
wk repeat y : l'image de fond est répétée verticalement uniquement
wk background size h
Définit la dimension horizontale d'une image de fond. Valeurs possibles :
wk auto (défaut) : utilise la largeur courante de l'image de fond
wk contain : redimensionne l'image à sa largeur maximale de manière qu'elle "tienne" entièrement dans la zone "content" tout en préservant ses proportions. Cette option modifie également la valeur de l'autre attribut de dimension.
wk cover : redimensionne l'image de manière à ce que le fond soit entièrement recouvert par l'image de fond tout en préservant ses proportions. Certaines parties de l'image peuvent être tronquées. Cette option modifie également la valeur de l'autre attribut de dimension
Taille définie : définit la largeur de l'image via une valeur de type réel ou chaîne :
Réel : Taille en wk layout unit.
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres. Valeur minimum : 0pt, valeur maximum : 10000pt. Il est possible de passer une valeur relative (pourcentage %).
wk background size v
Définit la dimension verticale d'une image de fond. Valeurs possibles :
wk auto (défaut) : utilise la hauteur courante de l'image de fond
wk contain : redimensionne l'image à sa hauteur maximale de manière qu'elle "tienne" entièrement dans la zone "content" tout en préservant ses proportions. Cette option modifie également la valeur de l'autre attribut de dimension.
wk cover : redimensionne l'image à sa hauteur maximale de manière à ce que le fond soit entièrement recouvert par l'image de fond tout en préservant ses proportions. Certaines parties de l'image peuvent être tronquées. Cette option modifie également la valeur de l'autre attribut de dimension
Taille définie : définit la largeur de l'image via une valeur de type réel ou chaîne :
Réel : Taille en wk layout unit.
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres. Valeur minimum : 0pt, valeur maximum : 10000pt. Il est possible de passer une valeur relative (pourcentage %).
Les attributs de bordure permettent de définir le style, la largeur et la couleur des bordures. Ces attributs s'appliquent aux éléments suivants :
Documents
Paragraphes
Caractères
Images
X
X
X
Constante
Comment
wk border color
Définit la couleur pour les quatre bordures. Valeurs possibles :
une couleur CSS ("#010101" ou "#FFFFFF" ou "red").
une valeur de couleur 4D (entier long, voir commande OBJECT SET COLOR)
un tableau entier long contenant un élément pour chaque composante R, G, B (0-255)
La valeur par défaut est "#000000" (si valeur chaîne). S'il y a plusieurs couleurs, WP GET ATTRIBUTES retourne une chaîne vide.
wk border color bottom
Définit la couleur pour la bordure basse. Valeurs possibles :
une couleur CSS ("#010101" ou "#FFFFFF" ou "red"). La valeur par défaut est "#000000"
une valeur de couleur 4D (entier long, voir commande OBJECT SET COLOR)
un tableau entier long contenant un élément pour chaque composante R, G, B (0-255)
wk border color left
Définit la couleur pour la bordure gauche. Valeurs possibles :
une couleur CSS ("#010101" ou "#FFFFFF" ou "red"). La valeur par défaut est "#000000"
une valeur de couleur 4D (entier long, voir commande OBJECT SET COLOR)
un tableau entier long contenant un élément pour chaque composante R, G, B (0-255)
wk border color right
Définit la couleur pour la bordure droite. Valeurs possibles :
une couleur CSS ("#010101" ou "#FFFFFF" ou "red"). La valeur par défaut est "#000000"
une valeur de couleur 4D (entier long, voir commande OBJECT SET COLOR)
un tableau entier long contenant un élément pour chaque composante R, G, B (0-255)
wk border color top
Définit la couleur pour la bordure haute. Valeurs possibles :
une couleur CSS ("#010101" ou "#FFFFFF" ou "red"). La valeur par défaut est "#000000"
une valeur de couleur 4D (entier long, voir commande OBJECT SET COLOR)
un tableau entier long contenant un élément pour chaque composante R, G, B (0-255)
wk border radius
Définit l'arrondi des angles de la bordure. Valeurs possibles :
wk none (défaut) : la bordure n'a pas d'angles arrondis
Valeur d'angle exprimée par une valeur de type entier ou chaîne :
Entier : Angle en wk layout unit.
Chaîne : chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points ou 1.5cm pour 1,5 centimètres.
wk border style
Définit le style des quatre bordures. Valeurs possibles :
wk none (défaut) : pas de bordure
wk hidden : équivaut à wk none, sauf en résolution de conflit de bordure
wk solid : bordure pleine
wk dotted : bordure en pointillés
wk dashed : bordure en tirets
wk double : bordure double
wk groove : bordure relief 3D (l'effet réel dépend de la couleur de la bordure)
wk ridge : bordure relief 3D inversé (l'effet réel dépend de la couleur de la bordure)
wk inset : bordure biseau 3D (l'effet réel dépend de la couleur de la bordure)
wk border style bottom
Définit le style de la bordure basse. Valeurs possibles :
wk none (défaut) : pas de bordure basse
wk hidden : équivaut à wk none, sauf en résolution de conflit de bordure
wk solid : bordure pleine
wk dotted : bordure en pointillés
wk dashed : bordure en tirets
wk double : bordure double
wk groove : bordure relief 3D (l'effet réel dépend de la couleur de la bordure)
wk ridge : bordure relief 3D inversé (l'effet réel dépend de la couleur de la bordure)
wk inset : bordure biseau 3D (l'effet réel dépend de la couleur de la bordure)
wk border style left
Définit le style de la bordure gauche. Valeurs possibles :
wk none (défaut) : pas de bordure gauche
wk hidden : équivaut à wk none, sauf en résolution de conflit de bordure
wk solid : bordure pleine
wk dotted : bordure en pointillés
wk dashed : bordure en tirets
wk double : bordure double
wk groove : bordure relief 3D (l'effet réel dépend de la couleur de la bordure)
wk ridge : bordure relief 3D inversé (l'effet réel dépend de la couleur de la bordure)
wk inset : bordure biseau 3D (l'effet réel dépend de la couleur de la bordure)
wk border style right
Définit le style de la bordure droite. Valeurs possibles :
wk none (défaut) : pas de bordure droite
wk hidden : équivaut à wk none, sauf en résolution de conflit de bordure
wk solid : bordure pleine
wk dotted : bordure en pointillés
wk dashed : bordure en tirets
wk double : bordure double
wk groove : bordure relief 3D (l'effet réel dépend de la couleur de la bordure)
wk ridge : bordure relief 3D inversé (l'effet réel dépend de la couleur de la bordure)
wk inset : bordure biseau 3D (l'effet réel dépend de la couleur de la bordure)
wk border style top
Définit le style de la bordure haute. Valeurs possibles :
wk none (défaut) : pas de bordure haute
wk hidden : équivaut à wk none, sauf en résolution de conflit de bordure
wk solid : bordure pleine
wk dotted : bordure en pointillés
wk dashed : bordure en tirets
wk double : bordure double
wk groove : bordure relief 3D (l'effet réel dépend de la couleur de la bordure)
wk ridge : bordure relief 3D inversé (l'effet réel dépend de la couleur de la bordure)
wk inset : bordure biseau 3D (l'effet réel dépend de la couleur de la bordure)
wk border width
Définit la largeur des quatre bordures. Vous devez spécifier le style de la bordure avant sa largeur. Valeurs possibles :
Largeur exprimée par une valeur de type entier ou chaîne :
Entier : largeur en wk layout unit.
Chaîne : chaîne CSS avec la valeur et l'unité concaténées. Ex. : 12pt pour 12 points ou 1.5cm pour 1,5 centimètres
Valeur par défaut : 2pt
wk border width bottom
Définit la largeur de la bordure basse. Valeurs possibles :
Largeur exprimée par une valeur de type entier ou chaîne :
Entier : Largeur en wk layout unit.
Chaîne : chaîne CSS avec la valeur et l'unité concaténées. Ex. : 12pt pour 12 points ou 1.5cm pour 1,5 centimètres
Valeur par défaut : 2pt
wk border width left
Définit la largeur de la bordure gauche. Valeurs possibles :
Largeur exprimée par une valeur de type entier ou chaîne :
Entier : Largeur en wk layout unit.
Chaîne : chaîne CSS avec la valeur et l'unité concaténées. Ex. : 12pt pour 12 points ou 1.5cm pour 1,5 centimètres
Valeur par défaut : 2pt
wk border width right
Définit la largeur de la bordure droite. Valeurs possibles :
Largeur exprimée par une valeur de type entier ou chaîne :
Entier : Largeur en wk layout unit.
Chaîne : chaîne CSS avec la valeur et l'unité concaténées. Ex. : 12pt pour 12 points ou 1.5cm pour 1,5 centimètres
Valeur par défaut : 2pt
wk border width top
Définit la largeur de la bordure haute. Valeurs possibles :
Largeur exprimée par une valeur de type entier ou chaîne :
Entier : Largeur en wk layout unit.
Chaîne : chaîne CSS avec la valeur et l'unité concaténées. Ex. : 12pt pour 12 points ou 1.5cm pour 1,5 centimètres
Valeur par défaut : 2pt
wk inside
Lorsque la zone sélectionnée contient plusieurs paragraphes, définit que l'attribut doit être appliqué uniquement sur la propriété inter-paragraphes correspondante (et pas à l'extérieur). Peut être utilisé avec les attributs de bordures, padding ou marges, et doit être ajouté à l'attribut spécifié. Voir exemple 2 de la commande WP SET ATTRIBUTES.
wk outside
Lorsque la zone sélectionnée contient plusieurs paragraphes, définit que l'attribut doit être appliqué uniquement sur la propriété de paragraphe externe correspondante (et pas à l'intérieur). Peut être utilisé avec les attributs de bordures, padding ou marges, et doit être ajouté à l'attribut spécifié. Voir exemple 2 de la commande WP SET ATTRIBUTES.
Les attributs de document sont utilisés pour fixer ou lire des meta informations relatives au document lui-même, telles que le sujet, le nom de l'auteur et de sa société, ou encore des commentaires. Ces attributs s'appliquent aux éléments suivants :
Documents
Paragraphes
Caractères
Images
X
Constante
Comment
wk author
Indique le nom de l'auteur du document (chaîne)
wk company
Définit une entreprise associée au document (chaîne)
wk date creation
Retourne la date de création du document (date). Cette valeur est en lecture seulement et ne peut pas être fixée.
wk date modified
Retourne la date de dernière modification du document (date). Cette valeur est en lecture seulement et ne peut pas être fixée.
wk dpi
DPI utilisés pour la conversion interne pixels <->points (entier). Toujours 96 (lecture seulement)
wk layout unit
Définit l'unité de dimension de certains attributs lorsqu'une valeur réelle ou entière est écrite ou lue. Valeurs possibles :
wk unit cm (défaut) : centimètres
wk unit pt : points
wk unit px : pixels
wk unit percent (seulement pour wk line height et wk background size h / wk background size v)
wk unit mm : millimètres
wk unit inch : pouces
wk notes
Définit des commentaires dans le document (chaîne).
wk subject
Définit le sujet du document (chaîne)
wk title
Définit le titre du document (chaîne). Par défaut "New 4D Write Pro Document"
wk version
Retourne le numéro de version 4DWP interne du document (réel). Ce numério peut uniquement être lu par la commande WP GET ATTRIBUTES, il ne peut pas être fixé.
Ces attributs définissent la famille de police ainsi que la taille et le style du texte. Ils s'appliquent aux éléments suivants :
Documents
Paragraphes
Caractères
Images
X
Constante
Comment
wk font
Définit le nom de police complet avec les styles, comme retourné par la commande FONT STYLE LIST. Si vous passez un nom invalide, la commande ne fait rien. Valeur par défaut : "Times New Roman".
wk font bold
Définit la graisse du texte (dépend des styles de police disponibles). Valeurs possibles :
wk true pour passer en style gras les caractères sélectionnés ; avec la commande WP GET ATTRIBUTES, wk true est retournée si au moins un des caractères sélectionnés prend en charge le style de police gras.
wk false (défaut) pour supprimer le style gras des caractères sélectionnés s'il y en a ; avec la commande WP GET ATTRIBUTES, wk false est retournée si aucun des caractères sélectionnés ne prend en charge le style de police gras.
wk font family
Spécifie le nom de famille de police tel que défini par wk font. Valeur par défaut : "Times New Roman". Une chaîne vide est retournée par la commande WP GET ATTRIBUTES si les caractères sélectionnés contiennent des propriétés de famille de police différentes.
wk font italic
Définit le style italique du texte (dépend des styles de police disponibles). Valeurs possibles :
wk true pour passer en style italique ou oblique les caractères sélectionnés ; avec la commande WP GET ATTRIBUTES, wk true est retournée si au moins un des caractères sélectionnés prend en charge le style de police italique ou oblique.
wk false (défaut) pour supprimer le style italique ou oblique des caractères sélectionnés s'il y en a ; avec la commande WP GET ATTRIBUTES, wk false est retournée si aucun des caractères sélectionnés ne prend en charge le style de police italique ou oblique.
wk font size
Définit la taille de police du texte. Valeurs possibles (en points uniquement) :
Réel (défaut = 12)
Chaîne CSS avec la valeur et l'unité concaténées. Ex. : 12pt pour 12 points.
wk text color
Définit la couleur du texte. Valeurs possibles :
une couleur CSS ("#010101" ou "#FFFFFF" ou "red"). La valeur par défaut est "#000000"
une valeur de couleur 4D (entier long, voir commande OBJECT SET COLOR)
un tableau entier long contenant un élément pour chaque composante R, G, B (0-255)
wk text linethrough color
Définit la couleur de la ligne du texte barré. Valeurs possibles :
une couleur CSS ("#010101" ou "#FFFFFF" ou "red"). La valeur par défaut est "#000000"
une valeur de couleur 4D (entier long, voir commande OBJECT SET COLOR)
un tableau entier long contenant un élément pour chaque composante R, G, B (0-255)
Par défaut, "currentColor" si chaîne, ou wk default si entier long.
wk text linethrough style
Définit le style du texte barré. Valeurs possibles :
wk none (défaut) : pas d'effet texte barré
wk solid : dessine une ligne pleine sur le texte sélectionné
wk dotted : dessine une ligne en pointillés sur le texte sélectionné
wk dashed : dessine une ligne en tirets sur le texte sélectionné
wk double : dessine une ligne double sur le texte sélectionné
wk semi transparent : atténue la ligne sur le texte sélectionné. Peut être combiné à un autre style de ligne.
wk word : dessine une ligne sur les mots uniquement (exclut les blancs). Peut être combiné à un autre style de ligne.
wk text shadow color
Définit la couleur d'ombre du texte sélectionné. Valeurs possibles :
une couleur CSS ("#010101" ou "#FFFFFF" ou "red").
une valeur de couleur 4D (entier long, voir commande OBJECT SET COLOR)
un tableau entier long contenant un élément pour chaque composante R, G, B (0-255)
wk transparent (défaut)
wk text shadow offset
Définit le décalage pour l'effet ombré. Valeurs possibles :
Taille exprimée en points. Valeur par défaut : 1pt
wk text transform
Définit la casse des lettres dans le texte. Valeurs possibles :
wk capitalize : les lettres initiales sont passées en capitales
wk lowercase : les lettres sont passées en minuscules
wk uppercase : les lettres sont passées en majuscules
wk small uppercase : les lettres sont passées en petites majuscules
wk none (défaut) : pas de transformation
wk text underline color
Définit la couleur du trait de soulignement. Valeurs possibles :
une couleur CSS ("#010101" ou "#FFFFFF" ou "red"). La valeur par défaut est "#000000"
une valeur de couleur 4D (entier long, voir commande OBJECT SET COLOR)
un tableau entier long contenant un élément pour chaque composante R, G, B (0-255)
Par défaut, "currentColor" si chaîne, ou wk default si entier long.
wk text underline style
Définit le style du trait de soulignement. Valeurs possibles :
wk none (défaut) : pas de soulignement
wk solid : dessine un trait plein
wk dotted : dessine un trait en pointillés
wk dashed : dessine un trait en tirets
wk double : dessine un trait double
wk semi transparent : atténue le trait. Peut être combiné à un autre style de ligne.
wk word : dessine le trait sur les mots uniquement (exclut les blancs). Peut être combiné à un autre style de trait.
wk vertical align
Définit l'alignement vertical d'un élément. Peut être utilisé avec les caractères, les paragraphes et les images. Valeurs possibles :
wk baseline (défaut) : aligne la base de l'élément avec la base de l'élément parent
wk top : aligne le haut de l'élément avec le haut de l'élément le plus grand sur la ligne
wk bottom : aligne le bas de l'élément avec le bas de l'élément le plus bas sur la ligne
wk middle : aligne l'élément au milieu de l'élément parent
wk superscript : aligne l'élément comme s'il était en exposant
wk subscript : aligne l'élément comme s'il était en indice
Pour les caractères, wk top et wk bottom ont le même effet que wk baseline. Pour les paragraphes, wk baseline, wk superscript et wk subscript ont le même effet que wk top.
Les attributs hauteur/largeur permettent de gérer les dimensions des paragraphes et des images. Ces attributs s'appliquent aux éléments suivants :
Documents
Paragraphes
Caractères
Images
X
X
Constante
Comment
wk height
Définit la hauteur de l'élément. La propriété height n'inclut pas le padding, les bordures ou les marges ; elle définit la hauteur de la zone située à l'intérieur du padding, de la bordure et de la marge de l'élément. Valeurs possibles :
wk auto (défaut) : la hauteur est basée sur le contenu de l'élément
Taille définie : taille exprimée par une valeur de type réel ou chaîne :
Réel : Taille en wk layout unit.
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres. Valeur minimum : 0pt, valeur maximum : 10000pt.
L'attribut wk height est écrasé par l'attribut wk min height (si défini).
Note : Dans l'implémentation actuelle, wk height peut uniquement être utilisé avec les images.
wk min height
Définit la hauteur minimum de l'élément. La valeur de la propriété wk height ne peut pas devenir plus petite que wk min height. Valeurs possibles :
wk auto (défaut) : la hauteur minimum est basée sur le contenu de l'élément
Taille définie : taille exprimée par une valeur de type réel ou chaîne :
Réel : Taille en wk layout unit.
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres. Valeur minimum : 0pt, valeur maximum : 10000pt.
L'attribut wk min height écrase la valeur de l'attribut wk height.
Note : Dans l'implémentation actuelle, wk min height peut uniquement être utilisé avec les images.
wk min width
Définit la largeur minimum de l'élément. La valeur de la propriété wk width ne peut pas devenir plus petite que wk min width. Valeurs possibles :
wk auto (défaut) : la largeur minimum est basée sur le contenu de l'élément
Taille définie : taille exprimée par une valeur de type réel ou chaîne :
Réel : Taille en wk layout unit.
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres. Valeur minimum : 0pt, valeur maximum : 10000pt.
L'attribut wk min width écrase la valeur de l'attribut wk width.
Note : Dans l'implémentation actuelle, wk min width peut uniquement être utilisé avec les images.
wk width
Définit la largeur de l'élément. Valeurs possibles :
wk auto (défaut) : la largeur est basée sur le contenu de l'élément
Taille définie : taille exprimée par une valeur de type réel ou chaîne :
Réel : Taille en wk layout unit.
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres. Valeur minimum : 0pt, valeur maximum : 10000pt.
L'attribut wk width est écrasé par l'attribut wk min width (si défini).
Note : Dans l'implémentation actuelle, wk width peut uniquement être utilisé avec les images.
Les attributs Image permettent de gérer les images insérées dans la zone. Ils s'appliquent aux éléments suivants :
Documents
Paragraphes
Caractères
Images
X
Constante
Comment
wk image
Définit une image. Valeurs possibles en écriture :
URL d'image (chaîne). Peut être absolu ou relatif au fichier de structure.
Champ ou variable image.
Valeur retournée (WP GET ATTRIBUTES) : URI (URL réseau ou URI de données). Cette valeur peut ne pas être égale à l'URL initial pour une image non référencée par un URL réseau (seuls les URLs réseau sont conservés). Pour les URLs de fichiers locaux, le flux d'image (stream) lui-même est conservé dans le document et donc l'URL retourné est un URI de données avec le flux d'image encodé en base64.
wk image alternative text
Définit un texte alternatif à l'image, si elle ne peut pas être affichée.
wk vertical align
Définit l'alignement vertical d'un élément. Peut être utilisé avec les caractères, les paragraphes et les images. Valeurs possibles :
wk baseline (défaut) : aligne la base de l'élément avec la base de l'élément parent
wk top : aligne le haut de l'élément avec le haut de l'élément le plus grand sur la ligne
wk bottom : aligne le bas de l'élément avec le bas de l'élément le plus bas sur la ligne
wk middle : aligne l'élément au milieu de l'élément parent
wk superscript : aligne l'élément comme s'il était en exposant
wk subscript : aligne l'élément comme s'il était en indice
Pour les caractères, wk top et wk bottom ont le même effet que wk baseline. Pour les paragraphes, wk baseline, wk superscript et wk subscript ont le même effet que wk top.
4D Write Pro prend en charge deux principaux types de listes :
les listes non ordonnées : listes aussi appelées "listes à puces"
les listes ordonnées : listes dont les "marqueurs" d'éléments sont des chiffres ou des lettres et sont incrémentés
Les attributs de liste permettent de configurer la police ainsi que les marqueurs des éléments. Ces attributs s'appliquent aux éléments suivants :
Documents
Paragraphes
Caractères
Images
X
Constante
Comment
wk list font
Spécifie un nom complet de police, comme retourné par la commande FONT STYLE LIST, pour afficher le marqueur de l'élément de liste (et non le texte du paragraphe). Si le système ne reconnaît pas le nom de police, il gère la substitution. Si vous passez un nom de police invalide, la commande ne fait rien. Valeur par défaut : "Times".
wk list font family
Spécifie un nom de famille de police tel que défini par wk list font, utilisé pour afficher le marqueur de l'élément de liste (et non le texte du paragraphe). Valeur par défaut : "Times".
wk list start number
Définit la valeur de départ d'une liste ordonnée. Valeurs possibles :
wk auto (défaut) : la valeur de départ dépend des éléments de liste précédents s'il y en a.
valeur entière : valeur de départ
wk list string format LTR
Marqueur d'élément de liste pour les paragraphes gauche à droite. Si défini, remplace le marqueur d'élément de la liste.
Pour les listes non ordonnées : chaîne utilisée en tant que marqueur d'élément de liste (généralement un seul caractère, par exemple"-")
Pour les listes ordonnées : chaîne contenant le caractère "#". "#" est un caractère d'emplacement pour le nombre ou la lettre calculé(e). Par défaut “#.”, donc par exemple si le numéro d'élément courant de la liste est 15 et que le type de style de liste est décimal, la chaîne du marqueur d'élément de liste sera "15."
wk list string format RTL
Marqueur d'élément de liste pour les paragraphes droite à gauche. Si défini, remplace le marqueur d'élément de la liste.
Pour les listes non ordonnées : chaîne utilisée en tant que marqueur d'élément de liste (généralement un seul caractère, par exemple"-")
Pour les listes ordonnées : chaîne contenant le caractère "#". "#" est un caractère d'emplacement pour le nombre ou la lettre calculé(e). Par défaut “#.”, donc par exemple si le numéro d'élément courant de la liste est 15 et que le type de style de liste est décimal, la chaîne du marqueur d'élément de liste sera "15."
wk list style image
Définit une image comme marqueur d'élément de liste dans une liste non ordonnée. Valeurs possibles :
wk none (défaut) : le marqueur d'élément de liste n'est pas une image
URL d'image (chaîne). Peut être absolu ou relatif au fichier de structure.
Valeur retournée (WP GET ATTRIBUTES) : URI (URL réseau ou URI de données). Cette valeur peut ne pas être égale à l'URL initial pour une image non référencée par un URL réseau (seuls les URLs réseau sont conservés). Pour les URLs de fichiers locaux, le flux d'image (stream) lui-même est conservé dans le document et donc l'URL retourné est un URI de données avec le flux d'image encodé en base64.
wk list style image height
Définit la hauteur d'une image utilisée comme marqueur d'élément de liste. Valeurs possibles :
wk auto (défaut) : utilise la hauteur courante de l'image
Taille définie : valeur de type réel ou chaîne
Réel : Taille en wk layout unit.
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres. Valeur minimum : 0pt, valeur maximum : 10000pt.
wk list style type
Spécifie le type de marqueur d'élément d'une liste ordonnée ou non ordonnée. Valeurs possibles :
wk disc (défaut)
wk circle
wk square
wk decimal : 1 2 3
wk decimal leading zero : 01 02 03
wk lower latin : a b c
wk lower roman : i ii iii iv
wk upper latin : A B C
wk upper roman : I II III IV
wk lower greek : alpha, beta, gamma, etc.
wk armenian
wk georgian
wk hebrew
wk hiragana
wk katakana
wk cjk ideographic
wk hollow square
wk diamond
wk club
wk decimal greek
wk custom : par défaut, liste non ordonnée avec "-" comme marqueur d'élément de liste ; il s'agit d'un style pratique permettant de personnaliser un marqueur d'élément de liste avec wk list string format LTR ou wk list string format RTL sans devoir modifier les marqueurs de liste standard
Les marges sont les zones situées au-delà de la bordure d'un élément. Elles sont transparentes. Le schéma suivant illustre les diverses parties qui peuvent être configurées :
Les attributs de marge s'appliquent aux éléments suivants :
Documents
Paragraphes
Caractères
Images
X
X
X
Constante
Comment
wk inside
Lorsque la zone sélectionnée contient plusieurs paragraphes, définit que l'attribut doit être appliqué uniquement sur la propriété inter-paragraphes correspondante (et pas à l'extérieur). Peut être utilisé avec les attributs de bordures, padding ou marges, et doit être ajouté à l'attribut spécifié. Voir exemple 2 de la commande WP SET ATTRIBUTES.
wk margin
Définit la taille de toutes les marges de l'élément. Valeurs possibles :
Taille exprimée par une valeur de type entier ou chaîne :
Entier : taille en wk layout unit.
Chaîne : chaîne CSS avec la valeur et l'unité concaténées. Ex. : 12pt pour 12 points ou 1.5cm pour 1,5 centimètres
wk none (défaut) : pas de marge spécifique
wk margin bottom
Définit la taille de la marge basse de l'élément. Valeurs possibles :
Taille exprimée par une valeur de type entier ou chaîne :
Entier : taille en wk layout unit.
Chaîne : chaîne CSS avec la valeur et l'unité concaténées. Ex. : 12pt pour 12 points ou 1.5cm pour 1,5 centimètres
wk none (défaut) : pas de marge spécifique
wk margin left
Définit la taille de la marge gauche de l'élément. Valeurs possibles :
Taille exprimée par une valeur de type entier ou chaîne :
Entier : taille en wk layout unit.
Chaîne : chaîne CSS avec la valeur et l'unité concaténées. Ex. : 12pt pour 12 points ou 1.5cm pour 1,5 centimètres
wk none (défaut) : pas de marge spécifique
wk margin right
Définit la taille de la marge droite de l'élément. Valeurs possibles :
Taille exprimée par une valeur de type entier ou chaîne :
Entier : taille en wk layout unit.
Chaîne : chaîne CSS avec la valeur et l'unité concaténées. Ex. : 12pt pour 12 points ou 1.5cm pour 1,5 centimètres
wk none (défaut) : pas de marge spécifique
wk margin top
Définit la taille de la marge haute de l'élément. Valeurs possibles :
Taille exprimée par une valeur de type entier ou chaîne :
Entier : taille en wk layout unit.
Chaîne : chaîne CSS avec la valeur et l'unité concaténées. Ex. : 12pt pour 12 points ou 1.5cm pour 1,5 centimètres
wk none (défaut) : pas de marge spécifique
wk outside
Lorsque la zone sélectionnée contient plusieurs paragraphes, définit que l'attribut doit être appliqué uniquement sur la propriété de paragraphe externe correspondante (et pas à l'intérieur). Peut être utilisé avec les attributs de bordures, padding ou marges, et doit être ajouté à l'attribut spécifié. Voir exemple 2 de la commande WP SET ATTRIBUTES.
Les marges intérieures (Padding) sont l'espace blanc entre le contenu de l'élément et sa bordure. Les marges intérieures sont affectées par la couleur de fond de l'élément.
Le schéma suivant illustre les diverses parties qui peuvent être configurées :
Les attributs de marge intérieure s'appliquent aux éléments suivants :
Documents
Paragraphes
Caractères
Images
X
X
X
Constante
Comment
wk inside
Lorsque la zone sélectionnée contient plusieurs paragraphes, définit que l'attribut doit être appliqué uniquement sur la propriété inter-paragraphes correspondante (et pas à l'extérieur). Peut être utilisé avec les attributs de bordures, padding ou marges, et doit être ajouté à l'attribut spécifié. Voir exemple 2 de la commande WP SET ATTRIBUTES.
wk outside
Lorsque la zone sélectionnée contient plusieurs paragraphes, définit que l'attribut doit être appliqué uniquement sur la propriété de paragraphe externe correspondante (et pas à l'intérieur). Peut être utilisé avec les attributs de bordures, padding ou marges, et doit être ajouté à l'attribut spécifié. Voir exemple 2 de la commande WP SET ATTRIBUTES.
wk padding
Définit la taille de la marge intérieure (padding) pour tous les côtés de l'élément. Valeurs possibles :
Taille exprimée par une valeur de type entier ou chaîne :
Entier : Taille en wk layout unit.
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres.
wk none (défaut) : pas de marge intérieure spécifique
wk padding bottom
Définit la taille de la marge intérieure (padding) pour le bas de l'élément. Valeurs possibles :
Taille exprimée par une valeur de type entier ou chaîne :
Entier : Taille en wk layout unit.
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres.
wk none (défaut) : pas de marge intérieure spécifique
wk padding left
Définit la taille de la marge intérieure (padding) pour la gauche de l'élément. Valeurs possibles :
Taille exprimée par une valeur de type entier ou chaîne :
Entier : Taille en wk layout unit.
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres.
wk none (défaut) : pas de marge intérieure spécifique
wk padding right
Définit la taille de la marge intérieure (padding) pour la droite de l'élément. Valeurs possibles :
Taille exprimée par une valeur de type entier ou chaîne :
Entier : Taille en wk layout unit.
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres.
wk none (défaut) : pas de marge intérieure spécifique
wk padding top
Définit la taille de la marge intérieure (padding) pour le haut de l'élément. Valeurs possibles :
Taille exprimée par une valeur de type entier ou chaîne :
Entier : Taille en wk layout unit.
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres.
wk none (défaut) : pas de marge intérieure spécifique
Les attributs de paragraphe permettent de définir les propriétés d'organisation du texte dans les paragraphes. Ils s'appliquent aux éléments suivants :
Documents
Paragraphes
Caractères
Images
X
Constante
Comment
wk direction
Définit le sens du paragraphe. Valeurs possibles :
wk left to right (défaut)
wk right to left
wk line height
Définit l'espacement entre les lignes. Valeurs possibles :
wk normal (défaut) : utiliser une valeur basée sur la taille du texte.
Hauteur exprimée par une valeur de type entier ou chaîne :
Entier : height in wk layout unit.
Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres. Il est possible de passer une valeur relative (pourcentage %).
wk tab stop offsets
Définit les tabulations pour le paragraphe. Valeurs possibles :
Valeur fixe (défaut 35.45pt) : décalage par défaut pour tout le paragraphe. La commande WP GET ATTRIBUTES retourne le dernier décalage (qui est le décalage relatif par défaut pour les décalages définis au-delà du dernier décalage absolu).
Tableau de valeurs de tabulations : une liste ordonnée de valeurs absolue, débutant de la marge gauche. Le dernier décalage de tabulation défini est répété pour chaque nouvelle tabulation saisie dans le paragraphe. Si le décalage de tabulation est supérieur à la largeur du paragraphe, le texte passe à la ligne suivante et débute à la première tabulation. Si une valeur du tableau est plus petite que la précédente, elle est ignorée.
Note : Vous ne pouvez pas utiliser de tableau et de valeurs fixes dans le même appel pour différents attributs.
Les valeurs sont exprimées à l'aide de chaînes CSS (défaut) ou de réels dans wk layout unit. Valeur maximum : 10000pt.
wk tab stop types
Définit le type de tabulation pour le paragraphe. Valeurs possibles :
wk left (défaut) : le texte est décalé vers la droite à partir de la tabulation
wk right : le texte est décalé vers la gauche à partir de la tabulation jusqu'à ce que l'espace de la tabulation soit rempli.
wk center : le texte est centré sur la tabulation
wk decimal : le texte avant le point décimal est décalé vers la gauche, le texte après le point décimal est décalé vers la droite
wk bar : affiche une barre verticale à l'emplacement spécifié.
tableau de valeurs de types de tabulations (si les tabulations ont été définies via un tableau)
wk text align
Définit l'alignement horizontal du texte dans le paragraphe. Valeurs possibles :
wk left (défaut)
wk right
wk justify
wk center
wk text indent
Définit l'indentation de la première ligne du paragraphe. Valeurs possibles :
Réel : Taille en wk layout unit. Défaut : 0
Chaîne : Chaîne CSS avec valeur et unité concaténées. Ex. : 12pt pour 12 points, ou 1.5cm pour 1,5 centimètres. Valeur minimum : 0pt, valeur maximum : 10000pt.
wk vertical align
Définit l'alignement vertical d'un élément. Peut être utilisé avec les caractères, les paragraphes et les images. Valeurs possibles :
wk baseline (défaut) : aligne la base de l'élément avec la base de l'élément parent
wk top : aligne le haut de l'élément avec le haut de l'élément le plus grand sur la ligne
wk bottom : aligne le bas de l'élément avec le bas de l'élément le plus bas sur la ligne
wk middle : aligne l'élément au milieu de l'élément parent
wk superscript : aligne l'élément comme s'il était en exposant
wk subscript : aligne l'élément comme s'il était en indice
Pour les caractères, wk top et wk bottom ont le même effet que wk baseline. Pour les paragraphes, wk baseline, wk superscript et wk subscript ont le même effet que wk top.
Attributs 4D Write Pro
