Utiliser les actions standard 4D Write Pro

L'interface utilisateur des zones 4D Write Pro peut être gérée grâce à un grand nombre d'actions standard. Les actions standard peuvent être assignées :

• aux commandes de menu, disponibles via une barre de menu ou la commande Pop up menu dynamique,
• aux éléments de listes, pop-ups/listes déroulantes, pop-up menus hiérarchiques,
• aux boutons, cases à cocher,
• ou exécutées avec la commande APPELER ACTION.

Lorsqu'elles sont assignées à des objets d'interface, les actions standard gèrent les activations/désactivations de l'objet en fonction du contexte. Pour plus d'informations, référez-vous à la section Actions standard.

Deux catégories d'actions sont disponibles pour les zones 4D Write Pro :

• des actions spécifiques à 4D Write Pro, qui ne peuvent être utilisées qu'avec les zones 4D Write Pro,
• des Autres actions plus génériques de gestion des polices, expressions, du correcteur orthographique et des opérations d'édition, qui peuvent être utilisées avec les zones 4D Write Pro et les autres zones 4D. Ces actions sont détaillées dans la section Actions standard.

Les actions standard ci-dessous sont disponibles pour les zones 4D Write Pro :

Notes :

• Les actions 4D Write Pro n'ont pas de constantes correspondantes.
• Les actions qui affichent un menu/une liste automatique peuvent uniquement être attachées aux commandes de menus ou aux objets pop-ups/liste déroulantes et pop-up menus hiérarchiques (voir *).
• Les cases à cocher et cases à cocher 3D doivent être associées à des actions de statut, telles que "section/differentFirstPage" ou "visibleHorizontalRuler". L'option "Trois états" est prise en charge avec les cases à cocher standard uniquement.
• Un statut d'action de section est toujours égal au statut courant de la section sélectionnée (statut hérité si l'attribut est hérité de la section parente ou de l'attribut par défaut) car il doit refléter le statut de la section sélectionnée (le statut qui est actuellement appliqué à la section). Cependant, modifier un attribut de section avec une action standard surchargera uniquement l'attribut de la section sélectionnée.

(*) Sous-menu : Lorsqu'elles sont utilisées sans paramètres et associées à une commande de menu, un objet pop-up/Liste déroulante ou pop-up menu hiérarchqiue, ces actions affichent un sous-menu automatique. Par exemple, si vous assignez l'action "backgroundColor" à une commande de menu, la sélection de cette commande de menu à l'exécution affichera automatiquement les commandes du sous-menu "couleur de fond". Si vous assignez l'action "zoom" à un pop-up menu hiérarchique, il contiendra automatiquement une liste de valeurs de zoom prédéfinies. A noter que ces actions ne peuvent pas être assignées à des boutons.

(**) showDialog : Ajouter la chaîne /showDialog au nom de l'action permet d'afficher la boîte de dialogue standard associée à l'action. Par exemple, vous pouvez utiliser "paragraph/styleSheet/showDialog" pour ouvrir le dialogue permettant de saisir le nom d'une nouvelle feuille de style.

Syntaxe : anchorHorizontalAlign?value={left | center | right}

Définit l'alignement horizontal de l'image, relatif à anchorOrigin pour les images en page ou à la zone de format pour les images en mode inclus.  Cette action réinitialise à 0 le décalage horizontal. (non activée pour les images en ligne).

Syntaxe : anchorLayout?value={inline | front | behind}

Définit le type de position d'ancre pour une image. Peut être utilisée pour transformer une image en ligne en image ancrée devant ou derrière le texte. Note : Si une image ancrée en transformée en image en ligne, elle est insérée au début du texte sélectionné.

Syntaxe : anchorOrigin?value={paper-box | header-box | footer-box}

Définit la zone relative à la position absolue d'une image ancrée. Si une image est relative à la zone d'en-tête ou de pied (header-box/footer-box) qui n'est pas visible sur une page, l'image n'est pas affichée. Cette action remet à zéro les valeurs de décalage horizontal et vertical. Mode Page uniquement, non activée pour les images en ligne.

Syntaxe : anchorPage?value={all | current | currentSubSection}

Définit la ou les page(s) où l'image sélectionnée est affichée. Mode page uniquement, non activée pour les images en ligne.

Syntaxe : anchorSection?value={all | current}

Définit la ou les section(s) où l'image sélectionnée est affichée. Mode page uniquement, non activée pour les images en ligne.

Syntaxe : anchorVerticalAlign?value={top | center | bottom}

