Controlo Introdução de texto no Power Apps

Uma caixa na qual o utilizador pode introduzir texto, números e outros dados.

Descrição

O utilizador pode especificar dados escrevendo num controlo de introdução de texto. Dependendo de como configurar a aplicação, esses dados poderão ser adicionados a uma origem de dados, utilizados para calcular um valor temporário ou incorporados de outro modo.

Propriedades principais

Default – o valor inicial de um controlo antes de ser alterado pelo utilizador.

Text – texto que é apresentado num controlo ou que o utilizador escreve num controlo.

Propriedades adicionais

AccessibleLabel – a etiqueta para os leitores de ecrãs.

Align – a localização de texto em relação ao centro horizontal do seu controlo.

BorderColor – a cor do limite de um controlo.

BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.

BorderThickness – a espessura do limite de um controlo.

Clear – se um controlo de introdução de texto mostra um "X" em que o utilizador pode tocar ou clicar para limpar o conteúdo desse controlo. Funciona apenas no modo SingleLine.

Color – a cor do texto num controlo.

DelayOutput - se definido como verdadeiro, a intervenção do utilizador fica registada após meio segundo de atraso. Útil para adiar operações dispendiosas até que o utilizador conclua a introdução de texto (ou seja, para filtragem quando a introdução é utilizada noutras fórmulas).

DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar), ou está desativado (Desativado).

DisabledBorderColor – a cor do limite de um controlo se a propriedade DisplayMode do controlo estiver definida como Desativada.

DisabledColor – a cor do texto num controlo se a respetiva propriedade DisplayMode estiver definida como Desativada.

DisabledFill – a cor de fundo de um controlo se a respetiva propriedade DisplayMode estiver definida como Desativada.

EnableSpellCheck -se um controlo de entrada de texto deve utilizar a função de verificação ortográfica do browser. Power Apps para o Windows não suporta esta propriedade.

Fill – a cor de fundo de um controlo.

FocusedBorderColor – a cor do limite de um controlo quando o controlo é destacado.

FocusedBorderThickness – a espessura do limite de um controlo quando o controlo é destacado.

Font – o nome da família dos tipos de letra que aparecem no texto.

FontWeight – a espessura do texto num controlo: Negrito, Seminegrito, Normal ou Mais leve.

Format – se a introdução pelo utilizador está restrita só a números ou se pode ser qualquer texto. Quando definido como Número, só é possível introduzir dígitos e determinados símbolos numéricos. Os símbolos e formatos suportados dependem do idioma do browser e não podem ser definidos em controlos individuais.

Height – a distância entre as margens superiores e inferiores de um controlo.

HintText – texto em cinzento claro que aparece num controlo de introdução de texto, se estiver vazio.

HoverBorderColor – a cor do limite de um controlo quando o utilizador mantém o ponteiro do rato nesse controlo.

HoverColor – a cor do texto num controlo quando o utilizador mantém o ponteiro do rato no mesmo.

HoverFill – a cor de fundo de um controlo quando o utilizador mantém o ponteiro do rato no mesmo.

Italic – se o texto num controlo estiver em itálico.

LineHeight – a distância entre, por exemplo, as linhas de texto ou os itens numa lista.

MaxLength – o número de carateres que o utilizador pode escrever num controlo de introdução de texto.

Mode – o controlo está no modo SingleLine, MultiLine ou Palavra-passe.

OnChange – Ações a realizar quando o utilizador altera o valor de um controlo (por exemplo, ao ajustar um controlo de deslize).

OnSelect– Ações a realizar quando o utilizador toca ou clica num controlo.

PaddingBottom – a distância entre o texto num controlo e o limite inferior desse controlo.

PaddingLeft – a distância entre o texto num controlo e o limite esquerdo desse controlo.

PaddingRight – a distância entre o texto num controlo e o limite direito desse controlo.

PaddingTop – a distância entre o texto num controlo e o limite superior desse controlo.

PressedBorderColor – a cor do limite de um controlo quando o utilizador toca ou clica nesse controlo.

PressedColor – a cor do texto num controlo quando o utilizador toca ou clica nesse controlo.

PressedFill – a cor de fundo de um controlo quando o utilizador toca ou clica nesse controlo.

