Aller au contenu principal
Version: 20 R8 BETA

Attributs

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

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)  

Fond

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XXXXXXXXX
ConstanteComment
wk background clipDé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 colorDé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 modeDé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 heightDé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 imageDé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 urlImage 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 originDé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 horizontalDé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 verticalDé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 repeatDé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 widthDé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 %).

Bordures

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XXXXXXXXX
ConstanteComment
wk border colorDé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 bottomDé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 leftDé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 rightDé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 topDé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 radiusDé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 styleDé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 bottomDé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 leftDé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 rightDé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 topDé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 widthDé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 bottomDé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 leftDé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 rightDé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 topDé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 insideLorsque 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 outsideLorsque 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).

Informations et paramètres du document

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
X

Informations du document

ConstanteComment
wk authorIndique le nom de l'auteur du document (chaîne)
wk companyDéfinit une entreprise associée au document (chaîne)
wk date creationRetourne la date de création du document (date). Cette valeur est en lecture seulement et ne peut pas être fixée.
wk date modifiedRetourne 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 dpiDPI 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 modifiedIndique 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 notesDéfinit des commentaires dans le document (chaîne).
wk subjectDéfinit le sujet du document (chaîne)
wk titleDéfinit le titre du document (chaîne). Par défaut "New 4D Write Pro Document"
wk versionRetourne 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

ConstanteComment
wk break paragraphs in formulasDé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 separatorCaractè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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
X*X*X*X*X*X*X*X*

*Appliqué aux caractères des paragraphes dans les éléments

ConstanteComment
wk fontDé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 boldDé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 defaultObjet 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éTypeDescription
defaultChaine | CollectionPolice(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
windowsChaine | CollectionPolice(s) de substitution à utiliser par défaut sur la plateforme Windows (avant "default", si défini)
macChaine | CollectionPolice(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 familySpé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 italicDé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 sizeDé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 colorDé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 colorDé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 styleDé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 colorDé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 offsetDéfinit le décalage pour l'effet ombré. Valeurs possibles :
  • Taille exprimée en points. Valeur par défaut : 1pt
wk text transformDé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 colorDé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 styleDé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 alignDé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.

Hauteur/Largeur

Les attributs hauteur/largeur permettent de gérer les dimensions des éléments. Ces attributs s'appliquent aux éléments suivants :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XXXX*XX

*Appliqué aux cellules

ConstanteComment
wk heightDé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 heightDé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 widthDé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 widthDé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).

Image

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XX*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 :

ConstanteComment
wk imageDé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 textDéfinit un texte alternatif à l'image, si elle ne peut pas être affichée.
wk image display modeDé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 urlImage 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 typeType 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 :

ConstanteComment
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 alignDé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 :

ConstanteComment
wk anchor horizontal alignDé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 offsetDé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 layoutDé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 originDé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 pageDé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 sectionDé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 alignDé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 offsetDé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 idID interne de l'élément. Valeur : Chaîne
wk image expressionImage 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 formulaImage 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.

Configuration

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XX

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.

ConstanteComment
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 colorCouleur 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 styleStyle 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 widthLargeur 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 autofitIndique 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 unitDé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 numberNumé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 rightLa 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 heightHauteur 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 marginTaille 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 bottomTaille 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 leftTaille 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 rightTaille 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 topTaille 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 orientationOrientation de la page. Valeurs possibles :
  • wk portrait (0) (défaut)
  • wk landscape (1)
wk page sizeDé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 widthLargeur 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.

Liens

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XX*XXX

*Images insérées dans le texte uniquement

ConstanteComment
wk link urlLien 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

Listes

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XX*X*X*

*Appliqués aux paragraphes dans les cellules

ConstanteComment
wk list fontSpé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 familySpé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 numberDé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 LTRMarqueur 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 RTLMarqueur 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 imageDé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 heightDé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 urlImage à 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 typeSpé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

Marges

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XXXXXX

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).

ConstanteComment
wk insideLorsque 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 marginDé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 bottomDé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 leftDé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 rightDé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 topDé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 outsideLorsque 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).

Marges intérieures (padding)

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XXXXX*X*XXX

*Appliqués aux cellules

ConstanteComment
wk insideLorsque 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 outsideLorsque 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 paddingDé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 bottomDé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 leftDé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 rightDé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 topDé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

Paragraphes

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XX*X*X*X*X*

*Appliqués aux paragraphes dans les cellules

ConstanteComment
wk avoid widows and orphansActive 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 directionDéfinit le sens du paragraphe. Valeurs possibles :
  • wk left to right (défaut)
  • wk right to left
wk idID interne de l'élément. Valeur : Chaîne
wk keep with nextRelie 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 heightDé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 paragraphContrô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 defaultObjet 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éTypeDescription
wk typeEntier longAlignement de la tabulation (wk left, wk right, wk center, wk decimal, wk bar).
wk offsetEntier longPosition de la tabulation. La valeur doit être supérieure à 0.
wk leadingChaîneCaractè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 leadingsNOTE 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 :
  • Tableau texte
  • Texte
Propriété synchronisée avec les tableaux wk tab stop offsets et wk tab stop types.
wk tab stop offsetsNOTE 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 typesNOTE 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 tabsCollection d'objets tabulation. Chaque objet tabulation contient l'un ou plusieurs des attributs suivants :
PropriétéTypeDescription
wk typeEntier longAlignement de la tabulation (wk left, wk right, wk center, wk decimal, wk bar).
wk offsetEntier longPosition de la tabulation. La valeur doit être supérieure à 0.
wk leadingChaîneCaractè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 alignDéfinit l'alignement horizontal du texte dans le paragraphe. Valeurs possibles :
  • wk left (défaut)
  • wk right
  • wk justify
  • wk center
wk text indentDé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 alignDé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.

Protection

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
X
ConstanteComment
wk protection enabledActive 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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XXXXXXXXX
ConstanteComment
wk protectedDé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é.

Plages

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.

ConstanteComment
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 typeType 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

Lignes et colonnes

Ces attributs sont spécifiques aux lignes et/ou colonnes. Ils peuvent s'appliquer aux cibles 4D Write Pro suivantes :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XX
ConstanteComment
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 headerIndique 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 rowContrô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

Sections et sous-sections

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones 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.
ConstanteComment
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 nameNom 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)

Feuilles de style

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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XXX**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

ConstanteComment
wk new line style sheetDé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 sheetDé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.

Tableaux

Les attributs de tableaux sont spécifiques aux tableaux. Ils s'appliquent aux cibles 4D Write Pro suivantes :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
XX
ConstanteComment
wk bottom carry over rowSpé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 formula4D 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 countNombre 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 datasourceIndique 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 datasourceDé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 idID interne de l'élément. Valeur : Chaîne
wk page break inside tableDé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 alignDé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 :

  1. Le tableau est dessiné en premier
  2. Les lignes sont ensuite dessinées (remplaçant les attributs du tableau)
  3. 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 :

DocumentsSectionsParagraphesImagesTableauxLignesColonnes/CellulesEn-têtes/Pieds/CorpsZones de texte
X
ConstanteComment
wk anchor horizontal alignDé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 offsetDé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 layoutDé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 originDé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 pageDé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 sectionDé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 alignDé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 offsetDé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 idID interne de l'élément. Valeur : Chaîne
wk owner(Attribut en lecture seule) Possesseur de la plage. Valeur : objet
wk protectedDé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 sheetDé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 typeType 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 alignDé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.