Définit l'alignement vertical de l'image, relatif à anchorOrigin pour les images en page ou à la zone de format pour les images en mode inclus. Cette action réinitialise à 0 le décalage vertical (non activée pour les images en ligne).

Syntaxe : avoidPageBreakInsideEnabled

Active/Désactive le saut de page dans les paragraphes.

Syntaxe : {doc | paragraph | image | section | header | footer}/background

Pour les commandes de menu uniquement. Sous-menu par défaut pour tous les attributs de fond.

Syntaxe : {doc | paragraph | image | section | header | footer}/backgroundClip?value={paper-box | border-box | padding-box | content-box}

Modifie la zone de découpe du fond de la cible (par défaut, la cible est le paragraphe). Paper-box est disponible uniquement avec doc et section.

Syntaxe : {doc | paragraph | image | section | header | footer}/backgroundColor?value={<Css_color> | transparent}

Modifie l'arrière-plan de la cible.

Syntaxe : {doc | paragraph | image | section | header | footer}/backgroundImage?value=none

Efface l'image d'arrière-plan de la cible (par défaut, la cible est le paragraphe).

Syntaxe : {doc | paragraph | image | section | header | footer}/backgroundOrigin?value={paper-box | border-box | padding-box | content-box}

Modifie l'origine de l'image d'arrière-plan de la cible (la cible par défaut est le paragraphe). Paper-box est disponible uniquement avec doc et section.

Syntaxe : {doc | paragraph | image | section | header | footer}/backgroundPositionH?value={left | right | center}

Modifie l'alignement horizontal de l'image d'arrière-plan de la cible (la cible par défaut est le paragraphe).
Ex: paragraph/backgroundPositionH?value=left

Syntaxe : {doc | paragraph | image | section | header | footer}/backgroundPositionV?value={top | bottom | center}

Modifie l'alignement vertical de l'image d'arrière-plan de la cible (la cible par défaut est le paragraphe).
Ex: paragraph/backgroundPositionV?value=top

Syntaxe : {doc | paragraph | image | section | header | footer}/backgroundRepeat?value={no-repeat | repeat | repeat-x | repeat-y}

Modifie le mode de répétition de l'image d'arrière-plan de la cible (la cible par défaut est le paragraphe).

Syntaxe : {doc | paragraph | image | section | header | footer}/backgroundSizeH?value={<Css_length> | <Css_percentage> | auto | cover | contain}

Modifie la largeur de l'image d'arrière-plan de la cible (la cible par défaut est le paragraphe).
Ex: paragraph/backgroundSizeH?value=100%. section/backgroundSizeH?value=cover

Syntaxe: {doc | paragraph | image | section | header | footer}/backgroundSizeV?value={<Css_length> | <Css_percentage> | auto}

Modifie la hauteur de l'image d'arrière-plan de la cible (la cible par défaut est le paragraphe).
Ex: paragraph/backgroundSizeV?value=50%. Ex: section/backgroundSizeV?value=40pt

Syntaxe : bookmark?index=<number>

Sélectionne le Nième signet.
Ex: bookmark?index=2 // sélectionne le deuxième signet

Syntaxe : borderCollapse

Fusionne les bordures de paragraphes et les marges intérieures (padding).

Syntaxe : {doc | paragraph | image | section | header | footer/}{inside | outside/}{borderColor | borderColorLeft | borderColorRight | borderColorTop | borderColorBottom | borderColorLeftRight | borderColorTopBottom}?value=<Css_color>

Modifie la couleur de la bordure de la cible (la cible par défaut est le paragraphe).
Ex: paragraph/borderColorLeft?value=green

Syntaxe : {doc | paragraph | image | section | header | footer}/borderRadius?value=<Css_length>

Change le rayon pour les coins arrondis de la cible (par défaut la cible est le paragraphe).
Ex: paragraph/borderRadius?value=4pt

Syntaxe : {doc | paragraph | image | section | header | footer/}{inside | outside/}borders

Sous-menu par défaut pour les bordures de la cible.

Syntaxe : {doc | paragraph | image | section | header | footer/}{inside | outside/}{borderStyle | borderStyleLeft | borderStyleRight | borderStyleTop | borderStyleBottom | borderStyleLeftRight | borderStyleTopBottom}?value={none | hidden | dotted | dashed | solid | double | groove | ridge | inset | outset}

Modifie le style de la bordure de la cible (par défaut la cible est le paragraphe).
Ex: paragraph/borderStyleLeft?value=double. Ex: outside/borderStyle?value=solid //Définit en style solid la bordure extérieure du paragraphe sélectionné. Ex: inside/borderStyle?value=none //Supprime les bordures intérieures des paragraphes sélectionnés

