Contrôle Text-input dans PowerAppsText input control in PowerApps

Une zone dans laquelle l’utilisateur peut taper du texte, des nombres et d’autres données.A box in which the user can type text, numbers, and other data.

DescriptionDescription

L’utilisateur peut spécifier des données en tapant dans un contrôle Text-input.The user can specify data by typing into a text-input control. 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.Depending on how you configure the app, that data might be added to a data source, used to calculate a temporary value, or incorporated in some other way.

Principales propriétésKey properties

Default : valeur initiale d’un contrôle avant sa modification par l’utilisateur.Default – The initial value of a control before it is changed by the user.

Text : texte qui apparaît sur un contrôle ou que l’utilisateur tape dans un contrôle.Text – Text that appears on a control or that the user types into a control.

Propriétés supplémentairesAdditional properties

Align : emplacement du texte par rapport au centre horizontal de son contrôle.Align – The location of text in relation to the horizontal center of its control.

BorderColor : couleur de bordure du contrôle.BorderColor – The color of a control's border.

BorderStyle : indique si la bordure d’un contrôle est unie, discontinue, en pointillés ou s’il n’y en a aucune.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness : épaisseur de bordure d’un contrôle.BorderThickness – The thickness of a control's border.

FocusedBorderThickness : épaisseur de la bordure du contrôle lorsqu’il est sélectionné au clavier.FocusedBorderThickness – The thickness of the control's border when it has keyboard focus.

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.Clear – Whether a text-input control shows an "X" that the user can tap or click to clear the contents of that control.

Color : couleur du texte dans un contrôle.Color – The color of text in a control.

DelayOutput : lorsque la valeur est définie sur true, l’entrée utilisateur est enregistrée après une demi-seconde.DelayOutput – When set to true, user input is registered after half a second delay. 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).Useful for delaying expensive operations until user completes inputting text (i.e. for filtering when input is used in other formulas).

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).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

DisabledBorderColor : couleur de bordure d’un contrôle si sa propriété DisplayMode est définie sur Disabled.DisabledBorderColor – The color of a control's border if the control's DisplayMode property is set to Disabled.

DisabledColor : couleur du texte d’un contrôle si sa propriété DisplayMode est définie sur Disabled.DisabledColor – The color of text in a control if its DisplayMode property is set to Disabled.

DisabledFill : couleur d’arrière-plan d’un contrôle si sa propriété DisplayMode est définie sur Disabled.DisabledFill – The background color of a control if its DisplayMode property is set to Disabled.

Fill : couleur d’arrière-plan d’un contrôle.Fill – The background color of a control.

Font : nom de la famille de polices dans laquelle le texte s’affiche.Font – The name of the family of fonts in which text appears.

FontWeight : épaisseur du texte dans un contrôle : Gras, Semibold, Normal ou Plus claire.FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

Format : indique si l’entrée utilisateur est limitée aux chiffres uniquement ou peut être n’importe quel texte.Format – Whether the user input is restricted to numbers only or can be any text.

Height : distance entre le haut et le bas d’un contrôle.Height – The distance between a control's top and bottom edges.

HintText : texte gris clair qui apparaît dans un contrôle Text-input s’il est vide.HintText – Light-grey text that appears in an input-text control if it's empty.

HoverBorderColor : couleur de bordure d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

HoverColor : couleur du texte d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill : couleur d’arrière-plan d’un contrôle lorsque l’utilisateur maintient le pointeur de la souris sur ce contrôle.HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Italic : indique si le texte d’un contrôle est en italique.Italic – Whether the text in a control is italic.

LineHeight : distance entre, par exemple, les lignes de texte ou les éléments d’une liste.LineHeight – The distance between, for example, lines of text or items in a list.

MaxLength : le nombre de caractères que l’utilisateur peut taper dans un contrôle Text-input.MaxLength – The number of characters that the user can type into a text-input control.

Mode : le contrôle est en mode SingleLine, MultiLine ou Password.Mode – The control is in SingleLine, MultiLine, or Password mode.

OnChange : indique comment l’application répond quand l’utilisateur modifie la valeur d’un contrôle (par exemple, en ajustant un curseur).OnChange – How the app responds when the user changes the value of a control (for example, by adjusting a slider).

OnSelect : comment l’application répond quand l’utilisateur appuie ou clique sur un contrôle.OnSelect – How the app responds when the user taps or clicks a control.

PaddingBottom : distance entre le texte d’un contrôle et le bord inférieur de ce contrôle.PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft : distance entre le texte d’un contrôle et le bord gauche de ce contrôle.PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight : distance entre le texte d’un contrôle et le bord droit de ce contrôle.PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop : distance entre le texte d’un contrôle et le bord supérieur de ce contrôle.PaddingTop – The distance between text in a control and the top edge of that control.

