Controlo da etiqueta no Power Apps

Uma caixa que mostra os dados, como o texto, números, datas ou a moeda.

Descrição

Uma etiqueta mostra os dados que especificar como uma cadeia literal de texto, que aparece exatamente da forma como escrever, ou como uma fórmula que é calculada como uma cadeia de texto. Frequentemente, as etiquetas aparecem fora de qualquer outro controlo (por exemplo, uma faixa que identifica um ecrã), como uma etiqueta que identifica outro controlo (como um controlo de classificação ou áudio), ou numa galeria para mostrar um tipo específico de informações sobre um item.

Propriedades principais

AutoHeight – defina como verdadeiro para permitir o aumento automático da altura da etiqueta, para mostrar todo o texto. Definido como falso para truncar o texto para a altura atribuída.

Color – a cor do texto num controlo.

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

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

DelayOutput – defina como verdadeiro para atrasar a ação durante a introdução de texto.

Propriedades adicionais

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

AutoHeight – se uma etiqueta aumenta automaticamente a respetiva propriedade Height, se a respetiva propriedade Text contiver mais carateres do que aqueles que o controlo pode mostrar de uma só vez.

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.

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.

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.

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

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

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.

Live – como um ecrã leitor anuncia alterações ao valor da propriedade Text da etiqueta.

• Quando definido como desativado, o ecrã leitor não anuncia alterações.
• Quando definido como Educado, o ecrã leitor termina de falar antes de anunciar as alterações que ocorreram enquanto o ecrã Leitor estava em fala.
• Quando definido como Assertivo, o ecrã leitor é interrompido para anunciar quaisquer alterações que tenham ocorrido enquanto o ecrã Leitor estava em fala.

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

Overflow – se uma barra de deslocamento aparecer numa etiqueta caso a respetiva propriedade Wrap esteja definida para verdadeiro e o valor da propriedade Text do controlo contiver mais carateres do que o controlo pode mostrar de uma só vez.

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.

Role - a função semântica do texto da etiqueta, tal como título 1. Não altera o estilo da etiqueta, mas faz com que a saída seja corrigida semanticamente para interpretação por leitores de ecrã.

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.

VerticalAlign – a localização de texto num controlo em relação ao centro vertical desse controlo.

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

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

Wrap – indica se o texto deve ser encapsulado em várias linhas.

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

Text( Número, "FormatCodes")

Exemplos

Mostrar uma cadeia literal

• Adicione uma etiqueta e defina a respetiva propriedade Text para "Olá, mundo" (incluindo as aspas).

  Não sabe como adicionar e configurar um controlo?

Mostrar o resultado de uma fórmula

• Adicione uma etiqueta e defina a respetiva propriedade Text para uma fórmula como esta:
  Today()

  Nota

  Ao especificar uma fórmula, não utilize aspas, a menos que um argumento da fórmula seja uma cadeia literal. Nesse caso, coloque o argumento, não a fórmula, entre aspas.

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

Mostrar os dados numa galeria

Neste procedimento, irá criar uma coleção, chamada CityPopulations, que contém dados sobre a população de várias cidades na Europa. Em seguida, irá mostrar os dados numa galeria que contém três etiquetas e vai especificar o tipo de dados que cada etiqueta irá mostrar.

1. Adicione um botão e defina a respetiva propriedade OnSelect a esta fórmula:
   ClearCollect(CityPopulations, {Cidade:"Londres", país:"Reino Unido", população:8615000}, {Cidade:"Berlim", país:"Alemanha", população:3562000}, {Cidade:"Madrid", país:"Espanha", população:3165000}, {cidade:"Roma", país:"Itália", população:2874000}, {Cidade:"Paris", país:"França", população:2273000}, {Cidade:"Hamburgo", país:"Alemanha", população:1760000}, {Cidade:"Barcelona", país:"Espanha", população:1602000}, {Cidade:"Munique", país:"Alemanha", população:1494000}, {Cidade:"Milão", país:"Itália", população:1344000})

2. Prima F5, selecione o botão e, em seguida, prima Esc.

3. Adicione uma galeria de texto e defina a propriedade Items para CityPopulations.

   Quando a galeria estiver selecionada, o painel direito mostra as opções dessa galeria.

4. No painel Gallery1, defina a lista superior para População, defina a lista do meio para Cidade e defina a lista inferior para País.

Diretrizes de acessibilidade

Apesar do nome, um controlo Etiqueta não precisa de ser utilizado como uma etiqueta por outro controlo. Ele pode ser utilizado para apresentar qualquer elemento de texto.

Uma Etiqueta pode ser utilizada como um botão ou ligação ao especificar o comportamento OnSelect. Quando utilizada desta forma, existem considerações de acessibilidade semelhantes às dos botões.

Contraste de cor

Tem de existir contraste de cor adequado entre:

• Color e Fill
• Aplicam-se outros requisitos de contraste de cor padrão (se for utilizado como um botão ou uma ligação)

Suporte a leitor de ecrã

• Text tem de estar presente.

• Live deve ser definido como Educado ou Assertivo se um leitor de ecrã deve anunciar alterações ao valor propriedade de Text.

  Nota

  Os leitores de ecrã tratarão as Etiqueta como botões quando TabIndex for igual a zero ou superior.

Suporte para visão reduzida

• Etiqueta deverá ter o aspeto de uma ligação se for utilizada como uma ligação.
  • Defina Underline como true
  • HoverColor deve ser diferente de Color

Suporte de teclado

• TabIndex terá de ser zero ou superior se o texto for utilizado como um botão ou uma ligação. Esta definição permite que os utilizadores de teclado naveguem até ele.
• Os indicadores de foco terão de estar claramente visíveis se o texto for utilizado como um botão ou uma ligação. Utilize FocusedBorderColor e FocusedBorderThickness para o conseguir.