Syntaxe : {doc | paragraph | image | section | header | footer/}{inside | outside/}{borderWidth | borderWidthLeft | borderWidthRight | borderWidthTop | borderWidthBottom | borderWidthLeftRight | borderWidthTopBottom}?value=<Css_length>

Modifie la largeur de la bordure de la cible (par défaut la cible est le paragraphe).
Ex: paragraph/borderWidthLeft?value=4pt

Syntaxe : {section/}columnCount?value={1<=nombre<=20}

Nombre de colonnes dans le document et/ou la section courant(e).
Ex: section/columnCount?value=3

Syntaxe : {section/}columnRuleColor?value={CSS color}

Couleur de la ligne de séparation verticale entre les colonnes du document ou de la section.
Ex : columnRuleColor?value="#FFFFFF"

Syntaxe : {section/}columnRuleStyle?value={none | dotted | dashed | solid | double | groove | ridge | inset | outset}

Style de la ligne de séparation verticale entre les colonnes du document ou de la section.
Ex: columnRuleStyle?value="solid"

Syntaxe : {section/}columnRuleWidth?value={CSS length}

Largeur de la ligne de séparation verticale entre les colonnes du document ou de la section
Ex: columnRuleWidth?value="2pt"

Syntaxe : {section/}columns

Pour les commandes de menu uniquement. Crée automatiquement un sous-menu Colonnes complet avec tous les sous-menus d'action de colonne (hormis insertColumnBreak)

Syntaxe : {section/}columnSpacing?value={CSS length}

Espacement entre deux colonnes dans le document et/ou la section courant(e).
Ex: columnSpacing?value="1cm"

Syntaxe : {paragraph | image}/deleteStyleSheet?index={1<= number <= number of target style sheets}

Supprime la Nième feuille de style parmi les feuilles de style stockées pour la cible sélectionnée (par défaut la cible est le paragraphe). Le nom de l'élément de menu est remplacé, au moment de l'exécution, par le nom de la feuille de style sur le point d'être supprimée.

Syntaxe : direction?value={ltr | rtl}

Sens de l'écriture du paragraphe (ltr : left to right - rtl : right to left)

Syntaxe : doc

Sous-menu par défaut pour la disposition du corps du document (attributs du mode inclus ou attributs par défaut des sections - mais pour la marge réservée au mode inclus seulement)

Syntaxe : dpi?value={auto | 72 <= integer <= 72*4}

