Tabs

Cabecera

#include <gui/tabs.h>

Funciones

Tabs*	tabs_create (...)
void	tabs_OnSelect (...)
void	tabs_length (...)
void	tabs_tooltip (...)
void	tabs_add_elem (...)
void	tabs_set_elem (...)
void	tabs_ins_elem (...)
void	tabs_del_elem (...)
void	tabs_clear (...)
uint32_t	tabs_count (...)
void	tabs_selected (...)
uint32_t	tabs_get_selected (...)
const char_t*	tabs_get_text (...)
const Image*	tabs_get_image (...)

Los Tabs son controles que muestran una serie de pestañas y que, por norma general, permiten cambiar dinámicamente el contenido de un panel asociado (Figura 1). En ¡Hola TabControl! tienes un ejemplo de esto mismo. Es muy importante remarcar que el control Tab tan solo muestra la lista de elementos y responde a las pulsaciones del usuario, pero no obliga a que existan dichos paneles asociados a las pestañas. Lo que ocurra tras la pulsación es responsabilidad del usuario, por lo que se puede utiliza el control para diferentes menesteres: Por ejemplo, ordenar una tabla mediante diferentes criterios.

Utiliza tabs_create parar crear un control de pestañas.
Utiliza tabs_add_elem para añadir una pestaña.
Utiliza tabs_OnSelect para responder a la selección.

Captura de un control Tabs en una ventana. — Figura 1: Control de pestañas.

tabs_create ()

Crea un nuevo control de pestañas (Tabs).

Tabs*
tabs_create(const gui_pos_t pos);

pos	La orientación del control.

Retorna

El tabs recién creado.

tabs_OnSelect ()

Establece un manejador para la selección de una nueva pestaña.

void
tabs_OnSelect(Tabs *tabs,
              Listener *listener);

static void i_OnSelect(App *app, Event *e)
{
    const EvButton *p = event_params(e, EvButton);
    do_something_onselect(app, p->index);
}
...
tabs_OnSelect(tabs, listener(app, i_OnSelect, App));

tabs	El control de pestañas.
listener	Función callback que se llamará tras seleccionar una nueva pestaña.

Observaciones

Ver Eventos GUI.

tabs_length ()

Establece la longitud por defecto del control.

void
tabs_length(Tabs *tabs,
            const real32_t length);

tabs	El control de pestañas.
length	La longitud (horizontal o vertical).

tabs_tooltip ()

Asigna un tooltip al control de pestañas.

void
tabs_tooltip(Tabs *tabs,
             const char_t *text);

tabs	El control de pestañas.
text	Cadena C UTF8 terminada en carácter nulo `'\0'`.

tabs_add_elem ()

Añade un nuevo elemento al control de pestañas.

void
tabs_add_elem(Tabs *tabs,
              const char_t *text,
              const Image *image);

tabs	El control de pestañas.
text	El texto del elemento en UTF-8 o el identificador del recurso. Recursos.
image	Icono asociado al elemento o el identificador del recurso. Por cuestión de espacio, se escalará a un alto máximo de 16 píxeles. El control conservará una copia de la image. La imagen original debe ser destruida, a no ser que se obtuviese con image_from_resource.

tabs_set_elem ()

Edita un elemento del control de pestañas.

void
tabs_set_elem(Tabs *tabs,
              const uint32_t index,
              const char_t *text,
              const Image *image);

tabs	El control de pestañas.
index	El índice del elemento a sustituir.
text	El texto del elemento en UTF-8 o el identificador del recurso. Recursos.
image	Icono asociado al elemento o el identificador del recurso. Por cuestión de espacio, se escalará a un alto máximo de 16 píxeles.

tabs_ins_elem ()

Inserta un elemento en el control de pestañas.

void
tabs_ins_elem(Tabs *tabs,
              const uint32_t index,
              const char_t *text,
              const Image *image);

tabs	El control de pestañas.
index	El índice del elemento a insertar.
text	El texto del elemento en UTF-8 o el identificador del recurso. Recursos.
image	Icono asociado al elemento o el identificador del recurso. Por cuestión de espacio, se escalará a un alto máximo de 16 píxeles.

Observaciones

Funciona igual que tabs_add_elem, pero insertando en una posición arbitraria, en lugar de al final de la lista.

tabs_del_elem ()

Elimina un elemento del control de pestañas.

void
tabs_del_elem(Tabs *tabs,
              const uint32_t index);

tabs	El control de pestañas.
index	El índice del elemento a eliminar.

tabs_clear ()

Elimina todas las pestañas.

void
tabs_clear(Tabs *tabs);

tabs	El control de pestañas.

tabs_count ()

Obtiene el número de elementos del control de pestañas.

uint32_t
tabs_count(Tabs *tabs);

tabs	El control de pestañas.

Retorna

El número de elementos.

tabs_selected ()

Establece la pestaña seleccionada.

void
tabs_selected(Tabs *tabs,
              const uint32_t index);

tabs	El control de pestañas.
index	El elemento a seleccionar. Si pasamos `UINT32_MAX` se quita la selección.

tabs_get_selected ()

Obtiene el elemento seleccionado del control de pestañas.

uint32_t
tabs_get_selected(const Tabs *tabs);

tabs	El control de pestañas.

Retorna

El elemento seleccionado.

tabs_get_text ()

Obtiene el texto de un elemento del control de pestañas.

const char_t*
tabs_get_text(const Tabs *tabs,
              const uint32_t index);

tabs	El control de pestañas.
index	El índice del elemento.

Retorna

El texto del elemento.

tabs_get_image ()

Obtiene el icono de un elemento del control de pestañas.

const Image*
tabs_get_image(const Tabs *tabs,
               const uint32_t index);

tabs	El control de pestañas.
index	El índice del elemento.

Retorna

El icono (puede ser NULL).