PressedBorderColor : couleur de bordure d’un contrôle lorsque l’utilisateur appuie ou clique dessus.PressedBorderColor – The color of a control's border when the user taps or clicks that control.

PressedColor : couleur de texte d’un contrôle lorsque l’utilisateur appuie ou clique dessus.PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill : couleur d’arrière-plan d’un contrôle lorsque l’utilisateur appuie ou clique dessus.PressedFill – The background color of a control when the user taps or clicks that control.

RadiusBottomLeft : degré auquel le coin inférieur gauche d’un contrôle est arrondi.RadiusBottomLeft – The degree to which the bottom-left corner of a control is rounded.

RadiusBottomRight : degré auquel le coin inférieur droit d’un contrôle est arrondi.RadiusBottomRight – The degree to which the bottom-right corner of a control is rounded.

RadiusTopLeft : degré auquel le coin supérieur gauche d’un contrôle est arrondi.RadiusTopLeft – The degree to which the top-left corner of a control is rounded.

RadiusTopRight : degré auquel le coin supérieur droit d’un contrôle est arrondi.RadiusTopRight – The degree to which the top-right corner of a control is rounded.

Reset : indique si un contrôle revient à sa valeur par défaut.Reset – Whether a control reverts to its default value.

Size : taille de police du texte qui apparaît sur un contrôle.Size – The font size of the text that appears on a control.

Strikethrough : indique si une ligne s’affiche sur le texte qui apparaît sur un contrôle.Strikethrough – Whether a line appears through the text that appears on a control.

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.TabIndex – Customizes the tab order of controls at runtime when set to a non-zero value.

Tooltip : texte explicatif qui s’affiche lorsque l’utilisateur pointe sur un contrôle.Tooltip – Explanatory text that appears when the user hovers over a control.

Underline : indique si une ligne s’affiche sous le texte qui apparaît sur un contrôle.Underline – Whether a line appears under the text that appears on a control.

Visible : indique si un contrôle est visible ou est masqué.Visible – Whether a control appears or is hidden.

Width : distance entre les côtés droit et gauche d’un contrôle.Width – The distance between a control's left and right edges.

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).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

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).Y – The distance between the top edge of a control and the top edge of the parent container (screen if no parent container).

DateTimeValue( String )DateTimeValue( String )

ExemplesExamples

Collecter des donnéesCollect data

  1. Ajoutez deux contrôles Text-input et nommez-les inputFirst et inputLast.Add two text-input controls, and name them inputFirst and inputLast.

    Vous ne savez pas comment ajouter, nommer et configurer un contrôle ?Don't know how to add, name, and configure a control?

  2. Ajoutez un bouton, définissez sa propriété Text sur Add, puis définissez sa propriété OnSelect sur la formule suivante :Add a button, set its Text property to Add, and set its OnSelect property to this formula:
    Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

    Vous souhaitez davantage d’informations sur la fonction Collect ou d’autres fonctions ?Want more information about the Collect function or other functions?

  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.Add a text gallery in portrait/vertical orientation, set its Items property to Names, and set the Text property of Subtitle1 to 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.(optional) In the template gallery, delete the bottom label, named Body1, and set the TemplateSize property of the gallery to 80.
  5. Appuyez sur F5, tapez une chaîne de texte dans inputFirst et inputLast, puis cliquez ou appuyez sur le bouton Ajouter.Press F5, type a string of text into inputFirst and inputLast, and then click or tap the Add button.
  6. (facultatif) Ajoutez d’autres noms à la collection, puis appuyez sur Échap pour revenir à l’espace de travail par défaut.(optional) Add more names to the collection, and then press Esc to return to the default workspace.

Demander un mot de passePrompt for a password

  1. Ajoutez un contrôle Text-input, nommez-le inputPassword et définissez sa propriété Mode sur Password.Add a text-input control, name it inputPassword, and set its Mode property to Password.
  2. Ajoutez un libellé et définissez sa propriété Text sur la formule suivante :Add a label, and set its Text property to this formula:
    If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

    Vous souhaitez davantage d’informations sur la fonction If ou d’autres fonctions ?Want more information about the If function or other functions?

  3. Appuyez sur F5, puis tapez P@ssw0rd dans inputPassword.Press F5, and then type P@ssw0rd in inputPassword.

    Quand vous terminez de taper le mot de passe, l’étiquette cesse d’afficher Accès refusé et commence à afficher Accès accordé.When you finish typing the password, the label stops showing Access denied and starts to show Access granted.

  4. Appuyez sur Échap pour revenir à l’espace de travail par défaut.To return to the default workspace, press Esc.
  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.(optional) Add a control such as an arrow, configure it to navigate to another screen, and show it only after the user types the password.
  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.(optional) Add a button, configure its Text property to show Sign in, add a timer, and disable the input-text control for a certain amount of time if the user types the wrong password and then clicks or taps the Sign in button.