Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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).
Funções relacionadas
Exemplos
Coletar dados
Adicione dois controles de entrada de texto e nomeie-os como inputFirst e inputLast.
Não sabe como adicionar, nomear e configurar um controle?
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?
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.
(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 clique ou toque no botão Adicionar .
(opcional) Adicione mais nomes à coleção e pressione Esc para retornar ao workspace padrão.
Solicitar uma senha
Adicione um controle de entrada de texto, nomeie-o inputPassword e 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 obter mais informações sobre a função If ou outras funções?
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.
Para retornar ao workspace padrão, pressione Esc.
(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.
(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
- Os requisitos de contraste de cores padrão se aplicam.
Suporte ao leitor de tela
- AccessibleLabel deve estar presente.
Suporte ao teclado
- TabIndex deve ser zero ou maior para que os usuários de teclado possam navegar até ele.
- Indicadores de foco devem estar claramente visíveis. Use FocusedBorderColor e FocusedBorderThickness para conseguir isso.