É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 (Default text ) : 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 se propageront pas dans la variable d'application.
• Libellé (Label) : le texte affiché de la commande.
• Obligatoire (Required) : 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 (Vertical vs Horizontal).
• 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 (Size) : 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 (Stretch) et que la commande parent est définie sur Autoriser l'encapsulage (Allow wrapping), la commande de l'Éditeur de texte enrichi (Rich Text Editor) ne s'étend pas sur toute la hauteur. Pour éviter cela, vous pouvez supprimer l'alignement Étirer (Stretch) 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 (Rich Text Editor).
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 ( Rich Text Editor), généralement le texte affiché avant la commande.
ReadOnly	Booléen	Si 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 (Rich Text Editor).
Required	Booléen	Spécifie si la valeur de l' Éditeur de texte enrichi ( Rich Text Editor ) est obligatoire.
RequiredErrorMessage	Chaîne de caractères (string)	Message affiché lorsque la valeur de l' Éditeur de texte enrichi ( Rich Text Editor ) 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 true, masque la commande au moment du runtime.
Disabled	Booléen	Détermine si l' Éditeur de texte enrichi est interactive. S'il est défini sur true, 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 (Rich Text Editor ). Si True, indique qu'il 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 (Read-only) lors du runtime, l'interface de l'Éditeur de texte enrichi (Rich Text Editor) 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 (Rich Text Editor).

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