elm_bubble - Simple use.

This example shows a bubble with all fields set(label, info, content and icon) and the selected corner changing when the bubble is clicked. To be able use a bubble we need to do some setup and create a window, for this example we are going to ignore that part of the code since it isn't relevant to the bubble.

To have the selected corner change in a clockwise motion we are going to use the following callback:

static unsigned char corner = 0;
++corner;
if (corner > 3)
elm_bubble_pos_set(obj, ELM_BUBBLE_POS_TOP_LEFT);
else
elm_bubble_pos_set(obj, corner);
}
@ ELM_BUBBLE_POS_TOP_LEFT
The arrow of the bubble points to the top left corner.
Definition: elm_bubble_eo.h:25
EAPI_MAIN int
elm_main(int argc EINA_UNUSED, char **argv EINA_UNUSED)
{
Evas_Object *win, *bubble, *label, *icon;
win = elm_win_util_standard_add("bubble", "Bubble");
label = elm_label_add(win);
elm_object_text_set(label, "This is the CONTENT of our bubble");
evas_object_color_set(icon, 0, 0, 255, 255);
bubble = elm_bubble_add(win);
elm_object_part_content_set(bubble, "icon", icon);
elm_object_part_text_set(bubble, "info", "INFO");
elm_object_text_set(bubble, "LABEL");
elm_object_content_set(bubble, label);
evas_object_resize(bubble, 300, 100);
evas_object_smart_callback_add(bubble, "clicked", _bla, NULL);
label = elm_label_add(win);
elm_object_text_set(label, "Bubble with no icon, info or label");
bubble = elm_bubble_add(win);
elm_object_content_set(bubble, label);
evas_object_resize(bubble, 200, 50);
evas_object_move(bubble, 0, 110);
evas_object_resize(win, 300, 200);
return 0;
}
#define EINA_TRUE
boolean value TRUE (numerical value 1)
Definition: eina_types.h:539
#define EINA_UNUSED
Used to indicate that a function parameter is purposely unused.
Definition: eina_types.h:339
Evas_Object * elm_bubble_add(Evas_Object *parent)
Add a new bubble to the parent.
Definition: elm_bubble.c:174
void elm_object_part_content_set(Evas_Object *obj, const char *part, Evas_Object *content)
Set the content on part of a given container widget.
Definition: elm_main.c:1562
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
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
void elm_run(void)
Run Elementary's main loop.
Definition: elm_main.c:1357
@ 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_label_add(Evas_Object *parent)
Add a new label to the parent.
Definition: elm_label.c:421
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_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_color_set(Evas_Object *obj, int r, int g, int b, int a)
Sets the general/main color of the given Evas object to the given one.
Definition: evas_object_main.c:2024
EVAS_API void evas_object_move(Evas_Object *obj, Evas_Coord x, Evas_Coord y)
Move the given Evas object to the given location inside its canvas' viewport.
Definition: evas_object_main.c:1171
EVAS_API Evas * evas_object_evas_get(const Eo *eo_obj)
Get the Evas to which this object belongs to.
Definition: evas_object_main.c:2662
Efl_Canvas_Object Evas_Object
An Evas Object handle.
Definition: Evas_Common.h:185
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
EVAS_API Evas_Object * evas_object_rectangle_add(Evas *e)
Adds a rectangle to the given evas.
Definition: evas_object_rectangle.c:78
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

Here we are creating an elm_label that is going to be used as the content for our bubble:

Note
You could use any evas_object for this, we are using an elm_label for simplicity.

Despite it's name the bubble's icon doesn't have to be an icon, it can be any evas_object. For this example we are going to make the icon a simple blue rectangle:

And finally we have the actual bubble creation and the setting of it's label, info and content:

Note
Because we didn't set a corner, the default("top_left") will be used.

Now that we have our bubble all that is left is connecting the "clicked" signals to our callback:

This last bubble we created was very complete, so it's pertinent to show that most of that stuff is optional a bubble can be created with nothing but content:

Our example will look like this:

See the full source code bubble_example_01.c here.