Éditeur de texte enrichi

Utilisez la commande Éditeur de texte enrichi (Rich Text Editor) pour permettre aux utilisateurs de composer du texte enrichi à partir de votre application. Ce texte peut ensuite être utilisé comme contenu d'e-mail, contenu marketing, etc.

Heure de conception

Général

• Texte de l'indice (Hint Text) : texte d'aide à afficher au moment du runtime.
• Texte par défaut : le contenu par défaut à afficher au moment du runtime. Si cette propriété est liée à une variable d'application, les modifications apportées à la valeur par défaut ne seront pas propagées à la variable d'application.
• Libellé (Label) : le texte affiché de la commande.
• Obligatoire : si la valeur est true, les utilisateurs de l'application doivent fournir des données dans la commande. Pour marquer la commande comme obligatoire au moment du runtime, un astérisque * est ajouté après le texte du libellé.
• Message d'erreur personnalisé (Custom error message) : le texte à afficher si la propriété Requis (Required) est définie sur true et que la commande est laissée vide.
• Masqué (Hidden) : si la valeur est true, masque la commande au moment du runtime.
• Lecture seule (Read only) : si la valeur est true, vous ne pouvez pas ajouter de texte au moment du runtime, mais le contenu existant sera affiché et ne pourra pas être modifié.

Events

• Valeur modifiée (Value changed) : configurez ce qui se passe lorsque le contenu est modifié.

Style

• Alignement de commande (Control Alignment) : hérite de l'alignement parent par défaut. Un autre alignement que le parent peut être défini. Pour revenir par défaut à l'alignement parent, désélectionnez les options remplacées.
  Remarque :

  L'alignement dépend de la mise en page sélectionnée pour le parent.

• Emplacement du libellé (Label Placement) : par défaut, le libellé est configuré pour être affiché en haut de la commande, sur le côté gauche. Vous pouvez la placer à gauche de la commande, sur la même ligne. La propriété Largeur du libellé (Label Width) configure la largeur du libellé, et la propriété Espace intermédiaire (Space between) définit la distance entre le libellé et la commande.
• Police (Font) : attributs de police du texte du libellé, tels que la famille de polices, la taille, la couleur ou le style (gras, italique et souligné). Par défaut, la commande hérite de la famille de polices de son conteneur parent immédiat, qui est indiqué par le mot-clé « Inherited ».
• Marge (Margin) : la marge de la commande. Par défaut, une marque de 4px est définie. Les propriétés des marges Haut/Bas (Top/Bottom)et Gauche/Droite (Left/Right) sont combinées. Ces propriétés peuvent être dissociées à l'aide du bouton Lier (Link) sur le côté droit de la section Marge (Margin).
• Taille : largeur et hauteur de la commande. Par défaut, la taille est définie sur auto. Pour définir des valeurs minimales ou maximales, cliquez sur l'icône à trois points (*). Si la taille du champ est inférieure à celle des options, une barre de défilement s'affiche.
  Remarque :

  Lorsque l'alignement des commandes est défini sur Étirer et que la commande parent est définie sur Autoriser l'encapsulage, la commande de l' Éditeur de texte enrichi ne s'étend pas sur toute la hauteur. Pour éviter cela, vous pouvez supprimer l'alignement Étirer ou fournir une hauteur explicite pour la commande.

Propriétés VB