RadiusBottomLeft – o grau a que o canto inferior esquerdo de um controlo é arredondado.

RadiusBottomRight – o grau a que o canto inferior direito de um controlo é arredondado.

RadiusTopLeft – o grau a que o canto superior esquerdo de um controlo é arredondado.

RadiusTopRight – o grau a que o canto superior direito de um controlo é arredondado.

Reset – se um controlo é revertido para o valor predefinido.

Size – o tamanho do tipo de letra do texto que é apresentado num controlo.

Strikethrough – se é apresentada uma linha no meio do texto que aparece num controlo.

TabIndex – a ordem de navegação no teclado em relação a outros controlos.

Tooltip – o texto explicativo que aparece quando o rato passa por cima de um controlo.

Underline – se é apresentada uma linha sob o texto que aparece num controlo.

VirtualKeyboardMode – tipo de teclado virtual, texto ou numérico, que é apresentado no ecrã de toque de um utilizador de aplicações. A propriedade Format determina o valor predefinido. O suporte ao dispositivo varia. Os dispositivos que executam o iOS têm de ter, pelo menos, a versão 12.2. A versão recomendada do Android é 9.0 e as capacidades de teclados numéricos variam para os dispositivos Android. O Windows 10 não suporta esta propriedade.

Visible – se um controlo é apresentado ou está oculto.

Width – a distância entre as margens esquerda e direita de um controlo.

X – a distância entre o limite esquerdo de um controlo e o limite esquerdo do respetivo recipiente principal (do ecrã, se não existir um recipiente principal).

Y – a distância entre o limite superior de um controlo e o limite superior do recipiente principal (do ecrã, se não existir um recipiente principal).

Funções relacionadas

DateTimeValue( String )

Exemplos

Recolher dados

1. Adicione dois controlos de introdução de texto e dê-lhes o nome inputFirst e inputLast.

   Não sabe como adicionar, atribuir um nome e configurar um controlo?

2. Adicione um botão, defina a respetiva propriedade Text para Adicionar e defina a propriedade OnSelect para esta fórmula:
   Collect(Names, {FirstName:inputFirst.Text, LastName:inputLast.Text})

   Pretende obter mais informações sobre a função Collect ou outras funções?

3. Adicione uma galeria de texto na orientação retrato/vertical, defina a respetiva propriedade Items para Nomes, e defina a propriedade Text de Subtitle1 para ThisItem.FirstName.

4. (opcional) Na galeria do modelo, elimine a etiqueta inferior, com o nome Body1e defina a propriedade TemplateSize da galeria para 80.

5. Prima F5, escreva uma cadeia 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, prima Esc para regressar à área de trabalho predefinida.

Pedir uma palavra-passe

1. Adicione um controlo de introdução de texto, dê-lhe o nome inputPassworde defina a respetiva propriedade Mode para Palavra-passe.

2. Adicione uma etiqueta e defina a propriedade Text para esta fórmula:
   If(inputPassword.Text = "P@ssw0rd", "Acesso concedido", "Acesso negado")

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

3. Prima F5 e, em seguida, escreva P@ssw0rd em inputPassword.

   Quando acabar de escrever a palavra-passe, a etiqueta deixa de mostrar Acesso negado e passa a mostrar Acesso concedido.

4. Para voltar à área de trabalho predefinida, prima Esc.

5. (opcional) Adicione um controlo como uma seta, configure-o para navegar para outro ecrã e mostrá-lo apenas depois de o utilizador escrever a palavra-passe.

6. (opcional) Adicione um botão, configure a respetiva propriedade Text para que mostre Iniciar sessão, adicione um temporizador e desative o controlo de introdução de texto durante um determinado período de tempo se o utilizador escrever a palavra-passe incorreta e, em seguida, clica ou toque no botão Iniciar sessão.

Diretrizes de acessibilidade

Contraste de cor

• Aplicam-se os requisitos de contraste de cor padrão.

Suporte a leitor de ecrã

• AccessibleLabel tem de estar presente.

Suporte de teclado

• TabIndex tem de ser zero ou superior para que os utilizadores do teclado possam navegar nele.
• Os indicadores de foco têm de estar claramente visíveis. Utilize FocusedBorderColor e FocusedBorderThickness para o conseguir.