Controle de entrada de texto no Power Apps

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.

Propriedades-chave

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

Texto – 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.

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 no qual o texto é exibido.

FontWeight – o peso do texto em um controle: Bold (negrito), Semibold, Normal ou Lighter (mais leve).

Format – se a entrada do usuário é restrita somente a números ou pode ser qualquer texto.

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 ter pelo menos a 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 das 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).

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 Texto como Adicionar e 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 Coletar ou outras funções?

  3. Adicionar uma galeria de texto na orientação retrato/vertical, defina sua propriedade Items como Names e defina a propriedade Texto 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 inputPassword e defina sua propriedade Mode como Password.

  2. Adicione um rótulo e defina sua propriedade Texto 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 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 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