Combo

Funciones

Combo*	combo_create (void)
void	combo_OnFilter (...)
void	combo_OnChange (...)
void	combo_text (...)
void	combo_align (...)
void	combo_tooltip (...)
void	combo_color (...)
void	combo_color_focus (...)
void	combo_bgcolor (...)
void	combo_bgcolor_focus (...)
void	combo_phtext (...)
void	combo_phcolor (...)
void	combo_phstyle (...)
const char_t*	combo_get_text (...)
uint32_t	combo_count (...)
void	combo_add_elem (...)
void	combo_set_elem (...)
void	combo_ins_elem (...)
void	combo_del_elem (...)
void	combo_duplicates (...)

Los ComboBox son cajas de edición de texto con lista desplegable (Figura 1). Por tanto, funcionarán de la misma forma que los controles Edit sobre los que se añaden métodos para la gestión de la lista. En ¡Hola PopUp y Combo! tienes un ejemplo de uso.

Utiliza combo_create parar crear un combo.
Utiliza combo_text para establecer el texto de edición.
Utiliza combo_color para establecer el color del texto.
Utiliza combo_bgcolor para establecer el color del fondo.
Utiliza combo_add_elem para añadir un elemento a la lista.

Captura de varios controles ComboBox en una ventana. — Figura 1: Combos en Windows, macOS y Linux.

combo_create ()

Crea un control combo.

Combo*
combo_create(void);

Retorna

El combo.

combo_OnFilter ()

Establece un manejador para filtrar el texto mientras se edita.

void
combo_OnFilter(Combo *combo,
               Listener *listener);

combo	El combo.
listener	Función callback que se llamará tras cada pulsación de tecla. En EvTextFilter de event_result se devolverá el texto filtrado.

Observaciones

Ver Filtrar textos y Eventos GUI.

combo_OnChange ()

Establece un manejador para detectar cuando el texto ha cambiado.

void
combo_OnChange(Combo *combo,
               Listener *listener);

combo	El combo.
listener	Función callback que se llamará cuando el control pierda el foco del teclado, lo que indicará el final de la edición.

Observaciones

Este evento se lanzará también al seleccionar un elemento de la lista, señal que el texto ha cambiado en la caja de edición. Ver Validar textos y Eventos GUI.

combo_text ()

Establece el texto de edición del combo.

void
combo_text(Combo *combo,
           const char_t *text);

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

combo_align ()

Establece la alineación del texto.

void
combo_align(Combo *combo,
            const align_t align);

combo	El combo.
align	La alineación.

combo_tooltip ()

Asigna un tooltip al control combo.

void
combo_tooltip(Combo *combo,
              const char_t *text);

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

combo_color ()

Establece el color del texto del combo.

void
combo_color(Combo *combo,
            const color_t color);

combo	El combo.
color	El color del texto.

Observaciones

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

combo_color_focus ()

Establece el color del texto, cuando el control tiene el foco del teclado.

void
combo_color_focus(Combo *combo,
                  const color_t color);

combo	El combo.
color	El color del texto.

Observaciones

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

combo_bgcolor ()

Establece el color de fondo.

void
combo_bgcolor(Combo *combo,
              const color_t color);

combo	El combo.
color	El color de fondo.

Observaciones

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

combo_bgcolor_focus ()

Establece el color de fondo cuando el control tiene el foco del teclado.

void
combo_bgcolor_focus(Combo *combo,
                    const color_t color);

combo	El combo.
color	El color de fondo.

combo_phtext ()

Establece un texto explicativo para cuando el control está en blanco.

void
combo_phtext(Combo *combo,
             const char_t *text);

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

combo_phcolor ()

Establece el color del texto placeholder.

void
combo_phcolor(Combo *combo,
              const color_t color);

combo	El combo.
color	El color del texto.

combo_phstyle ()

Establece el estilo de la fuente para el placeholder.

void
combo_phstyle(Combo *combo,
              const uint32_t fstyle);

combo	El combo.
fstyle	Combinación de valores de fstyle_t.

combo_get_text ()

Obtiene el texto del control.

const char_t*
combo_get_text(const Combo *combo,
               const uint32_t index);

combo	El combo.
index	El índice del texto. Si es `UINT32_MAX` indica el propio texto del cuadro de edición. Si `>= 0`, indica un texto de la lista.

Retorna

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

combo_count ()

Obtiene el número de elementos en la lista desplegable.

uint32_t
combo_count(const Combo *combo);

combo

El combo.

Retorna

El número de elementos.

combo_add_elem ()

Añade un nuevo elemento a la lista desplegable.

void
combo_add_elem(Combo *combo,
               const char_t *text,
               const Image *image);

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

combo_set_elem ()

Edita un elemento de la lista desplegable.

void
combo_set_elem(Combo *combo,
               const uint32_t index,
               const char_t *text,
               const Image *image);

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

combo_ins_elem ()

Inserta un elemento en la lista desplegable.

void
combo_ins_elem(Combo *combo,
               const uint32_t index,
               const char_t *text,
               const Image *image);

combo	El combo.
index	La posición de inserción.
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.

combo_del_elem ()

Elimina un elemento de la lista desplegable.

void
combo_del_elem(Combo *combo,
               const uint32_t index);

combo	El combo.
index	El índice del elemento a eliminar.

combo_duplicates ()

Impide que hayan textos duplicados en la lista desplegable.

void
combo_duplicates(Combo *combo,
                 const bool_t duplicates);

combo	El combo.
duplicates	`TRUE` para permitir textos duplicados.