SDK Multiplataforma en C logo

SDK Multiplataforma en C

Label

❮ Anterior
Siguiente ❯

Funciones

Label*label_create (void)
Label*label_multiline (void)
voidlabel_OnClick (...)
voidlabel_text (...)
voidlabel_font (...)
voidlabel_style_over (...)
voidlabel_align (...)
voidlabel_color (...)
voidlabel_color_over (...)
voidlabel_bgcolor (...)
voidlabel_bgcolor_over (...)

Los controles Label sirven para insertar pequeños bloques de texto en ventanas y formularios. Son de formato uniforme, es decir, los atributos de fuente y color se aplicarán a la totalidad del texto. En la mayoría de ocasiones el contenido estará limitado a una sola línea, aunque es posible mostrar bloques que se extiendan en varias de ellas. El tamaño del control se ajustará al del texto que contiene (Figura 1). En ¡Hola Label! tienes un ejemplo de uso.

  • Utiliza label_create para crear un control de texto.
  • Utiliza label_multiline para crear un control multilínea.
  • Utiliza label_align para establecer la alineación interna del texto dentro del control.
  • Captura de una ventana con varios controles label.
    Figura 1: Controles Label.

En el caso que la columna del Layout tenga un ancho menor que el propio texto, se mostrarán unos puntos (elípsis) en el punto de corte (Figura 2), salvo en labels multilínea, que se expandirán verticalmente para dar cabida a todo el texto (Figura 3).

Controles label con el ancho menor que el texto.
Figura 2: Ajuste del texto al reducir el ancho del control.
Controles label multilínea.
Figura 3: Los Labels multilínea se expandirán verticalmente para dar cabida a todo el texto.

En (Figura 4) tenemos un ejemplo del uso de Label en formularios. Si fuera necesario, podemos hacer que los textos sean sensibles al ratón variando su estilo y colores (Figura 5).

  • Utiliza label_style_over para cambiar el estilo de la fuente.
  • Utiliza label_color_over para cambiar color del texto.
  • Utiliza label_bgcolor_over para cambiar color del fondo.
  • Utiliza label_OnClick para responder a un clic en el texto.
  • Captura de un sencillo formulario.
    Figura 4: Uso de Label simples y multilínea en formularios.
    Varias etiquetas de texto con el puntero del ratón sobre una de ellas.
    Figura 5: Controles Label sensibles al ratón.

label_create ()

Crea un control de texto.

Label*
label_create(void);

Retorna

El nuevo Label.


label_multiline ()

Crea un control de texto multilínea.

Label*
label_multiline(void);

Retorna

El nuevo Label.


label_OnClick ()

Establece el manejador del evento OnClick.

void
label_OnClick(Label *label,
              Listener *listener);
label

El Label.

listener

Manejador del evento.

Observaciones

Ver Eventos GUI.


label_text ()

Establece el texto que mostrará la etiqueta.

void
label_text(Label *label,
           const char_t *text);
label

El Label.

text

Cadena C UTF8 terminada en carácter nulo '\0'.


label_font ()

Establece la fuente del texto.

void
label_font(Label *label,
           const Font *font);
label

El Label.

font

Fuente tipográfica.


label_style_over ()

Establece los modificadores de fuente, cuando el ratón está sobre el control.

void
label_style_over(Label *label,
                 const uint32_t style);
label

El Label.

style

Combinación de valores fstyle_t.


label_align ()

Establece la alineación horizontal del texto con respecto al tamaño del control.

void
label_align(Label *label,
            const align_t align);
label

El Label.

align

La alineación.


label_color ()

Establece el color del texto.

void
label_color(Label *label,
            const color_t color);
label

El Label.

color

El color.

Observaciones

Los valores RGB puede que no sean del todo portables. Ver Colores.


label_color_over ()

Establece el color del texto, cuando el ratón está sobre el control.

void
label_color_over(Label *label,
                 const color_t color);
label

El Label.

color

El color.

Observaciones

Los valores RGB puede que no sean del todo portables. Ver Colores.


label_bgcolor ()

Establece el color de fondo del texto.

void
label_bgcolor(Label *label,
              const color_t color);
label

El Label.

color

El color.

Observaciones

Los valores RGB puede que no sean del todo portables. Ver Colores.


label_bgcolor_over ()

Establece el color de fondo del texto, cuando el ratón está sobre el control.

void
label_bgcolor_over(Label *label,
                   const color_t color);
label

El Label.

color

El color.

Observaciones

Los valores RGB puede que no sean del todo portables. Ver Colores.

❮ Anterior
Siguiente ❯