Controle Rótulo no Power Apps

  • Artigo

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

Descrição

Um rótulo mostra os dados especificados como uma cadeia de caracteres literal de texto, que é exibido exatamente como você o digita, ou como uma fórmula que é avaliada como uma cadeia de caracteres de texto. Os rótulos costumam ser exibidos fora de qualquer outro controle (como uma faixa que identifica uma tela), como um rótulo que identifica outro controle (como um controle de classificação ou de áudio), ou em uma galeria para mostrar um tipo específico de informações sobre um item.

Principais propriedades

AutoHeight – defina como true para permitir que o rótulo aumente sua altura automaticamente para mostrar todo o texto configurado. Defina como false para truncar o texto na altura atribuída.

Color – a cor do texto em um controle.

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

Text – texto que aparece em um controle ou que o usuário digita em um controle.

DelayOutput – defina como true para atrasar a ação durante a entrada de texto.

Propriedades adicionais

Align – a localização do texto em relação ao centro horizontal do respectivo controle.

AutoHeight – indica se um rótulo aumenta automaticamente sua propriedade Height caso sua propriedade Text contenha mais caracteres do que o controle pode mostrar de uma vez.

BorderColor – a cor da borda do controle.

BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – a espessura da borda do controle.

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

DisabledBorderColor – a cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Desabilitado.

DisabledColor – a cor do texto em um controle se sua propriedade DisplayMode estiver definida como Desabilitado.

DisabledFill – a cor da tela de fundo de um controle se sua propriedade DisplayMode estiver definida como Desabilitado.

Fill – a cor da tela de fundo de um controle.

FocusedBorderColor – a cor da borda do controle quando ele está focalizado.

FocusedBorderThickness – A espessura da borda de um controle quando ele está focalizado.

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

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

HoverBorderColor – a cor da borda do 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.

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

LineHeight – a distância entre, por exemplo, linhas de texto ou itens em uma lista.

Live – Como um leitor de tela anuncia alterações no valor da propriedade Text.

  • Quando definido como Desativado, o leitor de tela não anuncia alterações.
  • Quando definido como Educado, o leitor de tela termina de falar antes de anunciar quaisquer alterações que ocorreram enquanto o leitor de tela estava falando.
  • Quando definido como Assertivo, o leitor de tela termina de falar antes de anunciar quaisquer alterações que ocorreram enquanto o leitor de tela estava falando.

OnSelect – Ações a serem executadas quando o usuário tocar ou clicar em um controle.

Overflow – indica se uma barra de rolagem é exibida em um rótulo, caso sua propriedade Wrap seja definida como true e o valor da propriedade Text do controle contenha mais caracteres do que o controle pode exibir de uma vez.

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

Role - O papel semântico do texto do rótulo, como o Título 1. Não altera o estilo do rótulo, mas torna a saída semanticamente correta para interpretação pelos leitores de tela.

Size – o tamanho da fonte do texto que aparece em um controle.

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

TabIndex – ordem de navegação do teclado em relação a outros controles.

Tooltip – texto explicativo exibido quando o usuário passa o mouse sobre um controle.

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

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

Visible – se um controle é exibido ou está oculto.

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

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

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

Text( Number, "FormatCodes" )

Exemplos

Mostrar uma cadeia de caracteres literal

Mostrar o resultado de uma fórmula

  • Adicione um rótulo e defina sua propriedade Text com uma fórmula como esta:
    Today()

    Observação

    Quando você especificar uma fórmula, não use aspas, a menos que um argumento da fórmula seja uma cadeia de caracteres literal. Nesse caso, coloque o argumento, não a fórmula, entre aspas duplas.

    Deseja saber mais sobre a função Today ou sobre outras funções?

Neste procedimento, você criará uma coleção, chamada CityPopulations, que contém dados sobre a população de várias cidades na Europa. Em seguida, você mostrará os dados em uma galeria que contém três rótulos e especificará o tipo de dados que cada rótulo mostrará.

  1. Adicione um botão e defina a propriedade OnSelect para esta fórmula:
    ClearCollect(CityPopulations, {City:"London", Country:"United Kingdom", Population:8615000}, {City:"Berlin", Country:"Germany", Population:3562000}, {City:"Madrid", Country:"Spain", Population:3165000}, {City:"Rome", Country:"Italy", Population:2874000}, {City:"Paris", Country:"France", Population:2273000}, {City:"Hamburg", Country:"Germany", Population:1760000}, {City:"Barcelona", Country:"Spain", Population:1602000}, {City:"Munich", Country:"Germany", Population:1494000}, {City:"Milan", Country:"Italy", Population:1344000})

  2. Pressione F5, selecione o botão e pressione Esc.

  3. Adicione uma galeria de texto e defina sua propriedade Items como CityPopulations.

    Com a galeria selecionada, o painel direito mostra opções para essa galeria.

  4. No painel Gallery1, defina a lista superior como Population, defina a lista do meio como Citye defina a lista inferior como City.

Diretrizes de acessibilidade

Apesar do nome, um controle Rótulo não precisa ser usado como um rótulo para outro controle. Ele pode ser usado para exibir qualquer texto.

Um Rótulo pode ser usado como um botão ou link especificando o comportamento de OnSelect. Quando usado dessa forma, há considerações de acessibilidade semelhantes, como com botões.

Contraste de cores

É necessário haver um contraste de cores adequado entre:

Suporte ao leitor de tela

  • Text precisa estar presente.

  • Live deve ser definido como Educado ou Assertivo se um leitor de tela anunciar alterações no valor da propriedade Text.

    Observação

    Leitores de tela tratarão Rótulo como botões quando TabIndex for zero ou maior.

Suporte à deficiência visual

  • O Rótulo deverá se parecer com um link, se for usado como um.

Suporte de teclado

  • TabIndex precisará ser zero ou maior se o texto for usado como um botão ou link. Isso permite que os usuários de teclado naveguem até ele.
  • Os indicadores de foco precisarão ser evidentes se o texto for usado como um botão. Use FocusedBorderColor e FocusedBorderThickness para fazer isso.

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).