Compartilhar via


Controle de entrada de texto no Power Apps

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

Description

O usuário pode especificar dados digitando 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

Padrão – o valor inicial de um controle antes de 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.

Alinhar – o local do texto em relação ao centro horizontal de seu controle.

BorderColor – A cor da borda de um controle.

BorderStyle – se a borda de um controle é Solid, Dashed, Dotted ou None.

BorderThickness – A espessura da borda de um controle.

Claro – se um controle de entrada de texto mostra um "X" que o usuário pode tocar ou clicar para limpar o conteúdo desse controle. Só funciona no modo SingleLine .

Cor – 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 conclua a entrada de texto (ou seja, para filtragem quando a entrada é usada em outras fórmulas).

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

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

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

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

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 dá suporte a essa propriedade.

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

FocusedBorderColor – A cor da borda de um controle quando o controle está focado.

FocusedBorderThickness – A espessura da borda de um controle quando o controle está focado.

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

FontWeight – O peso do texto em um controle: Negrito, Semiaberto, Normal ou Mais Leve.

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

Altura – a distância entre as bordas superior e inferior de um controle.

HintText – Texto cinza claro que aparece em um controle de texto de entrada se estiver vazio.

HoverBorderColor – A cor da borda de um 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.

Itálico – se o texto em um controle é 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.

Modo – O controle está no modo SingleLine, Multiline ou Password .

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

OnSelect – Ações a serem executadas quando o usuário toca ou clica 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 de um 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 em que o canto inferior esquerdo de um controle é arredondado.

RadiusBottomRight – O grau em que o canto inferior direito de um controle é arredondado.

RadiusTopLeft – O grau em que o canto superior esquerdo de um controle é arredondado.

RadiusTopRight – O grau em que o canto superior direito de um controle é arredondado.

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

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

Tachado – se uma linha aparece por meio do texto que aparece em um controle.

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

Dica de ferramenta – texto explicativo exibido quando o usuário passa o mouse sobre um controle.

Sublinhado – se uma linha aparece sob o texto que aparece em um controle.

VirtualKeyboardMode – tipo de teclado virtual, texto ou numérico, que aparece na tela sensível ao toque de um 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 de teclados numéricos variam para dispositivos Android. O Windows 10 não dá suporte a essa propriedade.

Visível – se um controle aparece ou está oculto.

Largura – 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).

DateTimeValue( String )

Exemplos

Coletar dados

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

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

  2. Adicione um botão, defina sua propriedade Text como Adicionar e defina sua propriedade OnSelect como 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. Adicione uma galeria de texto na orientação retrato/vertical, defina sua propriedade Items como Nomes e defina a propriedade Text de Subtítulo1 como 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 clique ou toque no botão Adicionar .

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

Solicitar uma senha

  1. Adicione 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 Text como esta fórmula:
    If(inputPassword.Text = "P@ssw0rd", "Access granted", "Access denied")

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

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

    Quando você terminar de digitar a senha, o rótulo para de mostrar o Access negado e começa a mostrar o Access concedido.

  4. Para retornar ao workspace padrão, pressione Esc.

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

  6. (opcional) Adicione um botão, configure sua propriedade Text para mostrar Entrar, adicione um temporizador e desabilite o controle de texto de entrada por um determinado período de tempo se o usuário digitar a senha errada e, em seguida, clicar ou tocar no botão Entrar .

Diretrizes de acessibilidade

Contraste de cores

Suporte ao leitor de tela

Suporte ao teclado