Controle Entrada de texto no Power Apps

  • Artigo

Uma caixa na qual o usuário pode digitar texto, números e outros dados.

Descrição

O usuário pode especificar dados digitando-os em um controle de entrada de texto. 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.

Principais propriedades

Default – o valor inicial de um controle antes de ele ser alterado pelo usuário.

Text – texto que aparece em um controle ou que o usuário digita em um controle.

Propriedades adicionais

AccessibleLabel – rótulo para leitores de tela.

Align – a localização do texto em relação ao centro horizontal do respectivo controle.

BorderColor – a cor da borda do controle.

BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – a espessura da borda do controle.

Clear – 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. Funciona somente no modo SingleLine.

Color – a cor do texto em um controle.

DelayOutput – quando definido como true, a entrada do usuário é registrada após um atraso de meio segundo. É ú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).

DisplayMode – se o controle permite entrada do usuário (Edição), apenas exibe dados (Exibição), ou está desabilitado (Desabilitado).

DisabledBorderColor – a cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Desabilitado.

DisabledColor – a cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitado.

DisabledFill – a cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitado.

EnableSpellCheck - se um controle de entrada de texto deve usar a função de verificação ortográfica do navegador. O Power Apps para Windows não suporta esta propriedade.

Fill – a cor da tela de fundo de um controle.

FocusedBorderColor – a cor da borda do controle quando ele está focalizado.

FocusedBorderThickness – A espessura da borda de um controle quando ele está focalizado.

Font – o nome da família de fontes em que o texto é exibido.

FontWeight – o peso do texto em um controle: Negrito, Seminegrito, Normal ou Mais claro.

Format – se a entrada do usuário é restrita somente a números ou pode ser qualquer texto. Quando definido como Número, somente dígitos e certos símbolos numéricos podem ser inseridos. Os símbolos e formatos suportados dependem do idioma do navegador e não podem ser definidos em controles individuais.

Height – a distância entre a parte superior do controle e as bordas inferiores.

HintText – texto cinza claro que é exibido em um controle de texto de entrada, se ele estiver vazio.

HoverBorderColor – a cor da borda do controle quando o usuário mantém o ponteiro do mouse nesse controle.

HoverColor – a cor do texto em um controle quando o usuário mantém o ponteiro do mouse sobre ele.

HoverFill – a cor da tela de fundo de um controle quando o usuário mantém o ponteiro do mouse sobre ele.

Italic – se o texto em um controle está em itálico.

LineHeight – a distância entre, por exemplo, linhas de texto ou itens em uma lista.

MaxLength – o número de caracteres que o usuário pode digitar em um controle de entrada de texto.

Mode – o controle está no modo SingleLine, MultiLine ou Password.

OnChange – ações a serem executadas quando o usuário alterar o valor de um controle (por exemplo, ajustando um controle deslizante).

OnSelect – Ações a serem executadas quando o usuário tocar ou clicar em um controle.

PaddingBottom – a distância entre o texto em um controle e a borda inferior desse controle.

PaddingLeft – a distância entre o texto em um controle e a borda esquerda desse controle.

PaddingRight – a distância entre o texto em um controle e a borda direita desse controle.

PaddingTop – a distância entre o texto em um controle e a borda superior desse controle.

PressedBorderColor – a cor da borda do controle quando o usuário toca ou clica nesse controle.

PressedColor – a cor do texto em um controle quando o usuário toca ou clica nesse controle.

PressedFill – a cor da tela de fundo de um controle quando o usuário toca ou clica nesse controle.

RadiusBottomLeft – o grau para o qual o canto inferior esquerdo de um controle é arredondado.

RadiusBottomRight – o grau para o qual o canto inferior direito de um controle é arredondado.

RadiusTopLeft – o grau para o qual o canto superior esquerdo de um controle é arredondado.

RadiusTopRight – o grau para o qual o canto superior direito de um controle é arredondado.

Reset – se um controle é revertido para seu valor padrão.

Size – o tamanho da fonte do texto que aparece em um controle.

Strikethrough – se uma linha é exibida cortando o texto que aparece em um controle.

TabIndex – ordem de navegação do teclado em relação a outros controles.

Tooltip – texto explicativo exibido quando o usuário passa o mouse sobre um controle.

Underline – se uma linha é exibida sob o texto que aparece em um controle.

VirtualKeyboardMode - tipo de teclado virtual, texto ou numérico, exibido na tela de toque do usuário do aplicativo. A propriedade Format determina o valor padrão. O suporte ao dispositivo varia. Os dispositivos que executam o iOS devem ser pelo menos da versão 12.2. A versão recomendada do Android é 9.0, e os recursos dos teclados numéricos variam para dispositivos Android. O Windows 10 não suporta esta propriedade.

Visible – se um controle é exibido ou está oculto.

Width – a distância entre as bordas esquerda e direita de um controle.

X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (ou a tela, se não houver contêiner pai).

Y – a distância entre a borda superior de um controle e a borda superior de seu contêiner pai (ou a tela, se não houver contêiner pai).

Funções relacionadas

DateTimeValue( String )

Exemplos

Coletar dados

  1. Adicione dois controles de entrada de texto e nomeie-os inputFirst e inputLast.

    Não sabe como adicionar, nomear e configurar um controle?

  2. Adicione um botão, defina sua propriedade Text como Adicionare defina sua propriedade OnSelect, conforme esta fórmula:
    Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

    Deseja obter mais informações sobre a função Collect ou outras funções?

  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.

  4. (opcional) Na galeria de modelos, exclua o rótulo inferior, chamado Body1, e defina a propriedade TemplateSize da galeria como 80.

  5. Pressione F5, digite uma cadeia de caracteres de texto em inputFirst e inputLast e, em seguida, clique ou toque no botão Adicionar.

  6. (opcional) Adicione mais nomes à coleção e, em seguida, pressione Esc para retornar ao workspace padrão.

Solicitar uma senha

  1. Adicionar um controle de entrada de texto, nomeie-o inputPassworde defina sua propriedade Mode como Password.

  2. Adicione um rótulo e defina sua propriedade Text como esta fórmula:
    If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

    Deseja saber mais sobre a função If ou sobre outras funções?

  3. Pressione F5 e digite P@ssw0rd em inputPassword.

    Quando terminar de digitar a senha, o rótulo parará de mostrar Acesso negado e começará a mostrar Acesso concedido.

  4. Para retornar ao espaço de trabalho padrão, pressione Esc.

  5. (opcional) Adicione um controle como uma seta, configure-o para navegar para outra tela e mostrá-lo somente depois que o usuário digitar a senha.

  6. (opcional) Adicione um botão, configure a propriedade Text 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 digitar a senha incorreta e, em seguida, clique ou toque no botão Entrar.

Diretrizes de acessibilidade

Contraste de cores

Suporte ao leitor de tela

Suporte de teclado

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).