SDK Multiplataforma en C logo

SDK Multiplataforma en C

Combo

❮ Anterior
Siguiente ❯

Funciones

Combo*combo_create (void)
voidcombo_OnFilter (...)
voidcombo_OnChange (...)
voidcombo_text (...)
voidcombo_align (...)
voidcombo_tooltip (...)
voidcombo_color (...)
voidcombo_color_focus (...)
voidcombo_bgcolor (...)
voidcombo_bgcolor_focus (...)
voidcombo_phtext (...)
voidcombo_phcolor (...)
voidcombo_phstyle (...)
const char_t*combo_get_text (...)
uint32_tcombo_count (...)
voidcombo_add_elem (...)
voidcombo_set_elem (...)
voidcombo_ins_elem (...)
voidcombo_del_elem (...)
voidcombo_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.
❮ Anterior
Siguiente ❯

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.

❮ Anterior
Siguiente ❯