Propriété VB	Type de données	Description
Tooltip	Chaîne de caractères (string)	Texte d'information qui apparaît lorsque l'utilisateur survole l' Éditeur de texte enrichi.
HintText	Chaîne de caractères (string)	Texte d'espace réservé affiché dans l' Éditeur de texte enrichi.
Label	Chaîne de caractères (string)	Le libellé de l' Éditeur de texte enrichi, généralement affiché avant la commande.
ReadOnly	Booléen	S'il est défini sur true, l' Éditeur de texte enrichi est en lecture seule au moment du runtime.
Value	Chaîne de caractères (string)	Valeur actuellement sélectionnée de l’ Éditeur de texte enrichi.
Required	Booléen	Spécifie si la valeur de l' Éditeur de texte enrichi est obligatoire.
RequiredErrorMessage	Chaîne de caractères (string)	Message affiché lorsque la valeur de l' Éditeur de texte enrichi est requise, mais n'a pas été fournie.
Hidden	Booléen	Détermine la visibilité de l’ Éditeur de texte enrichi. Si défini sur Vrai, masque la commande au moment du runtime.
Disabled	Booléen	Détermine si l’ Éditeur de texte enrichi peut interagir. S’il est défini sur Vrai, désactive l’interaction avec l’ Éditeur de texte enrichi au moment du runtime.
IsValid	Booléen	Vérifie la validité de la valeur de l' Éditeur de texte enrichi . Si la valeur est définie sur true, indique qu'elle est valide.

Runtime

Vue d'ensemble (Overview)

Utilisez cette commande pour composer du texte enrichi directement depuis l'application lors du runtime.

Remarque :

Si vous cochez la case Lecture seule lors du runtime, l'interface de l' Éditeur de texte enrichi change : les commandes d'édition sont masquées et vous ne pouvez pas ajouter du texte ou modifier le texte existant.

Interface

L'interface fournit des fonctionnalités utiles, telles que :

• Style de police : personnalise la police. Choisissez une des options suivantes :
  • Gras
  • Italique
  • Souligner
  • Liste à puces : crée une liste à puces.
  • Liste numérotée : crée une liste numérotée.
  • Table : crée une table. Vous pouvez modifier le style de la table (taille, alignement, couleur d'arrière-plan, bordure) en sélectionnant Propriétés de la table (Table properties) dans le menu déroulant.
  • Famille de polices
  • Font size
  • Couleur du texte
  • Couleur d'arrière-plan du texte
• Alignement : aligne le contenu dans la commande Éditeur de texte enrichi (Rich Text Editor).
  • Aligner à gauche : aligne le texte sur un bord gauche.
  • Aligner à droite : aligne le texte sur un bord droit.
  • Aligner au centre : aligne le texte entre deux bords.
  • Justifier : augmente l'espace entre les mots pour remplir toute la ligne afin qu'elle soit alignée avec les bords gauche et droit.
• Diminuer et Augmenter le retrait : augmente ou diminue l'espace entre les marges gauche et droite d'un paragraphe.
• Hauteur de ligne : modifie l'espace entre deux lignes.
• Exposant et Indice : formate le texte de manière à ce qu'il soit légèrement au-dessus (exposant) ou en dessous (indice) de la ligne normale de type.
• Effacer la mise en forme : supprime toute la mise en forme d'un bloc de texte sélectionné, d'un paragraphe ou du texte entier.
• Insérer/modifier une image : insère une image à partir d'un Compartiment de stockage (Storage bucket).
• Bloc de citation : indique la citation d'une large sélection de texte provenant d'une autre source.
• Ligne horizontale : insère une ligne horizontale.
• Insérer/modifier un lien : insère ou modifie une URL publique. Vous pouvez également le configurer pour qu'il s'ouvre dans la même fenêtre ou dans une nouvelle fenêtre.
• Annuler et Rétablir : annule les modifications ou les rétablis si nécessaire.

Raccourcis clavier

Important :

Actuellement, les raccourcis clavier CTRL+C et CTRL+V ne fonctionnent pas sur les machines Windows pour les fenêtres contextuelles d'intégration ou d'image affichées dans la commande Éditeur de texte enrichi . Utilisez CTRL+SHIFT+C et CTRL+SHIFT+V à la place.

Vous pouvez utiliser les raccourcis clavier suivants pour accéder à la barre d'outils du contrôle :

Tâche	PC (non macOS)	macOS
Mettre le focus ou passer à la barre de menus	ALT + F9	Option + F9
Se concentrer ou passer à la barre d'outils	ALT+F10	Option + F10