Toolbar Example - Simple Items

This code places an Elementary toolbar widget on a window, to exemplify part of the widget's API.

Let's start adding a button to our window, that will have its text modified depending on which item is selected. It's used just to exemplify how to change a window content from the toolbar.

bt = elm_button_add(win);
evas_object_size_hint_weight_set(bt, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
evas_object_size_hint_align_set(bt, EVAS_HINT_FILL, EVAS_HINT_FILL);
elm_object_text_set(bt, "Button");

Also, we'll need a toolbar widget, obviously:

tb = elm_toolbar_add(win);
elm_toolbar_shrink_mode_set(tb, ELM_TOOLBAR_SHRINK_SCROLL);
evas_object_size_hint_weight_set(tb, 0.0, 0.0);
evas_object_size_hint_align_set(tb, EVAS_HINT_FILL, 0.0);

When appending an item is possible to set an icon, label, and a callback function that will receive passed data.

elm_toolbar_item_append(tb, "document-print", "Print", _item_1_pressed, bt);
elm_toolbar_item_append(tb, "folder-new", "New Folder", _item_2_pressed, bt);

It's possible to disable items, so the user can't select then. We will disable the third item:

tb_it = elm_toolbar_item_append(tb, "mail-send", "Create and send email",
_item_3_pressed, bt);

Our callbacks will just set button's label:

static void
_item_2_pressed(void *data, Evas_Object *obj EINA_UNUSED, void *event_info EINA_UNUSED)
{
Evas_Object *bt = data;
elm_object_text_set(bt, "Create new folder");
}
static void
_item_3_pressed(void *data, Evas_Object *obj EINA_UNUSED, void *event_info EINA_UNUSED)
{
/* This function won't be called because we disabled item that call it */
Evas_Object *bt = data;
elm_object_text_set(bt, "Create and send email");
}
EAPI_MAIN int
elm_main(int argc EINA_UNUSED, char **argv EINA_UNUSED)
{
Evas_Object *win, *bx, *tb, *bt;
win = elm_win_util_standard_add("toolbar", "Toolbar Example");
bx = elm_box_add(win);
evas_object_size_hint_weight_set(bx, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
bt = elm_button_add(win);
evas_object_size_hint_weight_set(bt, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
evas_object_size_hint_align_set(bt, EVAS_HINT_FILL, EVAS_HINT_FILL);
elm_object_text_set(bt, "Button");
tb = elm_toolbar_add(win);
elm_toolbar_shrink_mode_set(tb, ELM_TOOLBAR_SHRINK_SCROLL);
evas_object_size_hint_weight_set(tb, 0.0, 0.0);
evas_object_size_hint_align_set(tb, EVAS_HINT_FILL, 0.0);
elm_toolbar_item_append(tb, "document-print", "Print", _item_1_pressed, bt);
elm_toolbar_item_append(tb, "folder-new", "New Folder", _item_2_pressed, bt);
tb_it = elm_toolbar_item_append(tb, "mail-send", "Create and send email",
_item_3_pressed, bt);
elm_toolbar_homogeneous_set(tb, EINA_FALSE);
elm_box_pack_end(bx, tb);
elm_box_pack_end(bx, bt);
evas_object_resize(win, 200, 200);
return 0;
}

By default, toolbars would display items homogeneously, so item with long labels, like the third, will make all of them occupy a lot of space. To avoid that, we can disable it:

elm_toolbar_homogeneous_set(tb, EINA_FALSE);

Another default behavior, is to add an menu item if we have more items that would fit on toolbar size. To simply enable scroll, without menus, it's required to change toolbar's shrink mode:

elm_toolbar_shrink_mode_set(tb, ELM_TOOLBAR_SHRINK_SCROLL);

See toolbar_example_01.c, whose window should look like this picture:

ELM_POLICY_QUIT_LAST_WINDOW_CLOSED
quit when the application's last window is closed
Definition: elm_general.h:248
Elm_Object_Item
Eo Elm_Object_Item
Definition: elm_object_item.h:6
elm_box_add
EAPI Evas_Object * elm_box_add(Evas_Object *parent)
Add a new box to the parent.
Definition: elm_box.c:366
elm_toolbar_add
Evas_Object * elm_toolbar_add(Evas_Object *parent)
Add a new toolbar widget to the given parent Elementary (container) object.
Definition: elm_toolbar.c:2984
EINA_UNUSED
#define EINA_UNUSED
Definition: eina_types.h:321
EINA_FALSE
#define EINA_FALSE
Definition: eina_types.h:502
elm_button_add
EAPI Evas_Object * elm_button_add(Evas_Object *parent)
Add a new button to the parent's canvas.
Definition: efl_ui_button.c:477
EVAS_HINT_EXPAND
#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:292
Evas_Object
Efl_Canvas_Object Evas_Object
Definition: Evas_Common.h:180
elm_run
void elm_run(void)
Run Elementary's main loop.
Definition: elm_main.c:1384
elm_win_util_standard_add
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:9200
elm_object_item_disabled_set
void elm_object_item_disabled_set(Elm_Widget_Item *obj, Eina_Bool disable)
Control the disabled state of a widget item.
Definition: elm_widget_item_eo.legacy.c:111
evas_object_show
void evas_object_show(Evas_Object *eo_obj)
Makes the given Evas object visible.
Definition: evas_object_main.c:1853
EVAS_HINT_FILL
#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:293
EINA_TRUE
#define EINA_TRUE
Definition: eina_types.h:508
elm_policy_set
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:1407
elm_win_resize_object_add
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:8900
elm_win_autodel_set
void elm_win_autodel_set(Eo *obj, Eina_Bool autodel)
Set the window's autodel state.
Definition: efl_ui_win.c:6146
ELM_POLICY_QUIT
under which circumstances the application should quit automatically.
Definition: elm_general.h:227