SDK Multiplataforma en C logo

SDK Multiplataforma en C

PopUp

❮ Anterior
Siguiente ❯

Funciones

PopUp*popup_create (void)
voidpopup_OnSelect (...)
voidpopup_tooltip (...)
voidpopup_add_elem (...)
voidpopup_set_elem (...)
voidpopup_clear (...)
uint32_tpopup_size (...)
voidpopup_list_height (...)
voidpopup_selected (...)
uint32_tpopup_get_selected (...)

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.
  • Captura de varios controles PopUp en una ventana.
    Figura 1: PopUps en Windows, macOS y Linux.

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);
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_size ()

Obtiene el número de elementos de la lista.

uint32_t
popup_size(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(PopUp *popup);
popup

El popup.

Retorna

El elemento seleccionado.

❮ Anterior
Siguiente ❯