Une zone dans laquelle l’utilisateur peut taper du texte, des nombres et d’autres données.

Description

L’utilisateur peut spécifier des données en tapant dans un contrôle Text-input. Selon la configuration de l’application, ces données peuvent être ajoutées à une source de données, utilisées pour calculer une valeur temporaire ou incorporées d’une autre façon.

Principales propriétés

Default : valeur initiale d’un contrôle avant sa modification par l’utilisateur.

Text : texte qui apparaît sur un contrôle ou que l’utilisateur tape dans un contrôle.

Propriétés supplémentaires

Align : emplacement du texte par rapport au centre horizontal de son contrôle.

BorderColor : couleur de bordure du contrôle.

BorderStyle : indique si la bordure d’un contrôle est unie, discontinue, en pointillés ou s’il n’y en a aucune.

BorderThickness : épaisseur de bordure d’un contrôle.

FocusedBorderThickness : épaisseur de la bordure d’un contrôle, lorsqu’elle a le focus clavier.

Clear : indique si un contrôle Text-input affiche un « X » sur lequel l’utilisateur peut appuyer ou cliquer pour effacer le contenu de ce contrôle.

Color : couleur du texte dans un contrôle.

DelayOutput : lorsque la valeur est définie sur true, l’entrée utilisateur est enregistrée après une demi-seconde. Cela peut être utile pour retarder les opérations coûteuses jusqu’à ce que l’utilisateur termine d’entrer du texte (p. ex. pour filtrer lorsque l’entrée est utilisée dans d’autres formules).

DisplayMode : indique si le contrôle autorise l’entrée d’un utilisateur (Edit), affiche uniquement les données (View) ou est désactivé (Disabled).

DisabledBorderColor : couleur de bordure d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

DisabledColor : couleur du texte d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

DisabledFill : couleur d’arrière-plan d’un contrôle si sa propriété DisplayMode est définie sur Disabled.

Fill : couleur d’arrière-plan d’un contrôle.

Font : nom de la famille de polices dans laquelle le texte s’affiche.

FontWeight : épaisseur du texte dans un contrôle : Gras, Semibold, Normal ou Plus claire.

Format : indique si l’entrée utilisateur est limitée aux chiffres uniquement ou peut être n’importe quel texte.

Height : distance entre le haut et le bas d’un contrôle.

HintText : texte gris clair qui apparaît dans un contrôle Text-input s’il est vide.

HoverBorderColor : couleur de bordure d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.

HoverColor : couleur du texte d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.

HoverFill : couleur d’arrière-plan d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.

Italic : indique si le texte d’un contrôle est en italique.

LineHeight : distance entre, par exemple, les lignes de texte ou les éléments d’une liste.

MaxLength : le nombre de caractères que l’utilisateur peut taper dans un contrôle Text-input.

Mode : le contrôle est en mode SingleLine, MultiLine ou Password.

OnChange : indique comment l’application répond quand l’utilisateur modifie la valeur d’un contrôle (par exemple, en ajustant un curseur).

OnSelect : comment l’application répond quand l’utilisateur appuie ou clique sur un contrôle.

PaddingBottom : distance entre le texte d’un contrôle et le bord inférieur de ce contrôle.

PaddingLeft : distance entre le texte d’un contrôle et le bord gauche de ce contrôle.

PaddingRight : distance entre le texte d’un contrôle et le bord droit de ce contrôle.

PaddingTop : distance entre le texte d’un contrôle et le bord supérieur de ce contrôle.

PressedBorderColor : couleur de bordure d’un contrôle lorsque l’utilisateur appuie ou clique dessus.

PressedColor : couleur de texte d’un contrôle lorsque l’utilisateur appuie ou clique dessus.

PressedFill : couleur d’arrière-plan d’un contrôle lorsque l’utilisateur appuie ou clique dessus.

RadiusBottomLeft : degré auquel le coin inférieur gauche d’un contrôle est arrondi.

RadiusBottomRight : degré auquel le coin inférieur droit d’un contrôle est arrondi.

RadiusTopLeft : degré auquel le coin supérieur gauche d’un contrôle est arrondi.

RadiusTopRight : degré auquel le coin supérieur droit d’un contrôle est arrondi.

Reset : indique si un contrôle revient à sa valeur par défaut.

Size : taille de police du texte qui apparaît sur un contrôle.

Strikethrough : indique si une ligne s’affiche sur le texte qui apparaît sur un contrôle.

TabIndex : personnalise l’ordre de tabulation des contrôles lors de l’exécution si la valeur définie est différente de zéro.

Tooltip : texte explicatif qui s’affiche lorsque l’utilisateur pointe sur un contrôle.

Underline : indique si une ligne s’affiche sous le texte qui apparaît sur un contrôle.

Visible : indique si un contrôle est visible ou est masqué.

Width : distance entre les côtés droit et gauche d’un contrôle.

X : distance entre le bord gauche d’un contrôle et le bord gauche de son conteneur parent (ou l’écran s’il n’y a pas de conteneur parent).

Y : distance entre le bord supérieur d’un contrôle et le bord supérieur du conteneur parent (ou l’écran s’il n’y a pas de conteneur parent).

Fonctions connexes

DateTimeValue( String )

Exemples

Collecter des données

  1. Ajoutez deux contrôles Text-input et nommez-les inputFirst et inputLast.

    Vous ne savez pas comment ajouter, nommer et configurer un contrôle ?

  2. Ajoutez un bouton, définissez sa propriété Text sur Add, puis définissez sa propriété OnSelect sur la formule suivante :
    Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

    Vous souhaitez davantage d’informations sur la fonction Collect ou d’autres fonctions ?

  3. Ajouter une galerie de texte dans l’orientation verticale/portrait, définissez sa propriété Items sur Names et définissez la propriété Text de Subtitle1 sur ThisItem.FirstName.

  4. (facultatif) Dans la galerie de modèles, supprimez l’étiquette du bas, nommée Body1, et définissez la propriété TemplateSize de la galerie sur 80.

  5. Appuyez sur F5, tapez une chaîne de texte dans inputFirst et inputLast, puis cliquez ou appuyez sur le bouton Ajouter.

  6. (facultatif) Ajoutez d’autres noms à la collection, puis appuyez sur Échap pour revenir à l’espace de travail par défaut.

Demander un mot de passe

  1. Ajoutez un contrôle Text-input, nommez-le inputPassword et définissez sa propriété Mode sur Password.

  2. Ajoutez un libellé et définissez sa propriété Text sur la formule suivante :
    If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

    Vous souhaitez davantage d’informations sur la fonction If ou d’autres fonctions ?

  3. Appuyez sur F5, puis tapez P@ssw0rd dans inputPassword.

    Quand vous terminez de taper le mot de passe, l’étiquette cesse d’afficher Accès refusé et commence à afficher Accès accordé.

  4. Pour revenir à l’espace de travail par défaut, appuyez sur Echap.

  5. (facultatif) Ajoutez un contrôle tel qu’une flèche, configurez-le pour accéder à un autre écran et affichez-le uniquement après que l’utilisateur a tapé le mot de passe.

  6. (facultatif) Ajoutez un bouton, configurez sa propriété Text pour qu’il affiche Se connecter, ajoutez une minuterie et désactivez le contrôle Text-input pour un certain temps si l’utilisateur tape un mot de passe incorrect, puis clique ou appuie sur le bouton Se connecter.