Modifie le dpi de la vue courante (indépendant de l'attribut de document wk dpi utilisé en interne pour la conversion pixels<->points).
Ex: dpi?value=72

Syntaxe : fontStyleWrite

Pour les commandes de menu uniquement. Affiche le sous-menu Style de police par défaut de 4D Write Pro

Syntaxe : fontSubscript

Bascule l'attribut de police indice.

Syntaxe : fontSuperscript

Bascule l'attribut de police exposant.

Syntaxe : footer

Affiche le sous-menu Pied de page.

Syntaxe : footer/remove

Supprime le pied de page sélectionné.

Syntaxe : header

Affiche le sous-menu En-tête.

Syntaxe : header/remove

Supprime l'en-tête sélectionné.

Syntaxe : htmlWYSIWIGEnabled

Bascule du mode html au mode wysiwyg.

Syntaxe : image

Affiche le sous-menu Image.

Syntaxe : image/height?value={<Css_length> | auto}

Hauteur de l'image.
Ex: image/height?value=50pt. Pour image/width, voir width.

Syntaxe : image/verticalAlign?value={top | middle | bottom | baseline | super | sub}

Alignement vertical de l'image.
Ex: image/verticalAlign?value=super

Syntaxe : insertImage

Ouvre une boîte de dialogue de sélection d'image et insère l'image sélectionnée (le cas échéant) en tant que caractère dans la zone.

Syntax: insertColumnBreak

Inserts a column break at the selection.

Syntaxe : insertPageBreak

Insère un saut de page à l'endroit sélectionné.

Syntaxe : insertSectionBreak

Insère un saut de section à l'endroit sélectionné.

Syntaxe : lineHeight?value={<Css_length> | <Css_percentage>}

Hauteur de ligne du paragraphe.
Ex: lineHeight?value=120%

Syntaxe : listStartNumber?value={<number> (longint) | auto}

Numéro de départ de la liste.
Ex: listStartNumber?value=10

Syntaxe : listStyleImage/showDialog

Ouvre un dialogue d'ouverture de fichier pour choisir une image à afficher en tant que puce pour une liste ; définit également un élément de liste sous forme de disque – style à utiliser si l'image n'est pas trouvée.

Syntaxe : listStyleType?value={none | disc | circle | square | hollow-square | diamond | club | decimal | decimal-leading- zero | lower-latin | lower-roman | upper-latin | upper-roman | lower-greek | decimal-greek | armenian | georgian | hebrew | hiragana | katakana | cjk-ideographic}

Type de style de liste de paragraphes.

Syntaxe : {doc | paragraph | image | section | header | footer/}{inside | outside/}{margin | marginLeft | marginRight | marginTop | marginBottom | marginLeftRight | marginTopBottom}?value={<Css_length> | auto}

Modifie la marge de la cible (la cible par défaut est le paragraphe).
Ex: margin?value=4pt //sets all paragraph margins to 4pt.
Ex: outside/margin?value=4pt //fixe la marge extérieure du paragraphe à 4pt.
Ex: doc/marginLeft?value=1cm //fixe la marge gauche à 1 cm pour le document utilisé en mode inclus.
Ex: section/marginLeft?value=1cm //fixe la marge gauche à 1 cm pour les pages de la première section sélectionnée

Syntaxe : merge

Fusionne les paragraphes.

Syntaxe : {paragraph | image}/minHeight?value=<Css_length>

Hauteur minimum de la cible (la cible par défaut est le paragraphe).
Ex: paragraph/minHeight?value=50pt

Syntaxe : {paragraph | image}/minWidth?value=<Css_length>

Largeur minimum de la cible (la cible par défaut est le paragraphe).
Ex: paragraph/minWidth?value=50pt

Syntaxe : moveToBack

Place l'image à l'arrière plan. (non activée pour les images en ligne)

Syntaxe : moveToFront

Place l'image au premier plan. (non activée pour les images en ligne)

Syntaxe : newLineStyleSheet?index={1<=number<=number of paragraph stylesheets | newLineStyleSheet?value=auto

Les éléments du paragraphe sélectionné utiliseront la Nième feuille de style pour les nouveaux paragraphes créés par Retour Chariot ou lors d'un fractionnement de paragraphes ; si value=auto, les nouveaux paragraphes utiliseront la même feuille de style (fonctionnement par défaut). (le libellé de la ligne de menu est remplacé, à l'exécution, par le nom de la feuille de style).

Syntaxe : {doc | paragraph | image | section | header | footer/}{inside | outside/}{padding | paddingLeft | paddingRight | paddingTop | paddingBottom | paddingLeftRight | paddingTopBottom }?value=<Css_length>

Modifie le padding de la cible (la cible par défaut est le paragraphe)

Syntaxe : pageMode?value={embedded | page | draft}

Change le mode d'affichage. Ex: pageMode?value=page

Syntaxe : {section/}pageOrientation?value={landscape | portrait}

Modifie le document ou l'orientation de la page de la première section sélectionnée (si la section n'est pas spécifiée, elle s'appliquera à toutes les sections, sinon à la première section sélectionnée).
Ex: pageOrientation?value=portrait //change l'orientation en Portrait pour tout le document.
Ex: section/pageOrientation?value=landscape //change l'orientation en Paysage pour la première section sélectionnée

Syntaxe : pageSize?index=<number>

Modifie la taille de la page du document : <number> est la Nième taille de page dans la liste des tailles de page disponibles dans l'imprimante courante.
Ex: pageSize?index=1

Syntaxe : paragraph

Sous-menu par défaut pour le paragraphe.

Syntaxe : print

Imprime le document en mode Page avec les paramètres de vue courants de la zone 4D Write Pro qui a le focus.

Syntaxe : refreshImages

Recharge les images du réseau pour les images avec URLs.

Syntaxe : section

Sous-menu par défaut de disposition de la page pour la première section sélectionnée

Syntaxe : section/differentFirstPage

La section a ou non une première page différente

Syntaxe : section/differentLeftRightPages

La section a ou non des pages droites et gauches différentes

Syntaxe : section/name/showDialog

Affiche un dialogue permettant d'entrer le nom de la première section sélectionnée

Syntaxe : section/reset

Réinitialise tous les attributs de la première section sélectionnée pour les remplacer par les attributs par défaut - qui sont hérités des attributs du document pour l'arrière-plan, la bordure et les marges intérieures (même pour le mode inclus) et de 2.5 cm pour les marges des pages. Les propriétés de colonnes de la première section de la sélection sont également réinitialisées (seules les propriétés de section par défaut sont appliquées).

Syntaxe : split

Fractionne les paragraphes.

Syntaxe : {paragraph | image}/styleSheet?value={1<=number<=number of target style sheets}

Applique la Nième feuille de style aux éléments sélectionnés de la cible. Avec la boîte de dialogue, la nouvelle feuille de style utilisera les attributs courants de la première cible sélectionnée (par défaut la cible est le paragraphe).
Ex: styleSheet?value=1 //applique la première feuille de style de paragraphes aux paragraphes sélectionnés et la définit comme feuille de style.

Syntaxe : {paragraph | image}/styleSheets

Sous-menu par défaut pour la modification des feuilles de style de la cible

Syntaxe : textAlign?value={left | right | center | justify | initial}

Alignement du texte du paragraphe (initial=utilise right pour la direction rtl ou left pour la direction ltr)

Syntaxe : textIndent?value=<Css_length> (peut être négative)

Indentation de la première ligne du paragraphe.
Ex: textIndent?value=2cm

Syntaxe : textLinethrough

Pour les commandes de menu uniquement. Sous-menu Texte barré (avec style et couleur).

Syntaxe : textLinethroughColor?value={<Css_color> | currentColor}

Ex: textLinethroughColor?value=red

Syntaxe : textLinethroughStyle?value={none | solid | dotted | dashed | double | semi-transparent | word}

Ex: textLinethroughStyle?value=dotted

Syntaxe : textShadow

Pour les commandes de menu uniquement. Sous-menu par défaut pour le texte ombré (avec couleur et décalage)

Syntaxe : textShadowColor?value={<Css_color> | none}

Modifie la couleur d'ombre des caractères.
Ex: textShadowColor?value=green

Syntaxe : textShadowOffset?value=<Css_length>

Définit le décalage de l'ombré. Seule une valeur en points est possible.
Ex: textShadowOffset?value=2pt

Syntaxe : textTransform?value={none | capitalize | uppercase | lowercase | small-uppercase}

Formate le texte.
Ex: textTransform?value=capitalize

Syntaxe : textUnderline

Pour les commandes de menu uniquement. Sous-menu Souligné (avec style et couleur)

Syntaxe : textUnderlineColor?value={<Css_color> | currentColor}

Ex: textUnderlineColor?value=red

Syntaxe : textUnderlineStyle?value={none | solid | dotted | dashed | double | semi-transparent | word}

Ex: textUnderlineStyle?value=dotted

Syntaxe : {paragraph | image}/updateStyleSheet

Mise à jour de la première feuille de style de la cible sélectionnée (la cible par défaut est le paragraphe)

Syntaxe : userUnit?value={cm | mm | in | pt}

Modifie l'unité de mise en page du document (sera répercutée sur les règles)

Syntaxe : verticalAlign?value={top | middle | bottom}

Alignement vertical du paragraphe.
Ex: verticalAlign?value=top. L'effet dépend de la valeur minHeight du paragraphe.

Syntaxe : view

Pour les commandes de menu uniquement. Sous-menu par défaut pour les paramétrages de vue

Syntaxe : visibleBackground

Affiche/cache l'arrière-plan

Syntaxe : visibleFooters

Affiche/cache les pieds de page

Syntaxe : visibleHeaders

Affiche/cache les en-têtes.

Syntaxe : visibleHiddenChars

Affiche/cache les caractères cachés.

Syntaxe : visibleHorizontalRuler

Affiche/cache la règle horizontale.

Syntaxe : visiblePageFrames

Affiche/cache les cadres des pages.

Syntaxe : widowAndOrphanControlEnabled

Bascule du mode de contrôle des veuves et orphelines.

Syntaxe : {paragraph | image}/width?value=<Css_length> | auto

Largeur de la cible (uniquement pour le paragraphe et l'image - la cible par défaut est le paragraphe).
Ex: image/width?value=50pt

Syntaxe : zoom?value={25% <= percentage in Css <= 400%}

Modification du zoom du document.
Ex: zoom?value=120%

De nombreuses autres actions standard proposées avec les formulaires 4D peuvent être utilisées dans les zones 4D Write Pro :

• Actions d'édition, comme les actions Copier/Coller.
• Actions sur la Police, telles que fontBold ou fontSize.
• Actions sur les Expressions dynamiques, permettant de gérer l'insertion d'expressions.
• Actions du Correcteur orthographique.