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
Exemplos
Recolher dados
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?
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?
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.
(opcional) Na galeria do modelo, elimine a etiqueta inferior, com o nome Body1e defina a propriedade TemplateSize da galeria para 80.
Prima F5, escreva uma cadeia 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, prima Esc para regressar à área de trabalho predefinida.
Pedir uma palavra-passe
Adicione um controlo de introdução de texto, dê-lhe o nome inputPassworde defina a respetiva propriedade Mode para Palavra-passe.
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?
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.
Para voltar à área de trabalho predefinida, prima Esc.
(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.
(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.
Nota
Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)
O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).