Controle 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.
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
Exemplos
Coletar dados
Adicione dois controles de entrada de texto e nomeie-os inputFirst e inputLast.
Não sabe como adicionar, nomear e configurar um controle?
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?
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.
(opcional) Na galeria de modelos, exclua o rótulo inferior, chamado Body1, e defina a propriedade TemplateSize da galeria como 80.
Pressione F5, digite uma cadeia de caracteres de texto em inputFirst e inputLast e, em seguida, clique ou toque no botão Adicionar.
(opcional) Adicione mais nomes à coleção e, em seguida, pressione Esc para retornar ao workspace padrão.
Solicitar uma senha
Adicionar um controle de entrada de texto, nomeie-o inputPassworde defina sua propriedade Mode como Password.
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?
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.
Para retornar ao espaço de trabalho padrão, pressione Esc.
(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.
(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
- Os requisitos de contraste de cores padrão se aplicam.
Suporte ao leitor de tela
- AccessibleLabel precisa estar presente.
Suporte de teclado
- TabIndex deve ser zero ou maior para que os usuários de teclado possam navegar para ela.
- Os indicadores de foco precisam ser evidentes. Use FocusedBorderColor e FocusedBorderThickness para fazer isso.
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).