Panel example

In this example will have 3 panels, one for each possible orientation. Two of our panels will start out hidden, the third will start out expanded. For each of the panels we will use a label as the content, it's however possible to have any widget(including containers) as the content of panels.

We start by doing some setup, code you should be familiar with from other examples:

//Compile with:
//gcc -g panel_example_01.c -o panel_example_01 `pkg-config --cflags --libs elementary`
#include <Elementary.h>
EAPI_MAIN int
elm_main(int argc EINA_UNUSED, char **argv EINA_UNUSED)
{
Evas_Object *win, *bx, *panel, *content;
win = elm_win_util_standard_add("panel", "Panel");
bx = elm_box_add(win);
elm_box_horizontal_set(bx, EINA_FALSE);

And move right to creating our first panel, for this panel we are going to choose the orientation as TOP and toggle it(tell it to hide itself):

panel = elm_panel_add(win);
elm_panel_orient_set(panel, ELM_PANEL_ORIENT_TOP);
elm_panel_toggle(panel);
elm_box_pack_end(bx, panel);

For the second panel we choose the RIGHT orientation and explicitly set the state as hidden:

content = elm_label_add(win);
elm_object_text_set(content, "content");
evas_object_show(content);
elm_object_content_set(panel, content);
panel = elm_panel_add(win);
elm_panel_orient_set(panel, ELM_PANEL_ORIENT_RIGHT);
elm_panel_hidden_set(panel, EINA_TRUE);
elm_box_pack_end(bx, panel);

For our third and last panel we won't set the orientation(which means it will use the default: LEFT):

content = elm_label_add(win);
elm_object_text_set(content, "content2");
evas_object_show(content);
elm_object_content_set(panel, content);
panel = elm_panel_add(win);
elm_box_pack_end(bx, panel);

All that is left is running the main loop:

content = elm_label_add(win);
elm_object_text_set(content, "content2");
evas_object_show(content);
elm_object_content_set(panel, content);
return 0;
}

This example will look like this;

Note
The buttons with arrow allow the user to hide/show the panels.
ELM_POLICY_QUIT_LAST_WINDOW_CLOSED
@ ELM_POLICY_QUIT_LAST_WINDOW_CLOSED
quit when the application's last window is closed
Definition: elm_general.h:248
ELM_PANEL_ORIENT_RIGHT
@ ELM_PANEL_ORIENT_RIGHT
Panel (dis)appears from the right.
Definition: elm_panel_eo.h:23
elm_box_add
EAPI Evas_Object * elm_box_add(Evas_Object *parent)
Add a new box to the parent.
Definition: elm_box.c:363
elm_label_add
EAPI Evas_Object * elm_label_add(Evas_Object *parent)
Add a new label to the parent.
Definition: elm_label.c:421
EINA_UNUSED
#define EINA_UNUSED
Definition: eina_types.h:339
ELM_PANEL_ORIENT_TOP
@ ELM_PANEL_ORIENT_TOP
Panel (dis)appears from the top.
Definition: elm_panel_eo.h:20
EINA_FALSE
#define EINA_FALSE
Definition: eina_types.h:533
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
evas_object_size_hint_weight_set
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
elm_panel_add
EAPI Evas_Object * elm_panel_add(Evas_Object *parent)
Adds a panel object.
Definition: elm_panel.c:969
elm_run
void elm_run(void)
Run Elementary's main loop.
Definition: elm_main.c:1362
evas_object_size_hint_align_set
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
ELM_MAIN
#define ELM_MAIN()
macro to be used after the elm_main() function
Definition: elm_general.h:528
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:9576
evas_object_show
void evas_object_show(Evas_Object *eo_obj)
Makes the given Evas object visible.
Definition: evas_object_main.c:1814
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:539
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:1385
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:8992
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:6188
ELM_POLICY_QUIT
@ ELM_POLICY_QUIT
under which circumstances the application should quit automatically.
Definition: elm_general.h:227