Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Uma caixa que mostra dados como texto, números, datas ou moeda.
Description
Um rótulo mostra dados que você especifica como uma cadeia de caracteres literal de texto, que aparece exatamente da maneira como você o digita, ou como uma fórmula que é avaliada como uma cadeia de caracteres de texto. Os rótulos geralmente aparecem fora de qualquer outro controle (como um banner que identifica uma tela), como um rótulo que identifica outro controle (como um controle de classificação ou áudio) ou em uma galeria para mostrar um tipo específico de informação sobre um item.
Propriedades chave
AutoHeight – Defina como true para permitir que o rótulo aumente automaticamente sua altura para mostrar todo o texto. Defina como false para truncar o texto até a altura atribuída.
Cor – A cor do texto em um controle.
Fonte – O nome da família de fontes na qual o texto aparece.
Texto – 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
Alinhar – A localização 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 contiver mais caracteres do que o controle pode mostrar de uma só vez. Se o controle não estiver visível, a propriedade de saída Height não será atualizada à medida que o texto for alterado.
BorderColor – A cor da borda de um controle.
BorderStyle – Se a borda de um controle é Sólida, Tracejada, Pontilhada ou Nenhuma.
BorderThickness – A espessura da borda de um controle.
DisplayMode – Se o controle permite a entrada do usuário (Editar), exibe apenas dados (View) ou está desativado (Disabled).
DisabledBorderColor – A cor da borda de um controle se a propriedade DisplayMode do controle estiver definida como Disabled.
DisabledColor – A cor do texto em um controle se sua propriedade DisplayMode estiver definida como Disabled.
DisabledFill – A cor de plano de fundo de um controle se sua propriedade DisplayMode estiver definida como Disabled.
Preenchimento – A cor de fundo de um controlo.
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, seminegrito, 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 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 está em 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 Polido, 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 interrompe-se para anunciar quaisquer alterações que ocorreram enquanto o leitor de tela estava falando.
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 estiver definida como true e o valor da propriedade Text do controle contiver 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 de fundo de um controlo quando o utilizador toca ou clica nesse controlo.
Função - A função semântica 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 por leitores de tela.
Tamanho – O tamanho da fonte do texto que aparece em um controle.
Tachado – Se uma linha aparece através 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 que aparece quando o usuário passa o mouse sobre um controle.
Sublinhado – Se uma linha aparece 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.
Visível – Se um controle aparece ou está oculto.
Largura – A distância entre as bordas esquerda e direita de um controle.
Quebra automática – Se o texto deve ser quebrado 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
Texto( Número, "FormatCodes" )
Examples
Mostrar uma cadeia de caracteres literal
Adicione um rótulo e defina sua propriedade Text como "Olá, mundo" (incluindo as aspas duplas).
Não sabe como adicionar e configurar um controle?
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
Ao especificar uma fórmula, você não usa aspas, a menos que um argumento da fórmula seja uma cadeia de caracteres literal. Nesse caso, coloque o argumento, e não a fórmula, entre aspas duplas.
Quer mais informações sobre a função Hoje ou outras funções?
Mostrar os dados numa galeria
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á.
Adicione um botão e defina a respetiva propriedade OnSelect a esta fórmula:
ClearCollect(CidadesPopulações, {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})Pressione F5, selecione o botão e pressione Esc.
Adicione uma galeria de texto e defina sua propriedade Items como CityPopulations.
Quando a galeria é selecionada, o painel direito mostra opções para essa galeria.
No painel Galeria1 , defina a lista superior como População, defina a lista do meio como Cidade e defina a lista inferior como País.
Diretrizes de acessibilidade
Apesar do nome, um controle Label não precisa ser usado como rótulo para outro controle. Ele pode ser usado para exibir qualquer pedaço de texto.
Um Label pode ser usado como um botão ou link especificando o comportamento OnSelect . Quando usado dessa forma, há considerações de acessibilidade semelhantes às dos botões.
Contraste de cor
Deve haver um contraste de cor adequado entre:
- Cor e Preenchimento
- Outros requisitos de contraste de cor padrão se aplicam (se usado como um botão ou link)
Suporte a leitor de tela
O texto deve estar presente.
Live deve ser definido como Polite ou Assertive se um leitor de tela deve anunciar alterações no valor da propriedade Text .
Observação
Os leitores de tela tratarão Rótuloss como botões quando TabIndex for zero ou superior.
Suporte para baixa visão
-
O rótulo deve se parecer com um link, se for usado como um link.
- Definir sublinhado como verdadeiro
- HoverColor deve ser diferente de Color
Suporte de teclado
- TabIndex deve ser zero ou maior, se o texto for usado como um botão ou link. Isso permite que os usuários do teclado naveguem até ele.
- Os indicadores de foco devem ser claramente visíveis, se o texto for usado como um botão ou link. Use FocusedBorderColor e FocusedBorderThickness para conseguir isso.