Compartilhar via

Controle de rótulo no Power Apps

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

Description

Um rótulo mostra os dados que você especifica como uma cadeia de caracteres literal de texto, que aparece exatamente como você digitá-lo 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 – Definido como true para permitir que o rótulo aumente automaticamente sua altura para mostrar todo o texto. Defina como false para truncar o texto à altura atribuída.

Cor – a cor do texto em um controle.

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

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

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

Propriedades adicionais

Alinhar – o local do texto em relação ao centro horizontal de seu controle.

AutoHeight – se um rótulo aumenta automaticamente sua propriedade Height se sua propriedade Text contém mais caracteres do que o controle pode mostrar ao mesmo tempo. Se o controle não estiver visível, a propriedade de saída Height não será atualizada conforme o texto for alterado.

BorderColor – A cor da borda de um controle.

BorderStyle – se a borda de um controle é Solid, Dashed, Dotted ou None.

BorderThickness – A espessura da borda de um controle.

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

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

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

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

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

FocusedBorderColor – A cor da borda de um controle quando o controle está focado.

FocusedBorderThickness – A espessura da borda de um controle quando o controle está focado.

FontWeight – O peso do texto em um controle: Negrito, Semiaberto, Normal ou Mais Leve.

Altura – a distância entre as bordas superior e inferior de um controle.

HoverBorderColor – A cor da borda de um 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.

Itálico – se o texto em um controle é itálico.

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

Ao vivo – como um leitor de tela anuncia alterações no valor da propriedade Text do rótulo.

  • 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 as alterações que ocorreram enquanto o leitor de tela falava.
  • Quando definido como Assertivo, o leitor de tela interrompe a si mesmo para anunciar as alterações que ocorreram enquanto o leitor de tela falava.

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

Estouro – se uma barra de rolagem aparece em um rótulo se sua propriedade Wrap é definida como true e o valor da propriedade Text do controle contém mais caracteres do que o controle pode mostrar ao mesmo tempo.

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 de um 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.

Função – a função semântica do texto do rótulo, como Título 1. Não altera o estilo do rótulo, mas torna a saída semanticamente correta para interpretação por leitores de tela.

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

Tachado – se uma linha aparece por meio do texto que aparece em um controle.

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

Dica de ferramenta – texto explicativo exibido quando o usuário passa o mouse sobre um controle.

Sublinhado – se uma linha aparece sob o texto que aparece em um controle.

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

Visível – se um controle aparece ou está oculto.

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

Encapsulamento – 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 como uma fórmula como esta:
    Hoje()

    Observação

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

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

Neste procedimento, você criará uma coleção, chamada CityPopulations, que contém dados sobre a população de várias cidades da Europa. Em seguida, você mostrará esses 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}, {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. Pressione F5, selecione o botão e pressione Esc.

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

    Quando a galeria é selecionada, o painel direito mostra as opções para essa galeria.

  4. No painel Galeria1 , defina a lista superior como População, defina a lista intermediária como Cidade e defina a lista inferior como País.

Diretrizes de acessibilidade

Apesar de seu nome, um controle Label não precisa ser usado como um rótulo para outro controle. Ele pode ser usado para exibir qualquer parte do 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 às dos botões.

Contraste de cores

Deve haver contraste de cores adequado entre:

Suporte ao leitor de tela

  • O texto deve estar presente.

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

    Observação

    Os leitores de tela tratarão rótuloscomo botões quando TabIndex for zero ou maior.

Suporte à visão baixa

  • O rótulo deverá ser semelhante a um link, se ele for usado como um link.

Suporte ao teclado

  • TabIndex deve 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 devem estar claramente visíveis, se o texto for usado como um botão ou link. Use FocusedBorderColor e FocusedBorderThickness para conseguir isso.
  • Last updated on