PopUp

Funciones

PopUp*	popup_create (void)
void	popup_OnSelect (...)
void	popup_tooltip (...)
void	popup_add_elem (...)
void	popup_set_elem (...)
void	popup_clear (...)
uint32_t	popup_count (...)
void	popup_list_height (...)
void	popup_selected (...)
uint32_t	popup_get_selected (...)
const char_t*	popup_get_text (...)

Los PopUps son botones que tienen asociado un menú desplegable (Figura 1). Aparentemente parecen pushbuttons que al pulsarse muestran una lista de opciones. En ¡Hola PopUp y Combo! tienes un ejemplo de uso.

Utiliza popup_create parar crear un popup.
Utiliza popup_add_elem para añadir un elemento a la lista.
Utiliza popup_OnSelect para responder a la selección.

popup_create ()

Crea un nuevo control de lista desplegable (PopUp button).

PopUp*
popup_create(void);

Retorna

El popup recién creado.

popup_OnSelect ()

Establece un manejador para la selección de un nuevo elemento.

void
popup_OnSelect(PopUp *popup,
               Listener *listener);

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

popup	El popup.
listener	Función callback que se llamará tras seleccionar un nuevo elemento de la lista.

Observaciones

Ver Eventos GUI.

popup_tooltip ()

Asigna un tooltip al control popup.

void
popup_tooltip(PopUp *popup,
              const char_t *text);

popup	El popup.
text	Cadena C UTF8 terminada en carácter nulo `'\0'`.

popup_add_elem ()

Añade un nuevo elemento a la lista desplegable.

void
popup_add_elem(PopUp *popup,
               const char_t *text,
               const Image *image);

popup	El popup.
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.

popup_set_elem ()

Edita un elemento de la lista desplegable.

void
popup_set_elem(PopUp *popup,
               const uint32_t index,
               const char_t *text,
               const Image *image);

popup	El popup.
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.

popup_clear ()

Elimina todos los elementos de la lista desplegable.

void
popup_clear(PopUp *popup);

popup

El popup.

popup_count ()

Obtiene el número de elementos de la lista.

uint32_t
popup_count(const PopUp *popup);

popup

El popup.

Retorna

El número de elementos.

popup_list_height ()

Establece el tamaño de la lista desplegable.

void
popup_list_height(PopUp *popup,
                  const uint32_t elems);

popup	El popup.
elems	Número de elementos visibles. Si el control tiene más, aparecerá una barra de scroll.

popup_selected ()

Establece el elemento seleccionado del popup.

void
popup_selected(PopUp *popup,
               const uint32_t index);

popup	El popup.
index	El elemento a seleccionar. Si pasamos `UINT32_MAX` se quita la selección.

popup_get_selected ()

Obtiene el elemento seleccionado del popup.

uint32_t
popup_get_selected(const PopUp *popup);

popup

El popup.

Retorna

El elemento seleccionado.

popup_get_text ()

Obtiene el texto de un elemento del popup.

const char_t*
popup_get_text(const PopUp *popup,
               const uint32_t index);

popup	El popup.
index	El índice del elemento.

Retorna

El texto del elemento.