Controle de texto de entrada no PowerAppsText input control in PowerApps

Uma caixa em que o usuário pode digitar texto, números e outros dados.A box in which the user can type text, numbers, and other data.

DescriçãoDescription

O usuário pode especificar dados digitando-os em um controle de entrada de texto.The user can specify data by typing into a text-input control. Dependendo de como você configura o aplicativo, esses dados podem ser adicionados a uma fonte de dados usada para calcular um valor temporário ou incorporados de alguma outra forma.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.

Propriedades-chaveKey properties

Padrão – o valor inicial de um controle antes de ele ser alterado pelo usuário.Default – The initial value of a control before it is changed by the user.

Text – texto que aparece em um controle ou que o usuário digita em um controle.Text – Text that appears on a control or that the user types into a control.

Propriedades adicionaisAdditional properties

Align – a localização do texto em relação ao centro horizontal do respectivo controle.Align – The location of text in relation to the horizontal center of its control.

BorderColor – a cor da borda do controle.BorderColor – The color of a control's border.

BorderStyle – se a borda do controle é Solid, Dashed, Dotted ou None.BorderStyle – Whether a control's border is Solid, Dashed, Dotted, or None.

BorderThickness – a espessura da borda do controle.BorderThickness – The thickness of a control's border.

FocusedBorderThickness – a espessura da borda do controle quando ele tem o foco do teclado.FocusedBorderThickness – The thickness of the control's border when it has keyboard focus.

Desmarcar – se um controle de entrada de texto mostra um “X” no qual o usuário pode tocar ou clicar para desmarcar o conteúdo desse controle.Clear – Whether a text-input control shows an "X" that the user can tap or click to clear the contents of that control.

Color – a cor do texto em um controle.Color – The color of text in a control.

DelayOutput – quando definido como true, a entrada do usuário é registrada após um atraso de meio segundo.DelayOutput – When set to true, user input is registered after half a second delay. É útil para atrasar operações caras até que o usuário preencha o texto de entrada (ou seja, para filtragem de entrada quando é usado em outras fórmulas).Useful for delaying expensive operations until user completes inputting text (i.e. for filtering when input is used in other formulas).

DisplayMode – se o controle permite entrada do usuário (Edição), apenas exibe dados (Exibição) ou está desabilitado (Desabilitado).DisplayMode – Whether the control allows user input (Edit), only displays data (View), or is disabled (Disabled).

DisabledBorderColor – a cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Desabilitado.DisabledBorderColor – The color of a control's border if the control's DisplayMode property is set to Disabled.

DisabledColor – a cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitado.DisabledColor – The color of text in a control if its DisplayMode property is set to Disabled.

DisabledFill – a cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitado.DisabledFill – The background color of a control if its DisplayMode property is set to Disabled.

Fill – a cor da tela de fundo de um controle.Fill – The background color of a control.

Font – o nome da família de fontes no qual o texto é exibido.Font – The name of the family of fonts in which text appears.

FontWeight – o peso do texto em um controle: Bold (negrito), Semibold, Normal ou Lighter (mais leve).FontWeight – The weight of the text in a control: Bold, Semibold, Normal, or Lighter.

Format – se a entrada do usuário é restrita somente a números ou pode ser qualquer texto.Format – Whether the user input is restricted to numbers only or can be any text.

Height – a distância entre a parte superior do controle e as bordas inferiores.Height – The distance between a control's top and bottom edges.

HintText – texto cinza claro que é exibido em um controle de texto de entrada se ele estiver vazio.HintText – Light-grey text that appears in an input-text control if it's empty.

HoverBorderColor – a cor da borda do controle quando o usuário mantém o ponteiro do mouse nesse controle.HoverBorderColor – The color of a control's border when the user keeps the mouse pointer on that control.

HoverColor – a cor do texto em um controle quando o usuário mantém o ponteiro do mouse sobre ele.HoverColor – The color of the text in a control when the user keeps the mouse pointer on it.

HoverFill – a cor da tela de fundo de um controle quando o usuário mantém o ponteiro do mouse sobre ele.HoverFill – The background color of a control when the user keeps the mouse pointer on it.

Italic – se o texto em um controle está em itálico.Italic – Whether the text in a control is italic.

LineHeight – a distância entre, por exemplo, linhas de texto ou itens em uma lista.LineHeight – The distance between, for example, lines of text or items in a list.

MaxLength – o número de caracteres que o usuário pode digitar em um controle de entrada de texto.MaxLength – The number of characters that the user can type into a text-input control.

Modo – o controle está no modo SingleLine, MultiLine ou Password.Mode – The control is in SingleLine, MultiLine, or Password mode.

OnChange – como o aplicativo responde quando o usuário altera o valor de um controle (por exemplo, ajustando um controle deslizante).OnChange – How the app responds when the user changes the value of a control (for example, by adjusting a slider).

OnSelect – como o aplicativo responde quando o usuário toca ou clica em um controle.OnSelect – How the app responds when the user taps or clicks a control.

PaddingBottom – a distância entre o texto em um controle e a borda inferior desse controle.PaddingBottom – The distance between text in a control and the bottom edge of that control.

PaddingLeft – a distância entre o texto em um controle e a borda esquerda desse controle.PaddingLeft – The distance between text in a control and the left edge of that control.

