Controle moderno Entrada de texto no Power Apps (versão preliminar)

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

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 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. As principais propriedades para esse controle são Value, Mode e ValidationState.

Geral

PlaceHolder – texto instrutivo que aparece se nenhuma data for inserida.

AccessibleLabel — rótulo para leitores de tela.

Visible – determina se um controle é exibido ou se fica oculto.

Comportamental

Mode – o controle está no modo SingleLine ou MultiLine

Type – o tipo de texto inserido, como texto, senha ou pesquisa.

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

TriggerOutput - Quando o controle atualiza seu Valor e dispara OnChange.

• Atrasado - atualiza o valor do controle quando o usuário pausa a digitação.
• FocusOut - atualiza o valor do controle quando o usuário seleciona um controle diferente ou clica fora do controle.
• Pressionamento de tecla - Atualiza o valor do controle imediatamente em cada entrada de caractere.

Tamanho e posição

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

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

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

Estilo e tema

BasePaletteColor – a paleta de cores aplicada a um controle. Isso afeta todas as superfícies do controle que renderizam uma cor de tema.

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

FontSize – o tamanho da fonte do texto que aparece em um controle. Se o valor for nulo ou zero, o tamanho da fonte será determinado pelo tema do Fluent selecionado.

FontColor – a cor do texto em um controle.

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

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

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

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

Align – a localização do texto em um controle em relação ao centro vertical desse controle.

Propriedades adicionais

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

Obrigatório – se deve ou não ser inserido no campo.

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, como filtrar quando a entrada é usada em outras fórmulas.

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

OnChange – ações a serem realizadas quando o usuário altera o valor de um controle.

ValidationState – o controle tem dois estados, que são Erro e Nenhum. Quando o estado de erro é selecionado, a borda do controle fica realçada em vermelho.