This code places an Elementary segment control widgets on a window, to exemplify part of the widget's API.
Let's start adding a segment control to our window:
Evas_Object * elm_segment_control_add(Evas_Object *parent)
Add a new segment control widget to the given parent Elementary (container) object.
Definition: elm_segment_control.c:646
#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
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
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
Now will add an item only with label:
elm_segment_control_item_add(sc, NULL, "only text");
Really simple. To add an item with only an icon, the icon needs to be created first, them added with this same function:
Evas_Object * elm_icon_add(Evas_Object *parent)
Add a new icon object to the parent.
Definition: elm_icon.c:613
elm_segment_control_item_add(sc, ic, NULL);
Eina_Bool elm_icon_standard_set(Evas_Object *obj, const char *name)
Set the icon by icon standards names.
Definition: elm_icon.c:885
If an item with label and icon is required, it can be done as well. In this case, instead of a label (or icon) centered, the item will display an icon at left and the label at right:
elm_segment_control_item_add(sc, ic, "Home");
But, if you need to add some items that can have or not a label, but want that all of them looks the same way, with icon at left, just add an empty string label. It's done on our example to illustrate that:
elm_segment_control_item_add(sc, ic, "");
So far, all the item were added to the last position of the widget, but if something different is required, it can be done using another insertion function. Let's suppose we want to put an item just before the last item:
count = elm_segment_control_item_count_get(sc);
elm_segment_control_item_insert_at(sc, NULL, "Inserted at", count - 1);
There are two ways to delete items. Using the item handle, like:
seg_it = elm_segment_control_item_insert_at(sc, NULL, "To be deleted", 2);
void elm_object_item_del(Eo *obj)
Delete the given item.
Definition: elm_main.c:2017
Or using item's index:
elm_segment_control_item_insert_at(sc, NULL, "To be deleted", 2);
elm_segment_control_item_del_at(sc, 2);
To set properties of an item already added to the widget, you just need to get the item and set icon or label, as the following code shows:
seg_it = elm_segment_control_item_get(sc, 0);
Finally, it's possible to select an item from the code, and also get the selected item. We will select the item at the center of the widget and print its position.
See the full example, whose window should look like this picture:
