Zone de texte

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. Pour mettre à jour les valeurs dans les variables d'application, vous devez utiliser la règle Définir la valeur ( Set Value ).

• Info-bulle (Tooltip) : info-bulle à afficher sur la zone de texte. Utilisez-la pour fournir des informations supplémentaires sur la commande.
• 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é.
• Longueur min (Min length) : le nombre minimum de caractères que les utilisateurs doivent saisir.
• Longueur maximale (Max length) : le nombre maximum de caractères que les utilisateurs doivent saisir.
• Modèle (Regex) (Pattern (Regex) : l'expression Regex utilisée pour valider différents modèles d'entrée. Utilisez les barres obliques / / pour encapsuler l'expression Regex, par exemple /{REGEX}/. Si une expression régulière non valide est fournie, aucune validation n'est effectuée au moment de l'exécution. Consultez les exemples suivants pour connaître les expressions Regex valides :

  Expression Regex	Qu'est-ce que la validation
  /\d/	Le texte doit contenir des chiffres
  /^\d*$/	Le texte doit être uniquement composé de chiffres
  /\w/	Le texte doit contenir des caractères de mot (il correspond toujours aux caractères ASCII [A-Za-z0-9_])
  /[A-G]/	Le texte doit contenir des caractères compris entre A et G
  /^C\d{7}$/	Le texte doit commencer par la lettre C suivie de 7 caractères numériques.
  /^.{6,10}$/	Le texte doit être compris entre 6 et 10 .
  /[A-H0-5_@?]/	Le texte contient uniquement des caractères compris entre A et H, 0 et 5, _, @ et ?
  /^4[0-9]{12}(?:[0-9]{3})?$/	Le texte est un numéro de carte de crédit Visa.
  /^3[47][0-9]{13}$/	Le texte est un numéro de carte de crédit American Express.
  /^5[1-5][0-9]{14}|^(222[1-9]|22[3-9]\\d|2[3-6]\\d{2}|27[0-1]\\d|2720)[0-9]{12}$/	Le texte est un numéro de carte de crédit MasterCard.
  /^([+]?\d{1,2}[-\s]?|)\d{3}[-\s]?\d{3}[-\s]?\d{4}$/	Le texte est un numéro de téléphone avec l'indicatif du pays facultatif, des caractères spéciaux facultatifs et des espaces.
  /^(0[1-9]|[1-2][0-9]|3[0-1])\/(0[1-9]|1[0-2])\/(\d{4})$/	Le texte est une date de naissance valide au format DD/MM/YYYY.

• 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.
• Désactivé (Disabled) : si la valeur est true, désactive la commande au moment du runtime.

Events

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

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.
• Couleur d'arrière-plan (Background Color) : la couleur d'arrière-plan de la commande.

• Police (Font) : attributs de police du libellé et du texte d'entrée, 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.

Propriétés VB

Propriété VB	Type de données	Description
AllowDomain	List(Of String)	Liste des domaines autorisés.
BlockDomain	List(Of String)	Liste des domaines bloqués.
Saisie de texte	Chaîne de caractères (string)	-
PatternRegex	Chaîne de caractères (string)	Récupère l'expression régulière (regex) fournie dans les propriétés générales de la commande. Utilisé pour valider l’entrée de l’utilisateur.
Label	Chaîne de caractères (string)	Le libellé de la zone de texte commande, généralement le texte affiché avant la commande.
HintText	Chaîne de caractères (string)	Texte d'espace réservé affiché à l'utilisateur via la commande Zone de texte (Textbox) .
Info-bulle	Chaîne de caractères (string)	Texte d'information qui apparaît lorsque l'utilisateur survole la commande.
Valeur (Value)	Chaîne de caractères (string)	La valeur actuellement sélectionnée de la zone de texte contrôle.
MinLength	Entier	Le nombre minimum de caractères que les utilisateurs doivent saisir.
LongueurMax	Entier	Le nombre maximum de caractères que les utilisateurs peuvent saisir.
Requis	Booléen	Spécifie si la valeur Zone de texte est obligatoire.
Masqué	Booléen	Si la valeur est true, masque la commande au moment du runtime.
Désactivé (Disabled)	Booléen	Si la valeur est true, désactive l'interaction avec la commande au moment du runtime.
EstValide	Booléen	Vérifie la validité de la valeur Textbox . Si True, indique qu'il est valide.

Démos

Zone de texte : découverte de propriétés spécifiques

Introduction

Cette application montre comment exploiter les propriétés d'une commande Zone de texte ( Textbox ).

Application de démonstration - essayez-la vous-même

Télécharger l’application de démonstration depuis GitHub

Aperçu de l’application de démonstration dans le cloud

Application de démonstration - instructions d'utilisation

1. Dans UiPath^® Apps, créez une nouvelle application et importez l'application de démonstration téléchargée.
2. Prévisualisez l'application pour interagir avec les propriétés de la commande Zone de texte ( Textbox ).