Combobox example

In this example we will create a combobox with 1000 items.

We will start with the normal creation of window stuff:

//Compile with:
//gcc -o combobox_example_01 combobox_example_01.c -g `pkg-config --cflags --libs elementary`
#ifndef _GNU_SOURCE
# define _GNU_SOURCE
#endif
#include <string.h>
#include <Elementary.h>
static void
_combobox_clicked_cb(void *data EINA_UNUSED, Evas_Object *obj EINA_UNUSED,
void *event_info EINA_UNUSED)
{
printf("Hover button is clicked and 'clicked' callback is called.\n");
}
static void
_combobox_selected_cb(void *data EINA_UNUSED, Evas_Object *obj EINA_UNUSED,
void *event_info)
{
const char *txt = elm_object_item_text_get(event_info);
printf("'selected' callback is called. (selected item : %s)\n", txt);
}
static void
_combobox_dismissed_cb(void *data EINA_UNUSED, Evas_Object *obj EINA_UNUSED,
void *event_info EINA_UNUSED)
{
printf("'dismissed' callback is called.\n");
}
static void
_combobox_expanded_cb(void *data EINA_UNUSED, Evas_Object *obj EINA_UNUSED,
void *event_info EINA_UNUSED)
{
printf("'expanded' callback is called.\n");
}
static void
_combobox_item_pressed_cb(void *data EINA_UNUSED, Evas_Object *obj,
void *event_info)
{
const char *txt = elm_object_item_text_get(event_info);
printf("'item,pressed' callback is called. (selected item : %s)\n", txt);
elm_object_text_set(obj, txt);
elm_combobox_hover_end(obj);
}
static char *
gl_text_get(void *data, Evas_Object *obj EINA_UNUSED, const char *part EINA_UNUSED)
{
char buf[256];
snprintf(buf, sizeof(buf), "Item # %i", (int)(uintptr_t)data);
return strdup(buf);
}
static Eina_Bool gl_state_get(void *data EINA_UNUSED,
const char *part EINA_UNUSED)
{
return EINA_FALSE;
}
static Eina_Bool
gl_filter_get(void *data, Evas_Object *obj EINA_UNUSED, void *key)
{
// if the key is empty/NULL, return true for item
if (!strlen((char *)key)) return EINA_TRUE;
char buf[256];
snprintf(buf, sizeof(buf), "Item # %i", (int)(uintptr_t)data);
if (strcasestr(buf, (char *)key))
return EINA_TRUE;
// Default case should return false (item fails filter hence will be hidden)
return EINA_FALSE;
}
EAPI_MAIN int
elm_main(int argc EINA_UNUSED, char **argv EINA_UNUSED)
{
Evas_Object *win, *bg;
win = elm_win_util_standard_add("combobox", "Combobox");
bg = elm_bg_add(win);
#define EVAS_HINT_EXPAND
Use with evas_object_size_hint_weight_set(), evas_object_size_hint_weight_get(), evas_object_size_hin...
Definition: Evas_Common.h:297
#define EVAS_HINT_FILL
Use with evas_object_size_hint_align_set(), evas_object_size_hint_align_get(), evas_object_size_hint_...
Definition: Evas_Common.h:298
#define EINA_TRUE
boolean value TRUE (numerical value 1)
Definition: eina_types.h:539
#define EINA_FALSE
boolean value FALSE (numerical value 0)
Definition: eina_types.h:533
unsigned char Eina_Bool
Type to mimic a boolean.
Definition: eina_types.h:527
#define EINA_UNUSED
Used to indicate that a function parameter is purposely unused.
Definition: eina_types.h:339
Evas_Object * elm_bg_add(Evas_Object *parent)
Adds a new background to the parent.
Definition: efl_ui_bg.c:304
Eina_Bool elm_policy_set(unsigned int policy, int value)
Set a new policy's value (for a given policy group/identifier).
Definition: elm_main.c:1380
@ ELM_POLICY_QUIT_LAST_WINDOW_CLOSED
quit when the application's last window is closed
Definition: elm_general.h:248
@ ELM_POLICY_QUIT
under which circumstances the application should quit automatically.
Definition: elm_general.h:227
Evas_Object * elm_win_util_standard_add(const char *name, const char *title)
Adds a window object with standard setup.
Definition: efl_ui_win.c:9582
void elm_win_resize_object_add(Eo *obj, Evas_Object *subobj)
Add subobj as a resize object of window obj.
Definition: efl_ui_win.c:8997
void elm_win_autodel_set(Eo *obj, Eina_Bool autodel)
Set the window's autodel state.
Definition: efl_ui_win.c:6194
EVAS_API void evas_object_show(Evas_Object *eo_obj)
Makes the given Evas object visible.
Definition: evas_object_main.c:1814
EVAS_API void evas_object_size_hint_weight_set(Evas_Object *obj, double x, double y)
Sets the hints for an object's weight.
Definition: evas_object_main.c:2638
Efl_Canvas_Object Evas_Object
An Evas Object handle.
Definition: Evas_Common.h:185
EVAS_API void evas_object_size_hint_align_set(Evas_Object *obj, double x, double y)
Sets the hints for an object's alignment.
Definition: evas_object_main.c:2650
EVIL_API char * strcasestr(const char *haystack, const char *needle)
Locate a substring into a string, ignoring case.
Definition: evil_string.c:17

Next we will create a box.

Evas_Object * elm_box_add(Evas_Object *parent)
Add a new box to the parent.
Definition: elm_box.c:363

And now we create our combobox and set some of it's properties. We set win as its parent, set a text "A Simple List" (which acts as a placeholder). We pack the combobox in box.

Evas_Object *combobox = elm_combobox_add(win);
elm_object_part_text_set(combobox, "guide", "A Simple list");
elm_box_pack_end(bx, combobox);
evas_object_show(combobox);
void elm_box_pack_end(Elm_Box *obj, Efl_Canvas_Object *subobj)
Add an object at the end of the pack list.
Definition: elm_box_eo.legacy.c:57
Evas_Object * elm_combobox_add(Evas_Object *parent)
Add a new Combobox object.
Definition: elc_combobox.c:376
void elm_object_part_text_set(Evas_Object *obj, const char *part, const char *label)
Set a text of an object.
Definition: elm_main.c:1485

Next we create a new genlist item class and sets its properties: item_style as deafult , callback for text_get and set others as NULL.

itc->item_style = "default";
itc->func.text_get = gl_text_get;
itc->func.content_get = NULL;
itc->func.state_get = gl_state_get;
itc->func.filter_get = gl_filter_get;
itc->func.del = NULL;
Elm_Genlist_Item_Class * elm_genlist_item_class_new(void)
Create a new genlist item class in a given genlist widget.
Definition: elm_genlist.c:8392
Elm_Gen_Item_State_Get_Cb state_get
State fetching class function for genlist/gengrid item classes.
Definition: elm_gen.h:101
Elm_Gen_Item_Del_Cb del
Deletion class function for genlist/gengrid item classes.
Definition: elm_gen.h:102
Elm_Gen_Item_Filter_Get_Cb filter_get
Filter seeking class function for genlist/gengrid item classes.
Definition: elm_gen.h:103
Elm_Gen_Item_Content_Get_Cb content_get
Content fetching class function for genlist/gengrid item classes.
Definition: elm_gen.h:100
Elm_Gen_Item_Text_Get_Cb text_get
Text fetching class function for genlist/gengrid item classes.
Definition: elm_gen.h:99
Gengrid or Genlist item class definition.
Definition: elm_gen.h:109
Elm_Gen_Item_Class_Functions func
Set of callbacks.
Definition: elm_gen.h:126
const char * item_style
Name of the visual style to use for this item.
Definition: elm_gen.h:118

Next we will append 1000 items to the combobox, this is similar to appending items to the genlist

for (int i = 0; i < 1000; i++)
elm_genlist_item_append(combobox, itc, (void *)(uintptr_t)i,
NULL, ELM_GENLIST_ITEM_NONE, NULL,
(void*)(uintptr_t)(i * 10));
Elm_Widget_Item * elm_genlist_item_append(Elm_Genlist *obj, const Elm_Genlist_Item_Class *itc, const void *data, Elm_Widget_Item *parent, Elm_Genlist_Item_Type type, Evas_Smart_Cb func, const void *func_data)
Append a new item in a given genlist widget.
Definition: elm_genlist_eo.legacy.c:243
@ ELM_GENLIST_ITEM_NONE
Simple item.
Definition: elm_general.h:349

We also set a pair of callbacks to be called whenever any item is selected or pressed. when the combobox is activated, dismissed, expanded :

evas_object_smart_callback_add(combobox, "clicked",
_combobox_clicked_cb, NULL);
evas_object_smart_callback_add(combobox, "selected",
_combobox_selected_cb, NULL);
evas_object_smart_callback_add(combobox, "dismissed",
_combobox_dismissed_cb, NULL);
evas_object_smart_callback_add(combobox, "expanded",
_combobox_expanded_cb, NULL);
evas_object_smart_callback_add(combobox, "item,pressed",
_combobox_item_pressed_cb, NULL);
EVAS_API void evas_object_smart_callback_add(Evas_Object *eo_obj, const char *event, Evas_Smart_Cb func, const void *data)
Add (register) a callback function to the smart event specified by event on the smart object obj.
Definition: evas_object_smart.c:1040

And then ask that our combobox be shown and run the main loop:

evas_object_resize(win, 300, 500);
return 0;
}
#define ELM_MAIN()
macro to be used after the elm_main() function
Definition: elm_general.h:556
void elm_run(void)
Run Elementary's main loop.
Definition: elm_main.c:1357
EVAS_API void evas_object_resize(Evas_Object *obj, Evas_Coord w, Evas_Coord h)
Changes the size of the given Evas object.
Definition: evas_object_main.c:1236

We now have the callback for setting text in the each item of genlist:

Next we have the callback which is called when the combobox is clicked:

Next we have the callback that is called whenever an item is selected and text of that item is set on combobox:

Next we have the callback that is called whenever an item is pressed and text of that item is set on combobox and the hover is closed:

Next we have the callback that is called whenever an item is double-clicked or pressing (enter|return|spacebar) on an item also the text(event_info) of that item is set on combobox and the hover is closed:

And the callback that is called when the hover,genlist are closed.

And finally the callback is called when hover,genlist are shown.

Our example will initially look like this: