Control de etiqueta en aplicacións de lenzo

Caixa que mostra datos como texto, números, datas ou moeda.

Descripción

Unha etiqueta mostra os datos que especifica como unha cadea de texto literal, que aparece exactamente como a escribe ou como unha fórmula que avalía unha cadea de texto. As etiquetas con frecuencia aparecen fóra de calquera outro control (como unha faixa que identifica unha pantalla), como unha etiqueta que identifica outro control (como unha clasificación ou control de audio) ou nunha galería para mostrar un tipo específico de información sobre un elemento.

Propiedades clave

AutoHeight - Estableza este valor como verdadeiro para permitir que a etiqueta faga medrar automaticamente a súa altura para mostrar todo o texto. Estableza en falso para truncar o texto á altura asignada.

Cor – A cor do texto dun control.

Tipo de letra - O nome da familia de tipos de letra na que aparece o texto.

Texto - Texto que aparece nun control ou que o usuario introduce nun control.

DelayOutput: establézao como verdadeiro para retrasar a acción durante a entrada de texto.

Propiedades adicionais

Aliñar - A localización do texto en relación co centro horizontal do seu control.

AutoHeight: se unha etiqueta aumenta automaticamente a súa propiedade Height se a súa propiedade Texto contén máis caracteres dos que o control pode mostrar dunha vez.

BorderColor: cor do bordo dun control.

BorderStyle: se un bordo dun control é Sólido, A trazos, Punteado ou Ningún.

BorderThickness: grosor do bordo dun control.

DisplayMode: se o control permite a entrada do usuario (Editar), só mostra datos (Ver) ou está desactivado (Desactivado).

DisabledBorderColor – A cor do bordo dun control se a propiedade DisplayMode do control está establecida en Desactivado.

DisabledColor – A cor do texto dun control se a súa propiedade DisplayMode está establecida en Desactivado.

DisabledFill – A cor de fondo dun control se a súa propiedade DisplayMode está establecida en Desactivado.

Enchemento: a cor de fondo dun control.

FocusedBorderColor: a cor do bordo dun control cando o control está enfocado.

FocusedBorderThickness: o grosor do bordo dun control cando o control está enfocado.

FontWeight – Espesura do texto nun control: Negra, Semibold, Normal ou Máis claro.

Altura: distancia entre os bordos superior e inferior dun control.

HoverBorderColor – A cor do bordo dun control cando o usuario mantén o punteiro do rato sobre ese control.

HoverColor – A cor do texto dun control cando o usuario mantén o punteiro do rato sobre el.

HoverFill – A cor de fondo dun control cando o usuario mantén o punteiro do rato sobre el.

Cursiva - Se o texto dun control está en cursiva.

LineHeight - A distancia entre, por exemplo, liñas de texto ou elementos dunha lista.

En directo - Como anuncia un lector de pantalla cambios no valor da propiedade Text da etiqueta.

  • Cando está configurado en Desactivado, o lector de pantalla non anuncia cambios.
  • Cando está configurado en Educado, o lector de pantalla acaba de falar antes de anunciar os cambios ocorridos mentres falaba o lector de pantalla.
  • Cando está configurado en Seguro, o lector de pantalla interrómpese a si mesmo para anunciar os cambios ocorridos mentres falaba o lector de pantalla.

OnSelect: Como responde a aplicación cando o usuario toca ou fai clic nun control.

Desbordamento: se unha barra de desprazamento aparece nunha etiqueta se a súa propiedade Axuste se define en verdadeiro e o valor da propiedade Texto do control contén máis caracteres dos que o control pode mostrar dunha vez.

PaddingBottom - A distancia entre o texto dun control e o bordo inferior dese control.

PaddingLeft - A distancia entre o texto dun control e o bordo esquerdo dese control.

PaddingRight - A distancia entre o texto dun control e o bordo dereito dese control.

PaddingTop - A distancia entre o texto dun control e o bordo superior dese control.

PressedBorderColor – A cor do bordo dun control cando o usuario toca ou fai clic nese control.

PressedColor – A cor do texto dun control cando o usuario toca ou fai clic nese control.

PressedFill – A cor de fondo dun control cando o usuario toca ou fai clic nese control.

Papel - O papel semántico do texto da etiqueta, como o Título 1. Non cambia o estilo da etiqueta, pero fai a saída semanticamente correcta para que sexa interpretada polos lectores de pantalla.

Tamaño - O tamaño do tipo de letra do texto que aparece nun control.

Strikethrough - Se unha liña aparece a través do texto que aparece nun control.

TabIndex - Orde de navegación do teclado en relación con outros controis.

Información sobre ferramentas: texto explicativo que aparece cando o usuario pasa o cursor do rato sobre un control.

Underline - Se unha liña aparece baixo o texto que aparece nun control.

VerticalAlign - A localización do texto nun control en relación co centro vertical dese control.

Visible: se aparece un control ou está oculto.

Largura: distancia entre os bordos esquerdo e dereito dun control.

Axuste: se un texto é demasiado longo para caber nunha etiqueta, axústase na liña seguinte.

X: A distancia entre o bordo esquerdo dun control e o bordo esquerdo do seu contedor principal (pantalla, se non hai ningún contedor principal).

Y: A distancia entre o bordo superior dun control e o bordo superior do contedor principal (pantalla, se non hai ningún contedor principal).

Text( Number, "FormatCodes" )

Exemplos

Amosa unha cadea literal

Amosar o resultado dunha fórmula

  • Engada unha etiqueta e configure a súa propiedade Text nunha fórmula como esta:
    Today()

    Nota

    Cando especifique unha fórmula, non empregue comiñas a menos que un argumento da fórmula sexa unha cadea literal. Nese caso, inclúa o argumento, non a fórmula, entre comiñas dobres.

    Quere obter máis información sobre a función Today ou outras funcións?

Neste procedemento, creará unha colección chamada CityPopulations que contén datos sobre a poboación de varias cidades de Europa. A continuación, mostrará eses datos nunha galería que contén tres etiquetas e especificará o tipo de datos que mostrará cada etiqueta.

  1. Engada un botón e axuste a súa propiedade OnSelect nesta 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. Pulse F5, seleccione o botón e, a continuación, prema Esc.

  3. Engada unha galería de texto e configure a súa propiedade Items en CityPopulations.

    Cando se seleccione a galería, o panel dereito mostra as opcións desa galería.

  4. No panel Galería1, estableza a lista superior en Poboación, estableza a lista do medio en Cidade e configure a lista inferior en País.

Directrices de accesibilidade

A pesar do seu nome, non ten que usarse un control de Etiqueta como etiqueta para outro control. Pódese usar para amosar calquera texto.

Pódese usar unha Etiqueta como botón ou ligazón especificando o comportamento de OnSelect. Cando se utiliza desta maneira, hai consideracións de accesibilidade similares ás dos botóns.

Contraste de cor

Debe haber un contraste de cor adecuado entre:

Soporte do lector de pantalla

  • O Texto debe estar presente.

  • En directo debe axustarse en Educado ou Asertivo se un lector de pantalla debe anunciar cambios no valor da propiedade Text.

    Nota

    Os lectores de pantalla tratarán as Etiquetas como botóns cando TabIndex sexa igual a cero ou superior.

Soporte de visión reducida

  • Etiqueta debe parecer unha ligazón, se se usa como ligazón.

Compatibilidade do teclado

  • TabIndex debe ser igual a cero ou superior se o texto se utiliza como botón ou ligazón. Isto permite aos usuarios do teclado navegar ata el.
  • Os indicadores de enfoque deben estar claramente visibles se o texto se usa como botón ou ligazón. Use FocusedBorderColor e FocusedBorderThickness para conseguilo.