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.

Propriedades-chave

AutoHeight – defina como verdadeiro 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 no qual o texto é exibido.

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

AtrasarSaída – 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 é Solid, Dashed, Dotted ou None.

BorderThickness – a espessura da borda do controle.

Disabled – se o usuário pode ou não interagir com o controle.

DisabledBorderColor – a cor da borda do controle se a propriedade Disabled do controle estiver definida como true.

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

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

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

FontWeight – o peso do texto em um controle: Bold (negrito), Semibold, Normal ou Lighter (mais leve).

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.

OnSelect – como o aplicativo responde quando o usuário toca ou clica 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.

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.

Tooltip – um texto explicativo aparece 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 das bordas esquerda e direita de um controle.

Wrap – indica se um texto que é longo demais para se ajustar em um rótulo é quebrado na próxima linha.

X – a distância entre a borda esquerda de um controle e a borda esquerda de seu contêiner pai (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 (tela, se não houver contêiner pai).

Funções relacionadas

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, você não usa 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?

Mostrar dados em uma galeria

Neste procedimento, você criará uma coleção, chamada PopulacoesCidades, 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 PopulacoesCidades.

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

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