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 :
Vous pouvez également manipuler les attributs des zones 4D Write Pro via la notation objet ou les commandes 4D génériques :
- Notation objet - par exemple, vous pouvez utiliser l'une ou l'autre des instructions suivantes :
$bcol:=$range[wk background color]
$bcol:=$range.backgroundColor //same results
$bcol:=OB Get($range;wk background color)
Les attributs de fond (background) permettent de définir des effets d'arrière-plan dans vos documents. Ces attributs s'appliquent aux cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X | X | X | X | X | 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 paper box : le fond est jusqu'au bord du document ou de la section
|
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 RGB COLORS)
- 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 display mode | Définit le mode d'affichage des images utilisées comme arrière-plan, sur la base d'un préréglage des valeurs d'attribut "réelles" suivantes : wk background origin, wk background repeat, [#cst id= "3513252"/], wk background position vertical, wk background width, wk background height Valeurs possibles : - wk scaled to fit
- wk truncated
- wk truncated centered
- wk proportional
- wk proportional centered
- wk replicated (par défaut)
- wk replicated centered
Note : Le rectangle d'origine est défini sur la zone de padding (le rectangle de l'image qui inclut la zone de padding mais qui exclut la zone de bordure). Lorsque vous obtenez la valeur de cet attribut, la valeur retournée est soit : - l'un des modes d'affichage possibles, par exemple wk replicated, si tous les attributs réels ont les valeurs prédéfinies pour ce mode
- "personnalisée" si au moins la valeur d'un attribut réel diffère des valeurs prédéfinies pour n'importe quel mode. Par exemple, si la valeur prédéfinie de wk background width est modifiée après l'application de wk background display mode, WP GET ATTRIBUTES) retourne "personnalisée" au moment d'obtenir la valeur de wk background display mode.
|
wk background height | 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 %).
|
wk background image | Définit une référence d'image à utiliser en fond. Peut être toute expression ou variable image 4D valide.
- Valeur retournée (WP GET ATTRIBUTES)) : si l'image avait été définie via un URL résau, l'image cible est retournée si elle a déjà été chargée, sinon une image vide est retournée.
Utilisez wk background image url si vous souhaitez gérer des images via des URLs ou des URIs locaux. |
wk background image url | Image de fond définie via un URL (chaîne). Peut être un URL réseau ou un data URI, absolu ou relatif au fichier de structure.
- Valeur retournée (WP GET ATTRIBUTES)) : URL réseau ou URI de donnée. 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.
Utilisez wk background image pour gérer des images de fond via des expressions image. |
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 paper box : l'image de fond débute au bord du document ou de la section
|
wk background position horizontal | 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 vertical | 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 width | 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 %).
|
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 | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X | X | X | X | X | 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 RGB COLORS)
- 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 RGB COLORS)
- 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 RGB COLORS)
- 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 RGB COLORS)
- 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 RGB COLORS)
- 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 numérique ou chaîne :
Numérique : 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 outset : bordure biseau 3D inversé (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 outset : bordure biseau 3D inversé (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 outset : bordure biseau 3D inversé (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 outset : bordure biseau 3D inversé (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 outset : bordure biseau 3D inversé (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 numérique ou chaîne :
Numérique : 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 numérique ou chaîne :
Numérique : 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 numérique ou chaîne :
Numérique : 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 numérique ou chaîne :
Numérique : 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 numérique ou chaîne :
Numérique : 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 d'informations du document sont utilisés pour fixer ou lire des des paramètres ou des informations relatives au document. Ces attributs s'appliquent aux éléments suivants :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | | | | | | | | |
Informations du document
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. A noter que cette valeur est mise à jour dynamiquement chaque fois que le contenu du document est modifié, mais pas lorsque le document est ouvert ou sauvegardé. |
wk dpi | DPI utilisés pour la conversion interne pixels <->points (entier). Toujours 96 (lecture seulement) Ne pas confondre cet attribut interne avec l'action standard "dpi" qui permet de modifier ou de lire les DPI de la vue courante du document. |
wk modified | Indique si le document a été modifié depuis la création de son objet associé (voir ci-dessous). Valeurs possibles : - True - le document a été modifié
- False - le document n'a pas été modifié (valeur par défaut lorsque l'objet est créé)
Cette propriété est toujours mise à false lorsque l'objet contenant le document est créé (c'est-à-dire avec WP Import document, WP New, une copie d'objet ou lorsque le champ/attribut objet est chargé depuis la base de données). Il est automatiquement mis à true par 4D Write Pro dès qu'une modification est apportée au contenu du document, quelle que soit l'origine de la modification (action de l'utilisateur ou programmation). Notes: - Une nouvelle valeur évaluée à partir d'une formule ou une nouvelle image chargée depuis une URL n'est pas considérée comme une modification du document (la chaîne source reste intacte).
- Une fois mise à true par 4D Write Pro, cette propriété n'est jamais automatiquement remise à false, même si une action "undo" ou "export" est exécutée. Cependant, comme il s'agit d'une propriété en lecture-écriture, elle peut être fixée par votre code.
- Contrairement à wk date modified, wk modified est volatile, c'est-à-dire qu'elle n'est pas stockée dans le document.
|
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éro peut uniquement être lu par la commande WP GET ATTRIBUTES), il ne peut pas être fixé. |
Paramètres du document
Constante | Comment |
---|
wk break paragraphs in formulas | Définit si les retours chariots retournés par des formules sont traités comme des sauts de paragraphe. Valeurs possibles : - wk true - Interprété comme saut de paragraphe
- wk false - (valeur par défaut) Interprété comme saut de ligne
Note : Si une formule utilise This.pageNumber ou This.pageCount, l'attribut est ignoré, les retours chariots sont toujours interprétés commes des sauts de ligne. |
wk tab decimal separator | Caractère utilisé comme séparateur décimal par les tabulations décimales (voir wk tabs). Valeurs possibles : - wk point or comma : utilise la première virgule ou le premier point de droite (par défaut pour les nouveaux documents vierges)
- wk point : utilise le caractère point
- wk comma : utilise le caractère virgule
- wk system : utilise le séparateur décimal comme retourné par GET SYSTEM FORMAT (par défaut pour les anciens documents 4D Write importés)
|
Police et texte
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 | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X* | X* | X* | X* | X* | X* | X* | X* | |
*Appliqué aux caractères des paragraphes dans les éléments
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 default | Objet définissant la ou les polices par défaut de substitution du document (i.e. les polices qui remplacent celles qui ne sont pas disponibles dans le système d'exploitation). Il contient : Propriété | Type | Description | default | Chaine | Collection | Police(s) de substitution à utiliser par défaut si une police n'est pas prise en charge par le système d'exploitation, indépendamment de la plateforme | windows | Chaine | Collection | Police(s) de substitution à utiliser par défaut sur la plateforme Windows (avant "default", si défini) | mac | Chaine | Collection | Police(s) de substitution à utiliser par défaut sur la plateforme macOS (avant "default", si défini) | Notes : - Chaque propriété peut contenir une chaine (ex : "Arial") ou une collection de chaines (ex : ["Arial","sans-serif"]). Les noms de police doivent être une famille de polices ou "sans-serif", "serif", "monospace", "cursive" ou "fantasy" pour cibler la famille de police générique, comme dans html/css font-family.
- Par défaut, si wk font default n'est pas défini, ou si aucune des polices définies n'est disponible sur une plateforme, la police de substitution est déléguée au système d'exploitation.
|
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 RGB COLORS)
- 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 RGB COLORS)
- 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 RGB COLORS)
- 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 RGB COLORS)
- 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 éléments. Ces attributs s'appliquent aux éléments suivants :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X | X | X* | X | X | | | |
*Appliqué aux cellules
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). |
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 : Cet attribut n'est pas pris en charge par les colonnes, les lignes et les cellules. |
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. |
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). |
Les attributs Image permettent de gérer les images insérées dans la zone ou ajoutées dans la page. Ils s'appliquent aux cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X* | X* | X* | | | | | |
*Appliqué aux images dans les cellules (images insérées dans le texte uniquement)
Rappel : Comme indiqué dans la section Manipuler des images, 4D Write Pro prend en charge deux types d'images :
Les attributs suivants sont disponibles aussi bien pour les images insérées que pour les images ancrées :
Constante | Comment |
---|
wk image | Définit une référence d'image. Peut être toute expression ou variable image 4D valide.
- Valeur retournée (WP GET ATTRIBUTES)) : si l'image avait été définie via un URL résau, l'image cible est retournée si elle a déjà été chargée, sinon une image vide est retournée.
Utilisez wk image url si vous souhaitez gérer des images via des URLs ou des URIs locaux. |
wk image alternate text | Définit un texte alternatif à l'image, si elle ne peut pas être affichée. |
wk image display mode | Définit le mode d'affichage des images ancrées et des images en ligne. Valeurs possibles : - wk scaled to fit (par défaut)
- wk truncated
- wk truncated centered
- wk proportional
- wk proportional centered
- wk replicated
- wk replicated centered
Note : Les rectangles d'origine et de découpage sont toujours définis sur la zone de contenu (le rectangle de l'image, à l'exclusion de la zone de padding et de bordure). Utilisez wk background display mode si vous souhaitez définir le mode d'affichage des images utilisées comme arrière-plan. |
wk image url | Image définie via un URL (chaîne). Peut être un URL réseau ou un data URI, absolu ou relatif au fichier de structure.
- Valeur retournée (WP GET ATTRIBUTES)) : URL réseau ou URI de donnée). 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.
Utilisez wk image pour gérer des images via des expressions image. |
wk owner | (Attribut en lecture seule) Possesseur de la plage. Valeur : objet |
wk type | Type d'objet 4D Write Pro. Valeurs possibles : - wk type default : Plage ou section sans type défini
- wk type paragraph : Plage de type paragraphe
- wk type image : Image (ancrée et en ligne)
- wk type container : En-tête ou pied, par exemple
- wk type table : Référence de tableau
Pour les plages de cellules, de colonnes et de lignes uniquement : - wk type table row : Référence de ligne de tableau
- wk type table cell : Référence de cellule de tableau
- wk type table column : Référence de colonne de tableau
Pour les sous-sections uniquement : - wk first page : Sous-section de la première page
- wk right page : Sous-section de la page de droite
- wk left page : Sous-section de la page de gauche
Pour les tabulations uniquement, valeur utilisée dans l'objet pour wk tab default ou dans les objets de la collection pour wk tabs : - wk left : Aligne la tabulation à gauche
- wk right : Aligne la tabulation à droite
- wk center : Aligne la tabulation au centre
- wk decimal : Aligne la tabulation à la décimale
- wk bar : Insère une barre verticale au niveau de la tabulation
|
Les attributs suivants sont disponibles pour les images insérées uniquement :
Constante | Comment |
---|
wk end | (Attribut de plage en lecture seule) Position fin de plage. Valeur : entier long |
wk start | (Attribut de plage en lecture seule) Position début de plage. Valeur : entier long |
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 suivants sont disponibles pour les images ancrées uniquement :
Constante | Comment |
---|
wk anchor horizontal align | Définit l'alignement horizontal d'une image relativement à l'origine (voir wk anchor origin). Valeurs possibles :
- wk left - alignement à gauche
- wk center - alignement au centre (non compatible HTML, image non affichée sur le web)
- wk right - alignement à droite
|
wk anchor horizontal offset | Définit le décalage horizontal d'une image exprimé en dimension CSS de type chaîne ou entier long (cm ou pt ou pixel) dans l'unité wk layout unit. Valeurs possibles :
- Limite gauche ou droite de l'image relativement à wk anchor horizontal align
- Limite gauche ou droite du corps (body) en mode inclus (si wk anchor section = wk anchor embedded)
Valeur par défaut = 0. |
wk anchor layout | Définit la position relative d'une image par rapport au texte ou à la page. Valeurs possibles : - wk behind text - l'image ou la zone de texte est ancrée derrière le texte
- wk in front of text - l'image ou la zone de texte est ancrée devant le texte
- wk text wrap top bottom - l'image ou la zone de texte est ancrée avec le texte enveloppé au-dessus et au-dessous de l'image ou de la zone de texte avec des côtés vides à sa gauche et à sa droite
- wk text wrap square - l'image ou la zone de texte est ancrée avec le texte enveloppé tout autour de l'image ou de la zone de texte
- wk text wrap square left - l'image ou la zone de texte est ancrée avec le texte enveloppé à gauche de l'image ou de la zone de texte
- wk text wrap square right - l'image ou la zone de texte est ancrée avec le texte enveloppé à droite de l'image ou de la zone de texte
- wk text wrap square largest - l'image ou la zone de texte est ancrée avec le texte enveloppé sur le côté le plus large de l'image ou de la zone de texte
- wk inline with text - l'image est insérée dans le texte (position par défaut pour les images insérées avec WP INSERT PICTURE). Cet attribut est en lecture seule (les images dans le texte ne peuvent pas être converties en images ancrées par programmation).
|
wk anchor origin | Définit si l'image est ancrée dans la page, l'en-tête ou le pied. Valeurs possibles :
- wk paper box (défaut) - l'image est ancrée en bordure de page
- wk header box - l'image est ancrée dans l'en-tête du document. Si l'en-tête n'est pas visible, l'image n'est pas affichée.
- wk footer box - l'image est ancrée dans le pied du document. Si le pied n'est pas visible, l'image n'est pas affichée.
Ce sélecteur est ignoré en mode inclus. |
wk anchor page | Définit le numéro de page ou le type de page où l'image est ancrée. Valeurs possibles : - wk anchor all - l'image est ancrée dans toutes les pages de la ou des section(s) définie(s) par wk anchor section
- wk anchor first page - l'image est ancrée dans la première sous-section de la page de la ou des section(s) définie(s) par wk anchor section
- wk anchor left page - l'image est ancrée dans la sous-section de la page gauche de la ou des section(s) définie(s) par wk anchor section
- wk anchor right page - l'image est ancrée dans la sous-section de la page droite de la ou des section(s) définie(s) par wk anchor section
- valeur numérique (entier long >= 0) - indique le numéro de la page dans laquelle l'image est ancrée. Dans ce cas, wk anchor section = wk anchor all. L'ancrage de section est ignoré si une image est ancrée dans une seule page.
Note : Les images en mode Page ne sont pas affichées dans les navigateurs. |
wk anchor section | Définit le numéro de section ou le type de section où l'image est ancrée. Valeurs possibles :- wk anchor all (par défaut) - l'image est ancrée dans toutes les sections du document (l'image est visible uniquement en mode page)
- wk anchor embedded - l'image est ancrée au corps (body) du document en mode inclus (l'image est visible uniquement en mode inclus).
- valeur numérique (entier long >= 1) - indique le numéro de la section dans laquelle l'image est ancrée (l'image est visible uniquement en mode page).
Note : Les images en mode Page ne sont pas affichées dans les navigateurs. |
wk anchor vertical align | Définit l'alignement vertical d'une image relativement à l'origine (voir wk anchor origin). Valeurs possibles :- wk top - alignement en haut
- wk center - alignement au centre (non compatible HTML, image non affichée sur le web)
- wk bottom - alignement en bas
|
wk anchor vertical offset | Définit le décalage vertical d'une image exprimé en dimension CSS de type chaîne ou nombre (cm ou pt ou pixel) dans l'unité wk layout unit. Valeurs possibles :
- Haut, centre ou bas de la page (voir wk anchor horizontal align)
- Haut, centre ou bas du corps (body) en mode inclus (si wk anchor section = wk anchor embedded)
Valeur par défaut = 0. |
wk id | ID interne de l'élément. Valeur : Chaîne |
wk image expression | Image ancrée définie via une expression 4D.
Note :
- Si l'expression ne peut pas être évaluée ou si elle ne retourne pas une image 4D valide, un symbole d'image non chargée sera affiché (image vide avec cadre noir).
- Si l'attribut est fixé à " " ou utilisé avec WP RESET ATTRIBUTES), l'expression sera supprimée et l'image ne sera plus définie par elle. Effectuer cette opération avant que l'image ait été calculée produit une image vide.
|
wk image formula | Image ancrée définie via un objet formule 4D.
Note : - Si la formule ne peut pas être évaluée ou si elle ne retourne pas une image 4D valide, un symbole d'image non chargée sera affiché (image vide avec cadre noir).
- Si l'attribut est fixé à Null ou utilisé avec WP RESET ATTRIBUTES), la formule sera supprimée et l'image ne sera plus définie par elle. Effectuer cette opération avant que l'image ait été calculée produit une image vide.
|
Les attributs de configuration définissent le formatage des colonnes, sections, sous-sections ou des pages dans le document. Ils peuvent être appliqués aux cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X | | | | | | | |
Note : Les documents en mode intégré utilisent les attributs wk margin (voir Marge ci-dessous). En mode page, les documents, sections et sous-sections utilisent les attributs wk page margin.
Constante | Comment |
---|
wk column count | (Disponible pour les tableaux, les documents les sections) Nombre de colonnes. Type de valeur : Entier long
- Pour un tableau : attribut en lecture seulement
- Pour un document ou une section : attribut en lecture/écriture. Valeur par défaut=1 (colonne unique). Valeur maximum=20
|
wk column rule color | Couleur du séparateur (trait) de colonne vertical. Valeurs possibles :
- une couleur CSS ("#010101" ou "#FFFFFF" ou "red"). Valeur par défaut : "#000000" (black)
- une valeur entier long de couleur 4D (voir commande OBJECT SET RGB COLORS)
- un tableau entier long contenant un élément pour chaque composante R, V, B (0-255)
|
wk column rule style | Style du séparateur (trait) de colonne vertical. Valeurs possibles :
- wk none (défaut) : pas de séparateur
- wk hidden : équivaut à wk none, sauf en résolution de conflit
- wk solid : ligne pleine
- wk dotted : ligne en pointillés
- wk dashed : ligne en tirets
- wk double : ligne double
- wk groove : ligne relief 3D (l'effet réel dépend de la couleur de la ligne)
- wk ridge : ligne relief 3D inversé (l'effet réel dépend de la couleur de la ligne)
- wk inset : ligne biseau 3D (l'effet réel dépend de la couleur de la ligne)
|
wk column rule width | Largeur du séparateur de colonne vertical. Valeurs possibles :
- Réel : largeur en wk layout unit.
- Chaîne : Chaîne CSS avec valeur et unité concaténées (e.g.: "12pt" pour 12 points ou "1.5cm" pour 1,5 centimètres). Valeur par défaut="2.5pt"
|
wk column spacing | (Documents ou sections uniquement) Espacement entre deux colonnes. Valeurs possibles :
- Réel : largeur en wk layout unit
- Chaîne : Chaîne CSS avec valeur et unité concaténées (e.g.: "12pt" pour 12 points ou "1.5cm" pour 1,5 centimètres).
Valeur par défaut="12pt"
|
wk column width | (Documents ou sections uniquement) Attribut en lecture seulement. Largeur courante de chaque colonne, i.e. largeur calculée basée sur la largeur de la page, les marges de la page, le nombre de colonnes et l'espacement entre colonnes. Pour le document, le calcul utilise la largeur de la section par défaut, et peut donc être différent de la largeur réelle des colonnes de section(s) si certains attributs sont surchargés dans une section. Valeurs possibles :
- Réel : largeur en wk layout unit.
- Chaîne : Chaîne CSS avec valeur et unité concaténées (e.g.: "12pt" pour 12 points ou "1.5cm" pour 1,5 centimètres).
|
wk header and footer autofit | Indique si la hauteur des en-têtes et des pieds du document 4D Write Pro est redimensionnée automatiquement pour éviter de tronquer leur contenu. Valeurs possibles : - wk true (par défaut pour les documents de 4D Write Pro)
- wk false (par défaut pour les documents de 4D Write convertis)
|
wk layout unit | Définit l'unité de dimension par défaut du document lorsqu'une valeur numérique est écrite ou lue. Désigne l'unité de la règle et des attributs de dimension tels que wk width, à l'exception de wk font size, wk border width (et ses variantes), wk border radius et wk text shadow offset pour lesquels l’unité de valeur numérique est toujours le point. 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
Note : Lorsqu'une unité non prise en charge par la règle est sélectionnée via cet attribut (i.e. wk unit px ou wk unit percent), la règle utilise alors l'unité cm. |
wk page first number | Numéro de page de la première page de la section ou du document (lecture seule avec les sous-sections). Valeurs possibles : toute valeur entière >=1 |
wk page first right | La première page du document est une page de droite (lecture seule pour les sections ou sous-sections). Valeurs possibles :
true (défaut) : le document commence sur une page de droite false : le document commence sur une page de gauche
|
wk page height | Hauteur de page (en mode page) exprimée à l'aide d'une valeur de type réel ou chaîne (lecture seule pour les sections ou les sous-sections). Valeurs possibles :
- Réel : Hauteur en wk layout unit.
- Chaîne : chaîne CSS avec valeur et unité concaténées (ex: "12pt" pour 12 points, ou "1.5cm" for 1.5 centimètres). Unités prises en charge : pt,cm,mm, pouces.
|
wk page margin | Taille de toutes les marges de la page (mode page). Par défaut 2.5cm. Valeurs possibles :
- 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). Unités prises en charge : pt, cm, mm, px, pouces.
- wk none : pas de marge spécifique.
|
wk page margin bottom | Taille des marges bas de la page (mode page). Valeurs possibles :
- 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). Unités prises en charge : pt, cm, mm, px, pouces.
- wk none : pas de marge spécifique.
|
wk page margin left | Taille des marges haut de la page (mode page). Valeurs possibles :
- 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). Unités prises en charge : pt, cm, mm, px, pouces.
- wk none : pas de marge spécifique.
|
wk page margin right | Taille des toutes les marges droites de la page (mode page). Valeurs possibles :
- 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). Unités prises en charge : pt, cm, mm, px, pouces.
- wk none : pas de marge spécifique.
|
wk page margin top | Taille de toutes les marges haut de la page (mode page). Valeurs possibles :
- 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). Unités prises en charge : pt, cm, mm, px, pouces.
- wk none : pas de marge spécifique.
|
wk page orientation | Orientation de la page. Valeurs possibles :
- wk portrait (0) (défaut)
- wk landscape (1)
|
wk page size | Définit le format des pages du document (modifie les attributs wk page height et wk page width). Valeurs possibles : - Noms des formats de papier de l'imprimante.
- Formats de papier ISO standard (Les formats de papier ISO pris en charge sont les suivants : "A0" à "A10", "B0" à "B10", "C0" à "C10", "DL", "Letter", "Junior Legal", "Legal" et "Tabloïd").
- Noms de formats de papier personnalisés définis par l'utilisateur.
La priorité est donnée aux formats de papier de l'imprimante actuelle par rapport aux formats ISO. Les formats inconnus génèrent une erreur. |
wk page width | Largeur de la page (en page mode) exprimée à l'aide d'une valeur de type réel ou chaîne (lecture seule pour les sections et sous-sections). Valeurs possibles :
- Réel : Largeur 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). Unités prises en charge : pt,cm,mm, pouces.
|
Les attributs des liens sont utilisés pour définir ou lire des URLs dans les plages. Ces attributs s'appliquent aux cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X* | X | X | X | | | | |
*Images insérées dans le texte uniquement
Constante | Comment |
---|
wk link url | Lien hypertexte associé à la plage. Valeurs possibles :
- url absolu, par exemple "http://www.4d.com/"
- lien relatif, par exemple "/test/page.html" (le lien est relatif au fichier de structure de la base)
- chaîne vide = pas de lien
|
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 cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X* | X* | X* | | | | | |
*Appliqués aux paragraphes dans les cellules
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 référence d'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
- toute expression ou variable image 4D valide.
- Valeur retournée (WP GET ATTRIBUTES)) : si l'image avait été définie via un URL résau, l'image cible est retournée si elle a déjà été chargée, sinon une image vide est retournée.
Utilisez wk list style image url si vous souhaitez gérer des images via des URLs ou des URIs locaux. |
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îneRé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 image url | Image à utiliser 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
- un URL réseau ou un data URI, absolu ou relatif au fichier de structure
- Valeur retournée (WP GET ATTRIBUTES)) : URL réseau ou URI de donnée). 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.
Utilisez wk list style image pour gérer des images de marqueurs d'éléments via des expressions. |
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
- wk none
|
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 cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X | X | X | X | X | | | |
Note : Les sections et sous-sections utilisent les attributs wk page margin; Les attributs wk margin ne sont utilisés que par les documents en mode intégré (voir Configuration ci-dessus).
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 numérique ou chaîne :
Numérique : 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 numérique ou chaîne :
Numérique : 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 numérique ou chaîne :
Numérique : 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 numérique ou chaîne :
Numérique : 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 numérique ou chaîne :
Numérique : 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 | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X | X | X | X* | X* | X | X | X |
*Appliqués aux cellules
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 numérique ou chaîne :
Numérique : 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 numérique ou chaîne :
Numérique : 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 numérique ou chaîne :
Numérique : 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 numérique ou chaîne :
Numérique : 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 numérique ou chaîne :
Numérique : 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 cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X* | X* | X* | X* | X* | | | |
*Appliqués aux paragraphes dans les cellules
Constante | Comment |
---|
wk avoid widows and orphans | Active ou désactive le contrôle des veuves et des orphelines. Lorsqu'il est activé, 4D Write Pro n'autorise pas de veuves (dernière ligne d'un paragraphe isolée en haut d'une page) ou d'orphelines (première ligne d'un paragraphe isolée en bas d'une page) dans un document. Valeurs possibles :- wk true (défaut): le contrôle des veuves et des orphelines est activé
- wk false: le contrôle des veuves et des orphelines est désactivé (les lignes isolées sont possibles)
- wk mixed: retourné lors de la lecture de l'attribut si valeurs différentes
|
wk direction | Définit le sens du paragraphe. Valeurs possibles :
- wk left to right (défaut)
- wk right to left
|
wk id | ID interne de l'élément. Valeur : Chaîne |
wk keep with next | Relie un paragraphe au suivant de sorte qu'ils ne puissent pas être séparés par des sauts de page ou de colonne automatiques. Si cette option est appliquée à une cible qui n'est pas un paragraphe, elle s'applique aux paragraphes à l'intérieur de la cible. Valeurs possibles : - true - Le paragraphe est lié au paragraphe suivant
- false - (par défaut) Le paragraphe n'est pas relié au paragraphe suivant.
Si un saut est ajouté manuellement entre deux paragraphes liés, cet attribut est ignoré. Si cet attribut est appliqué au dernier paragraphe de la dernière cellule d'un tableau, la dernière ligne du tableau est liée au paragraphe suivant. |
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 numérique ou chaîne :
Numérique : hauteur en 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 page break inside paragraph | Contrôle la fonction de saut de page automatique à l'intérieur des paragraphes. Cette constante s'applique : - à tous les paragraphes à l'intérieur de la cible
- au(x) paragraphe(s) parent(s) lorsque la cible est une plage de texte.
Valeurs possibles : - wk auto (par défaut) : aucune contrainte concernant les sauts de page à l'intérieur du paragraphe/tableau.
- wk avoid : empêche le paragraphe d'être divisé en plusieurs parties sur deux pages ou plus (si possible).
|
wk tab default | Objet contenant les attributs de la tabulation par défaut de la cible (ex : paragraphe, corps, etc.). Les attributs de la tabulation par défaut incluent : Propriété | Type | Description | wk type | Entier long | Alignement de la tabulation (wk left, wk right, wk center, wk decimal, wk bar). | wk offset | Entier long | Position de la tabulation. La valeur doit être supérieure à 0. | wk leading | Chaîne | Caractère de conduite pour la tabulation. | Note : Si vous souhaitez créer un raccourci pour la définition de la position, passez directement une valeur numérique dans l'unité courante (ex : 1.5) ou une valeur de texte CSS (ex : "3cm"). 4D créera automatiquement l'objet tabulation. |
wk tab stop leadings | NOTE DE COMPATIBILITE : Bien que ce sélecteur soit maintenu pour des raisons de compatibilité, il est recommandé d'utiliser wk tab default ou wk tabs. Définit les caractères de conduite pour les tabulations dans les plages de paragraphes. Valeurs possibles : Propriété synchronisée avec les tableaux wk tab stop offsets et wk tab stop types. |
wk tab stop offsets | NOTE DE COMPATIBILITE : Bien que ce sélecteur soit maintenu pour des raisons de compatibilité, il est recommandé d'utiliser wk tab default ou wk tabs. Définit les tabulations pour la cible. Valeurs possibles : - Tableau de valeurs de tabulations
NOTE DE COMPATIBILITE : Antérieurement, la dernière valeur de tabulation définie dans le tableau était celle de la tabulation par défaut (et non pas une valeur absolue). A compter de 4D v17 R5, la dernière valeur est une valeur absolue (et non pas la valeur par défaut). Utilisez wk tab default pour définir la valeur de la tabulation par défaut. - Valeur scalaire
Les valeurs sont exprimées à l'aide de chaînes CSS (défaut) ou de réels dans wk layout unit. Valeur maximum : 10000pt. Si des tableaux sont utilisés, cette propriété est synchronisée avec les tableaux wk tab stop leadings et wk tab stop types. |
wk tab stop types | NOTE DE COMPATIBILITE : Bien que ce sélecteur soit maintenu pour des raisons de compatibilité, il est recommandé d'utiliser wk tab default ou wk tabs. Définit le type de tabulation pour le paragraphe. Valeurs possibles : - tableau de valeurs de types de tabulations (si les tabulations ont été définies via un tableau)
- wk left (défaut)
- wk right
- wk center
- wk decimal
- wk bar
Cette propriété est synchronisée avec les tableaux wk tab stop offsets et wk tab stop leadings. |
wk tabs | Collection d'objets tabulation. Chaque objet tabulation contient l'un ou plusieurs des attributs suivants : Propriété | Type | Description | wk type | Entier long | Alignement de la tabulation (wk left, wk right, wk center, wk decimal, wk bar). | wk offset | Entier long | Position de la tabulation. La valeur doit être supérieure à 0. | wk leading | Chaîne | Caractère de conduite de la tabulation. | Note : Si vous souhaitez créer un raccourci pour la définition de la position, passez directement une valeur numérique dans l'unité courante (ex : 1.5) ou une valeur de texte CSS (ex : "3cm") comme un élément collection. 4D créera automatiquement l'objet tabulation. Une collection vide est retournée par la commande WP GET ATTRIBUTES) si la cible : - contient des valeurs de tabulations hétérogènes, ou
- ne contient pas de valeurs absolues.
|
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, les images, les tableaux, les lignes de tableaux et les colonnes/cellules de tableaux. 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. Pour les tableaux, lignes de tableaux et colonnes/cellules de tableaux, seules les valeurs wk top, wk bottom et wk middle sont prises en charge. |
Le statut de lecture/écriture d'une cible 4D Write Pro peut être défini à l'aide de l'attribut wk protected. Définir une cible comme étant protégée la rend non modifiable, une fois que la protection est activée dans tout le document (à l'aide de l'attribut wk protection enabled). Tant que la protection globale n'est pas activée, les cibles peuvent encore être modifiées à l'aide de l'attribut wk protected.
L'attribut suivant permet de gérer la protection globale d'un document. Il s'applique aux cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | | | | | | | | |
Constante | Comment |
---|
wk protection enabled | Active ou désactive le statut de protection (lecture/écriture) d'un document 4D Write Pro. Valeurs possibles : - wk true - Protection activée. Les éléments ciblés et protégés du document ne peuvent pas être modifiés.
- wk false - Protection désactivée. (par défaut) Tous les éléments ciblés du document peuvent être modifiés.
|
L'attribut suivant permet de gérer le statut de protection d'un contenu spécifique. Il s'applique aux cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X | X | X | X | X | X | X | X |
Constante | Comment |
---|
wk protected | Définit le statut de protection lecture/écriture d'une cible 4D Write Pro (à l'exception des feuilles de style). Valeurs possibles : - wk true - La cible est définie comme étant protégée et ne peut pas être modifiée lorsque la protection globale est activée.
- wk false - La cible n'est pas protégée (par défaut)
- wk mixed - (Cibles plage uniquement). Une partie protégée ne peut pas être modifiée lorsque la protection globale est activée.
Note : La modification du statut de protection d'une cible parente modifiera également le statut des enfants de la cible. |
Des actions de modification spécifiques sont gérées dans les cas suivants, pour les cibles protégées :
- Copier / Coller contenu - Lorsqu'un contenu protégé est copié, tous ses attributs sont copiés également. S'il est collé dans un document avec protection globale :
- Activé - La protection du contenu collé est désactivée, afin qu'il puisse être modifié.
- Désactivé - La protection du contenu collé demeure identique et non modifiable
- Modifier / Supprimer des images
- Image ancrée - Si la protection est activée pour une image ancrée, aucune suppression ni modification ne peut être effectuée.
- Image en ligne - Si une image en ligne protégée est intégrée à un paragraphe non protégé, elle peut être supprimée mais ses attributs ne peuvent pas être modifiés.
- Ajouter / Supprimer des lignes ou des colonnes - Les lignes et les colonnes peuvent être uniquement ajoutées ou supprimées lorsque la protection d'un tableau est désactivée. Lorsque la protection d'un tableau est activée, aucun changement n'est possible.
- Supprimer paragraphes - Lorsqu'il est situé dans un contenu protégé, un paragraphe non protégé peut être effacé mais ne peut pas être supprimé.
Les attributs de plage sont en lecture seulement et permettent d'obtenir les propriétés des plages. Les attributs de plages sont applicables uniquement aux objets de type plage.
Constante | Comment |
---|
wk break type | (Attribut en lecture seule) Type de rupture dans un objet plage de rupture retourné par WP Get breaks. Valeurs possibles : - wk line break,
- wk paragraph break,
- wk column break,
- wk page break,
- wk section break
|
wk end | (Attribut de plage en lecture seule) Position fin de plage. Valeur : entier long |
wk owner | (Attribut en lecture seule) Possesseur de la plage. Valeur : objet |
wk start | (Attribut de plage en lecture seule) Position début de plage. Valeur : entier long |
wk type | Type d'objet 4D Write Pro. Valeurs possibles : - wk type default : Plage ou section sans type défini
- wk type paragraph : Plage de type paragraphe
- wk type image : Image (ancrée et en ligne)
- wk type container : En-tête ou pied, par exemple
- wk type table : Référence de tableau
Pour les plages de cellules, de colonnes et de lignes uniquement : - wk type table row : Référence de ligne de tableau
- wk type table cell : Référence de cellule de tableau
- wk type table column : Référence de colonne de tableau
Pour les sous-sections uniquement : - wk first page : Sous-section de la première page
- wk right page : Sous-section de la page de droite
- wk left page : Sous-section de la page de gauche
Pour les tabulations uniquement, valeur utilisée dans l'objet pour wk tab default ou dans les objets de la collection pour wk tabs : - wk left : Aligne la tabulation à gauche
- wk right : Aligne la tabulation à droite
- wk center : Aligne la tabulation au centre
- wk decimal : Aligne la tabulation à la décimale
- wk bar : Insère une barre verticale au niveau de la tabulation
|
Ces attributs sont spécifiques aux lignes et/ou colonnes. Ils peuvent s'appliquer aux cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X | | | | | | | |
Constante | Comment |
---|
wk column count | (Disponible pour les tableaux, les documents les sections) Nombre de colonnes. Type de valeur : Entier long
- Pour un tableau : attribut en lecture seulement
- Pour un document ou une section : attribut en lecture/écriture. Valeur par défaut=1 (colonne unique). Valeur maximum=20
|
wk first column | (Attribut en lecture seule) Numéro de la première colonne du tableau incluse dans la plage. Valeur : Entier long |
wk first row | (Attribut en lecture seule) Numéro de la première ligne du tableau incluse dans la plage. Valeur : Entier long |
wk header | Indique si la ligne est une ligne d'en-tête du tableau. L'attribut d'en-tête peut être un booléen (par défaut) ou un entier. Valeurs possibles : - Booléen : Vrai si la ligne est une ligne d'en-tête. Faux sinon.
- Entier : wk true wk false wk mixed
Seule l'une des cinq premières lignes d'un tableau peut être définie sur True (voir Répétition des en-têtes). Si la valeur est définie sur True pour une ligne, l'attribut est défini sur True pour toutes les lignes précédentes. Si la valeur est définie sur False pour une ligne, elle est également définie sur False pour toutes les lignes suivantes. |
wk page break inside row | Contrôle la fonction de saut de page automatique dans les rangées de tableaux. Cette constante s'applique : - à toutes les lignes à l'intérieur de la cible
- aux lignes parentes lorsque la cible est une plage de texte ou une plage de cellules.
Si cette option est appliquée à un tableau, elle s'applique aux lignes du tableau, et non au tableau lui-même. Cette option n'est pas prise en compte si wk page break inside table est défini sur wk avoid. Valeurs possibles : - wk auto (par défaut) : une ligne peut être divisée en deux parties lorsque le contenu d'une cellule (de la ligne) ne tient pas dans la page lorsqu'un saut de page physique se produit.
- wk avoid : les lignes des tableaux ne sont jamais divisées.
- wk mixed lors de la lecture de l'attribut
Note de compatibilité : pour les documents créés avec des versions antérieures à la v19 R4, la valeur de chaque ligne est définie sur wk avoid. |
wk row count | (Attribut en lecture seule) Nombre total de lignes. Valeur : Entier long |
wk table | (Attribut en lecture seule) La table parente. Type de valeur : Objet |
wk table ID | (Attribut en lecture seule) ID du tableau parent. Valeur : Chaîne |
Les attributs des sections et sous-sections gèrent des paramètres de section spécifiques (des paramètres de configuration génériques s'appliquent aussi aux sections et sous-sections, voir Configuration ci-dessus). Ils peuvent s'appliquer aux cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | | | | | | | | |
Note : Les valeurs par défaut des attributs de colonne, marge intérieure, bordure et de fond sont héritées de l'objet parent :
- pour les sections, elles sont fondées sur les valeurs du document;
- pour les sous-sections, elles sont fondées sur les valeurs de la section parente si les attributs de la section parente sont surchargés, sinon elles sont fondées sur les valeurs du document.
Constante | Comment |
---|
wk end | (Attribut de plage en lecture seule) Position fin de plage. Valeur : entier long |
wk owner | (Attribut en lecture seule) Possesseur de la plage. Valeur : objet |
wk parent | (Attribut de sous-section en lecture seule) Section parente d'une sous-section. Valeur : objet (référence section). |
wk section index | (Attribut de de section ou de sous-section en lecture seule) Index de la section. Valeurs possibles : toute valeur entière >=1 |
wk section name | Nom d'utilisateur de la section, utilisé pour afficher le nom de la section dans les menus ou dans le document (Lecture seule uniquement avec les sous-sections). Valeurs possibles : Chaîne (default is '', ce qui signifie que le nom d'affichage par défaut sera utilisé). |
wk start | (Attribut de plage en lecture seule) Position début de plage. Valeur : entier long |
wk type | (Attribut de plage en lecture seule) Type d'objet 4D Write Pro. Valeurs possibles :
- wk type default : Plage sans type défini
- wk type paragraph : Plage de type paragraphe
- wk type image : Image (ancrée ou en ligne)
- wk type image anchored : Image ancrée
- wk type image inline : Image en ligne
- wk type container : En-tête ou pied, par exemple
- wk type table : Référence de tableau
- wk type table row : Référence de ligne de tableau
- wk type table cell : Référence de cellule de tableau
- wk type table column : Référence de colonne de tableau (uniquement pour plage colonne)
- wk type body : Référence de corps (body)
|
Les attributs de feuilles de style permettent de gérer des feuilles de styles spécifiques. Ils s'appliquent aux cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X | X** | X* | X* | | | | |
*Lecture seulement pour les en-têtes et les pieds de page, gérés par 4D Write Pro (il y a une feuille de style par en-tête ou pied de section)
**Images insérées dans le texte uniquement
Constante | Comment |
---|
wk new line style sheet | Définit la feuille de style à utiliser en cas d'ajout d'une nouvelle ligne dans le paragraphe. Valeurs possibles :
- Nom de feuille de style existante
- wk none (défaut)
|
wk style sheet | Définit la feuille de style courante pour le ou les élément(s) sélectionné(s). Valeurs possibles :
- Nom de feuille de style existante
- wk none (défaut)
|
Pour plus d'informations sur la création d'objets de feuille de style et la définition des attributs qu'ils contiennent, voir Commandes feuilles de style.
Les attributs de tableaux sont spécifiques aux tableaux. Ils s'appliquent aux cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | X | | | | | | | |
Constante | Comment |
---|
wk bottom carry over row | Spécifie si des lignes de report (carry-over rows) doivent être répétées au bas de chaque page/colonne d'un tableau avec datasource lorsqu'il est fractionné, sauf sur la dernière page/colonne en mode d'affichage des valeurs (la ligne de report doit être créée dans le modèle de tableau, voir Carry-over rows (Lignes à reporter en bas)). Valeurs disponibles : - vrai : ajouter les carry-over rows au bas des tableaux fractionnés
- faux (défaut) : ne pas ajouter les carry-over rows au bas des tableaux fractionnés
Cette fonctionnalité est disponible uniquement avec des tableaux remplis par des datasources retournant des collections ou des entity selections non vides. Dans tout autre contexte, la ligne de report, si elle a été définie, est rendue comme une ligne standard. Note : Les lignes de report ne sont pas rendues en mode Inclus. |
wk break formula | 4D objet formula à utiliser pour la ligne de rupture (sort break row) (généralement une formule basée sur une propriété d'élément comme "This.item.name" afin de s'assurer que la valeur change et par conséquent que la ligne de rupture est générée). |
wk cell count | Nombre total de cellules dans la ligne. Type de valeur : Entier long (valeur pour wk type table row) |
wk column count | (Attribut de plage en lecture seule) Nombre de colonnes de la plage. Valeur : Entier long |
wk datasource | Indique la datasource du tableau. Valeurs possibles : - objet Formula : le tableau est associé à une datasource. Si la formule retourne une entity selection ou une collection non vide, les lignes sont dupliquées à partir de la ligne du modèle et automatiquement remplies par les données des entités ou des éléments de collection (voir Table datasource). Sinon, les lignes sont standard.
- null : le tableau n'est pas associé à une datasource (tableau standard).
|
wk empty datasource | Définit la manière dont la table est affiché lorsque sa source de données est vide. Cet attribut n'a aucun effet si la table n'est pas lié à une source de données. Valeurs possibles : - wk show data row : Valeur par défaut. Affiche la ligne de données et les lignes de rupture (le cas échéant) en plus des en-têtes et des lignes supplémentaires.
- wk hide data row : Masque la ligne de données et les lignes de rupture (si elles ont été définies), les en-têtes et les lignes supplémentaires restent affichés.
- wk show placeholder row : Affiche une ligne de remplacement à la place de la ligne de données et des lignes de rupture (s'il y en a), les en-têtes et les lignes supplémentaires sont toujours affichés. La ligne de remplacement suit la ligne à reporter en bas dans le mode d'affichage des références.
- wk hide table : Masque la table entièrement.
Note : la table n'est pas non plus affiché lorsque la source de données est vide ou NULL et que l'option wk hide data row est définie et qu'il n'y a pas d'en-tête(s) ni de ligne(s) supplémentaire(s). |
wk first column | (Attribut en lecture seule) Numéro de la première colonne du tableau incluse dans la plage. Valeur : Entier long |
wk first row | (Attribut en lecture seule) Numéro de la première ligne du tableau incluse dans la plage. Valeur : Entier long |
wk header row count | (Lecture/Écriture) Nombre de lignes du tableau pour lesquelles l'attribut wk header est défini sur True. La valeur maximale est 5. Si vous indiquez une valeur supérieure à 5, wk header est défini sur True pour les cinq premières lignes uniquement (voir Répétition des en-têtes). |
wk id | ID interne de l'élément. Valeur : Chaîne |
wk page break inside table | Définit si un tableau peut être divisé en deux lignes lorsqu'il est plus grand que la page. Cette constante s'applique : - à tous les tableaux de la cible (document, section, plage de tableaux ou élément)
- par extension, au(x) tableau(x) parent(s) lorsque la cible est une plage de texte, une plage de lignes ou une plage de cellules.
Valeurs possibles : - wk auto (par défaut) : aucune contrainte concernant les sauts de page à l'intérieur du tableau.
- wk avoid : empêche le tableau d'être divisé entre deux lignes (lorsque cela est possible)
- wk mixed : lors de la lecture de l'attribut
|
wk row count | (Attribut en lecture seule) Nombre total de lignes. Valeur : Entier long |
wk table align | Définit l'alignement horizontal pour un élément de tableau. Valeurs possibles :
- wk left (défaut)
- wk right
- wk center
|
Lorsque des attributs différents sont appliqués à des éléments d'un tableau, un ordre de priorité est appliqué pour le rendu :
- Le tableau est dessiné en premier
- Les lignes sont ensuite dessinées (remplaçant les attributs du tableau)
- Les cellules/colonnes sont ensuite dessinées (remplaçant les attributs des lignes).
Zones de texte
Les attributs de zone de texte permettent de gérer les zones de texte insérées ou ajoutées dans la zone. Ces attributs peuvent être appliqués aux cibles 4D Write Pro suivantes :
Documents | Sections | Paragraphes | Images | Tableaux | Lignes | Colonnes/Cellules | En-têtes/Pieds/Corps | Zones de texte |
---|
X | | | | | | | | |
Constante | Comment |
---|
wk anchor horizontal align | Définit l'alignement horizontal d'une image relativement à l'origine (voir wk anchor origin). Valeurs possibles :
- wk left - alignement à gauche
- wk center - alignement au centre (non compatible HTML, image non affichée sur le web)
- wk right - alignement à droite
|
wk anchor horizontal offset | Définit le décalage horizontal d'une image exprimé en dimension CSS de type chaîne ou entier long (cm ou pt ou pixel) dans l'unité wk layout unit. Valeurs possibles :
- Limite gauche ou droite de l'image relativement à wk anchor horizontal align
- Limite gauche ou droite du corps (body) en mode inclus (si wk anchor section = wk anchor embedded)
Valeur par défaut = 0. |
wk anchor layout | Définit la position relative d'une image par rapport au texte ou à la page. Valeurs possibles : - wk behind text - l'image ou la zone de texte est ancrée derrière le texte
- wk in front of text - l'image ou la zone de texte est ancrée devant le texte
- wk text wrap top bottom - l'image ou la zone de texte est ancrée avec le texte enveloppé au-dessus et au-dessous de l'image ou de la zone de texte avec des côtés vides à sa gauche et à sa droite
- wk text wrap square - l'image ou la zone de texte est ancrée avec le texte enveloppé tout autour de l'image ou de la zone de texte
- wk text wrap square left - l'image ou la zone de texte est ancrée avec le texte enveloppé à gauche de l'image ou de la zone de texte
- wk text wrap square right - l'image ou la zone de texte est ancrée avec le texte enveloppé à droite de l'image ou de la zone de texte
- wk text wrap square largest - l'image ou la zone de texte est ancrée avec le texte enveloppé sur le côté le plus large de l'image ou de la zone de texte
- wk inline with text - l'image est insérée dans le texte (position par défaut pour les images insérées avec WP INSERT PICTURE). Cet attribut est en lecture seule (les images dans le texte ne peuvent pas être converties en images ancrées par programmation).
|
wk anchor origin | Définit si l'image est ancrée dans la page, l'en-tête ou le pied. Valeurs possibles :
- wk paper box (défaut) - l'image est ancrée en bordure de page
- wk header box - l'image est ancrée dans l'en-tête du document. Si l'en-tête n'est pas visible, l'image n'est pas affichée.
- wk footer box - l'image est ancrée dans le pied du document. Si le pied n'est pas visible, l'image n'est pas affichée.
Ce sélecteur est ignoré en mode inclus. |
wk anchor page | Définit le numéro de page ou le type de page où l'image est ancrée. Valeurs possibles : - wk anchor all - l'image est ancrée dans toutes les pages de la ou des section(s) définie(s) par wk anchor section
- wk anchor first page - l'image est ancrée dans la première sous-section de la page de la ou des section(s) définie(s) par wk anchor section
- wk anchor left page - l'image est ancrée dans la sous-section de la page gauche de la ou des section(s) définie(s) par wk anchor section
- wk anchor right page - l'image est ancrée dans la sous-section de la page droite de la ou des section(s) définie(s) par wk anchor section
- valeur numérique (entier long >= 0) - indique le numéro de la page dans laquelle l'image est ancrée. Dans ce cas, wk anchor section = wk anchor all. L'ancrage de section est ignoré si une image est ancrée dans une seule page.
Note : Les images en mode Page ne sont pas affichées dans les navigateurs. |
wk anchor section | Définit le numéro de section ou le type de section où l'image est ancrée. Valeurs possibles :- wk anchor all (par défaut) - l'image est ancrée dans toutes les sections du document (l'image est visible uniquement en mode page)
- wk anchor embedded - l'image est ancrée au corps (body) du document en mode inclus (l'image est visible uniquement en mode inclus).
- valeur numérique (entier long >= 1) - indique le numéro de la section dans laquelle l'image est ancrée (l'image est visible uniquement en mode page).
Note : Les images en mode Page ne sont pas affichées dans les navigateurs. |
wk anchor vertical align | Définit l'alignement vertical d'une image relativement à l'origine (voir wk anchor origin). Valeurs possibles :- wk top - alignement en haut
- wk center - alignement au centre (non compatible HTML, image non affichée sur le web)
- wk bottom - alignement en bas
|
wk anchor vertical offset | Définit le décalage vertical d'une image exprimé en dimension CSS de type chaîne ou nombre (cm ou pt ou pixel) dans l'unité wk layout unit. Valeurs possibles :
- Haut, centre ou bas de la page (voir wk anchor horizontal align)
- Haut, centre ou bas du corps (body) en mode inclus (si wk anchor section = wk anchor embedded)
Valeur par défaut = 0. |
wk id | ID interne de l'élément. Valeur : Chaîne |
wk owner | (Attribut en lecture seule) Possesseur de la plage. Valeur : objet |
wk protected | Définit le statut de protection lecture/écriture d'une cible 4D Write Pro (à l'exception des feuilles de style). Valeurs possibles : - wk true - La cible est définie comme étant protégée et ne peut pas être modifiée lorsque la protection globale est activée.
- wk false - La cible n'est pas protégée (par défaut)
- wk mixed - (Cibles plage uniquement). Une partie protégée ne peut pas être modifiée lorsque la protection globale est activée.
Note : La modification du statut de protection d'une cible parente modifiera également le statut des enfants de la cible. |
wk style sheet | Définit la feuille de style courante pour le ou les élément(s) sélectionné(s). Valeurs possibles :
- Nom de feuille de style existante
- wk none (défaut)
|
wk type | Type d'objet 4D Write Pro. Valeurs possibles : - wk type default : Plage ou section sans type défini
- wk type paragraph : Plage de type paragraphe
- wk type image : Image (ancrée et en ligne)
- wk type container : En-tête ou pied, par exemple
- wk type table : Référence de tableau
Pour les plages de cellules, de colonnes et de lignes uniquement : - wk type table row : Référence de ligne de tableau
- wk type table cell : Référence de cellule de tableau
- wk type table column : Référence de colonne de tableau
Pour les sous-sections uniquement : - wk first page : Sous-section de la première page
- wk right page : Sous-section de la page de droite
- wk left page : Sous-section de la page de gauche
Pour les tabulations uniquement, valeur utilisée dans l'objet pour wk tab default ou dans les objets de la collection pour wk tabs : - wk left : Aligne la tabulation à gauche
- wk right : Aligne la tabulation à droite
- wk center : Aligne la tabulation au centre
- wk decimal : Aligne la tabulation à la décimale
- wk bar : Insère une barre verticale au niveau de la tabulation
|
wk vertical align | Définit l'alignement vertical d'un élément. Peut être utilisé avec les caractères, les paragraphes, les images, les tableaux, les lignes de tableaux et les colonnes/cellules de tableaux. 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. Pour les tableaux, lignes de tableaux et colonnes/cellules de tableaux, seules les valeurs wk top, wk bottom et wk middle sont prises en charge. |