Label

Funciones

Label*	label_create (void)
Label*	label_multiline (void)
void	label_OnClick (...)
void	label_text (...)
void	label_font (...)
void	label_style_over (...)
void	label_align (...)
void	label_color (...)
void	label_color_over (...)
void	label_bgcolor (...)
void	label_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 el código de ejemplo.

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.
Utiliza label_font para establecer la fuente.

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 del 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);

static void i_OnClick(UserData *data, Event *e)
{
    const EvText *p = event_params(e, EvText);
    do_something_onclick(data, p->text);
}
...
label_OnClick(label, listener(data, i_OnClick, UserData));

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.