PaddingRight – a distância entre o texto em um controle e a borda direita desse controle.PaddingRight – The distance between text in a control and the right edge of that control.

PaddingTop – a distância entre o texto em um controle e a borda superior desse controle.PaddingTop – The distance between text in a control and the top edge of that control.

PressedBorderColor – a cor da borda do controle quando o usuário toca ou clica nesse controle.PressedBorderColor – The color of a control's border when the user taps or clicks that control.

PressedColor – a cor do texto em um controle quando o usuário toca ou clica nesse controle.PressedColor – The color of text in a control when the user taps or clicks that control.

PressedFill – a cor da tela de fundo de um controle quando o usuário toca ou clica nesse controle.PressedFill – The background color of a control when the user taps or clicks that control.

RadiusBottomLeft – o grau para o qual o canto inferior esquerdo de um controle é arredondado.RadiusBottomLeft – The degree to which the bottom-left corner of a control is rounded.

RadiusBottomRight – o grau para o qual o canto inferior direito de um controle é arredondado.RadiusBottomRight – The degree to which the bottom-right corner of a control is rounded.

RadiusTopLeft – o grau para o qual o canto superior esquerdo de um controle é arredondado.RadiusTopLeft – The degree to which the top-left corner of a control is rounded.

RadiusTopRight – o grau para o qual o canto superior direito de um controle é arredondado.RadiusTopRight – The degree to which the top-right corner of a control is rounded.

Redefinir – se um controle é revertido para seu valor padrão.Reset – Whether a control reverts to its default value.

Size – o tamanho da fonte do texto que aparece em um controle.Size – The font size of the text that appears on a control.

Strikethrough – se uma linha é exibida cortando o texto que aparece em um controle.Strikethrough – Whether a line appears through the text that appears on a control.

TabIndex – personaliza a ordem de tabulação de controles em tempo de execução quando definida como um valor diferente de zero.TabIndex – Customizes the tab order of controls at runtime when set to a non-zero value.

Dica de ferramenta – texto explicativo exibido quando o usuário passa o mouse sobre um controle.Tooltip – Explanatory text that appears when the user hovers over a control.

Underline – se uma linha é exibida sob o texto que aparece em um controle.Underline – Whether a line appears under the text that appears on a control.

Visible – se um controle é exibido ou está oculto.Visible – Whether a control appears or is hidden.

Width – a distância entre das bordas esquerda e direita de um controle.Width – The distance between a control's left and right edges.

X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (tela, se não houver contêiner pai).X – The distance between the left edge of a control and the left edge of its parent container (screen if no parent container).

Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (tela, se não houver contêiner pai).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 )

ExemplosExamples

Coletar dadosCollect data

  1. Adicione dois controles de entrada de texto e nomeie-os inputFirst e inputLast.Add two text-input controls, and name them inputFirst and inputLast.

    Não sabe como adicionar, nomear e configurar um controle?Don't know how to add, name, and configure a control?

  2. Adicione um botão, defina sua propriedade Text para Adde defina sua propriedade OnSelect conforme esta fórmula: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})

    Deseja obter mais informações sobre a função Collect ou outras funções?Want more information about the Collect function or other functions?

  3. Adicionar uma galeria de texto na orientação retrato/vertical, defina sua propriedade Items como Namese defina a propriedade Text de Subtitle1 para 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. (opcional) Na galeria de modelos, exclua o rótulo inferior, chamado Body1, e defina a propriedade TemplateSize da galeria como 80.(optional) In the template gallery, delete the bottom label, named Body1, and set the TemplateSize property of the gallery to 80.
  5. Pressione F5, digite uma cadeia de caracteres de texto em inputFirst e inputLaste, em seguida, clique ou toque no botão Adicionar.Press F5, type a string of text into inputFirst and inputLast, and then click or tap the Add button.
  6. (opcional) Adicionar mais nomes à coleção e, em seguida, pressione Esc para retornar ao espaço de trabalho padrão.(optional) Add more names to the collection, and then press Esc to return to the default workspace.

Solicitar uma senhaPrompt for a password

  1. Adicionar um controle de entrada de texto, nomeie-o inputPassworde defina sua propriedade Mode como Password.Add a text-input control, name it inputPassword, and set its Mode property to Password.
  2. Adicione um rótulo e defina sua propriedade Text como esta fórmula: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")

    Deseja saber mais sobre a função If ou sobre outras funções?Want more information about the If function or other functions?

  3. Pressione F5 e, em seguida, digite P@ssw0rd em inputPassword.Press F5, and then type P@ssw0rd in inputPassword.

    Quando terminar de digitar a senha, o rótulo parará de mostrar Acesso negado e começará a mostrar Acesso concedido.When you finish typing the password, the label stops showing Access denied and starts to show Access granted.

  4. Para retornar ao espaço de trabalho padrão, pressione Esc.To return to the default workspace, press Esc.
  5. (opcional) Adicionar um controle como uma seta, configurá-lo para navegar para outra tela e mostrá-lo somente depois que o usuário digita a senha.(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. (opcional) Adicione um botão, configure a propriedade Texto para mostrar Entrar, adicione um temporizador e desabilite o controle de texto de entrada para um determinado período de tempo se o usuário digita a senha incorreta e, em seguida, clique ou toque no botão Entrar.(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.