1 #include <Elementary.h>
5 * @defgroup SegmentControl SegmentControl
8 * SegmentControl object is a horizontal control made of multiple segments,
9 * each segment functioning as a discrete button. A segmented control affords a compact means to group together a number of controls.
10 * A segmented control can display a title or an image. The UISegmentedControl object automatically resizes segments to fit proportionally
11 * within their superview unless they have a specific width set. When you add and remove segments,
12 * you can request that the action be animated with sliding and fading effects.
14 typedef struct _Widget_Data Widget_Data;
25 Elm_Segment_Item *ani_it;
28 unsigned int insert_index;
29 unsigned int del_index;
30 unsigned int cur_seg_id;
34 struct _Elm_Segment_Item
40 Eina_Bool delete_me : 1;
44 static void _signal_segment_on(void *data, Evas_Object *obj, const char *emission, const char *source);
45 static void _theme_hook(Evas_Object *obj);
46 static void _item_free(Evas_Object *obj, Elm_Segment_Item *it);
47 static void _del_hook(Evas_Object *obj);
48 static void _layout(Evas_Object *o, Evas_Object_Box_Data *priv, void *data);
49 static Elm_Segment_Item * _item_find(Evas_Object *obj, unsigned int index);
50 static void _update_list(Evas_Object *obj);
51 static void _refresh_segment_ids(Evas_Object *obj);
52 static void _state_value_set(Evas_Object *obj);
54 static Elm_Segment_Item* _item_new(Evas_Object *obj, const char *label, Evas_Object *icon);
55 static Elm_Segment_Item *_item_find(Evas_Object *obj, unsigned int index);
57 static int * _animator_animate_add_cb(Evas_Object *obj);
58 static int * _animator_animate_del_cb(Evas_Object *obj);
61 _on_focus_hook(void *data, Evas_Object *obj)
63 Widget_Data *wd = elm_widget_data_get(obj);
68 if (elm_widget_focus_get(obj))
70 edje_object_signal_emit((Evas_Object *)wd->seg_ctrl, "elm,action,focus", "elm");
71 evas_object_focus_set((Evas_Object *)wd->seg_ctrl, 1);
75 edje_object_signal_emit((Evas_Object *)wd->seg_ctrl, "elm,action,unfocus", "elm");
76 evas_object_focus_set((Evas_Object *)wd->seg_ctrl, 0);
77 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
79 if (it->segment_id == wd->cur_seg_id) {
80 edje_object_signal_emit(it->base, "elm,state,segment,off", "elm");
81 edje_object_signal_emit(it->base, "elm,state,text,visible", "elm");
89 _signal_segment_on(void *data, Evas_Object *obj, const char *emission, const char *source)
91 Elm_Segment_Item *item = (Elm_Segment_Item *) data;
92 Widget_Data *wd = elm_widget_data_get(item->obj);
97 edje_object_signal_emit(item->base, "elm,state,segment,on", "elm");
98 edje_object_signal_emit(item->base, "elm,state,text,change", "elm");
101 if (item->segment_id == wd->cur_seg_id)
103 wd->cur_seg_id = item->segment_id;
106 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
108 if (it->segment_id == wd->cur_seg_id) {
109 edje_object_signal_emit(it->base, "elm,state,segment,off", "elm");
110 edje_object_signal_emit(it->base, "elm,state,text,visible", "elm");
114 wd->cur_seg_id = item->segment_id;
115 evas_object_smart_callback_call(item->obj, "changed", (void*)wd->cur_seg_id);
119 _theme_hook(Evas_Object *obj)
121 _elm_theme_object_set(obj, obj, "segmented-control", "base", elm_widget_style_get(obj));
127 _item_free(Evas_Object *obj, Elm_Segment_Item *it)
129 Widget_Data *wd = elm_widget_data_get(obj);
133 wd->seg_ctrl = eina_list_remove(wd->seg_ctrl, it);
135 if(it->icon) evas_object_del(it->icon);
136 if(it->base) evas_object_del(it->base);
137 if(it->label) eina_stringshare_del(it->label);
146 _del_hook(Evas_Object *obj)
148 Widget_Data *wd = elm_widget_data_get(obj);
149 Elm_Segment_Item *it;
150 Eina_List *l, *clear = NULL;
152 EINA_LIST_FOREACH(wd->seg_ctrl, l, it) clear = eina_list_append(clear, it);
153 EINA_LIST_FREE(clear, it) _item_free(obj, it);
164 _layout(Evas_Object *o, Evas_Object_Box_Data *priv, void *data)
166 Widget_Data *wd = data;
168 _els_box_layout(o, priv, 1, 0); /* making box layout non homogenous */
174 _segment_resizing(void *data)
176 Widget_Data *wd = elm_widget_data_get((Evas_Object *)data);
178 Evas_Coord w = 0, h = 0;
180 evas_object_geometry_get(wd->base, NULL, NULL, &w, &h);
182 wd->item_width = wd->width = w;
185 _state_value_set((Evas_Object *)data);
188 static void _object_resize(void *data, Evas *e, Evas_Object *obj, void *event_info)
192 wd = elm_widget_data_get((Evas_Object *)data);
195 ecore_job_add(_segment_resizing, (Evas_Object *)data);
199 * Add a new segmentcontrol to the parent
200 * @param parent The parent object
201 * @return The new object or NULL if it cannot be created
203 * @ingroup SegmentControl SegmentControl
206 elm_segment_control_add(Evas_Object *parent)
212 wd = ELM_NEW(Widget_Data);
213 e = evas_object_evas_get(parent);
214 obj = elm_widget_add(e);
215 elm_widget_type_set(obj, "segmented-control");
216 elm_widget_sub_object_add(parent, obj);
217 elm_widget_on_focus_hook_set( obj, _on_focus_hook, NULL );
218 elm_widget_data_set(obj, wd);
219 elm_widget_del_hook_set(obj, _del_hook);
220 elm_widget_theme_hook_set(obj, _theme_hook);
222 wd->base = edje_object_add(e);
223 _elm_theme_object_set(obj, wd->base, "segmented-control", "base", "default");
224 elm_widget_resize_object_set(obj, wd->base);
226 wd->box = evas_object_box_add(e);
227 evas_object_box_layout_set(wd->box, _layout, wd, NULL);
228 elm_widget_sub_object_add(obj, wd->box);
229 edje_object_part_swallow(wd->base, "elm.swallow.content", wd->box);
230 evas_object_show(wd->box);
232 evas_object_event_callback_add(obj, EVAS_CALLBACK_RESIZE, _object_resize, obj);
235 wd->insert_index = 0;
241 static Elm_Segment_Item*
242 _item_new(Evas_Object *obj, const char *label, Evas_Object *icon)
244 Widget_Data *wd = elm_widget_data_get(obj);
245 if (!wd) return NULL;
247 Elm_Segment_Item *it;
248 it = calloc(1, sizeof( Elm_Segment_Item));
249 if (!it) return NULL;
253 if(obj) it->obj = obj;
254 it->delete_me = EINA_FALSE;
255 it->segment_id = wd->id;
257 it->base = edje_object_add(evas_object_evas_get(obj));
258 _elm_theme_object_set(obj, it->base, "segment", "base", elm_object_style_get(it->base));
260 if (it->label) eina_stringshare_del(it->label);
263 it->label = eina_stringshare_add(label);
270 if ((it->icon != icon) && (it->icon))
271 elm_widget_sub_object_del(obj, it->icon);
275 elm_widget_sub_object_add(obj, icon);
276 Evas_Coord minw = -1, minh = -1, maxw = -1, maxh = -1;
278 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
279 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
281 evas_object_size_hint_weight_set(it->base, 1.0, -1.0);
282 evas_object_size_hint_align_set(it->base, 1.0, -1.0);
283 evas_object_size_hint_min_set(it->base, -1, -1);
284 evas_object_size_hint_max_set(it->base, maxw, maxh);
287 edje_object_size_min_restricted_calc(obj, &mw, &mh, 0, 0);
288 evas_object_size_hint_weight_set(obj, 1.0, 1.0);
289 evas_object_size_hint_align_set(obj, -1.0, -1.0);
295 static void _update_list(Evas_Object *obj)
297 Widget_Data *wd = elm_widget_data_get(obj);
300 Elm_Segment_Item *it;
303 wd->count = eina_list_count(wd->seg_ctrl);
307 it = _item_find(obj, 0);
308 _elm_theme_object_set(obj, it->base, "segment", "base", "single");
309 edje_object_signal_emit(it->base, "elm,state,segment,on", "elm");
310 edje_object_signal_emit(it->base, "elm,state,text,visible", "elm");
311 edje_object_signal_emit(it->base, "elm,state,text,change", "elm");
312 edje_object_message_signal_process(it->base);
314 edje_object_part_text_set(it->base, "elm.text", it->label);
316 edje_object_part_swallow(it->base, "elm.swallow.content", it->icon);
317 edje_object_signal_emit(it->base, "elm,state,icon,visible", "elm");
321 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
325 _elm_theme_object_set(obj, it->base, "segment", "base", "first");
327 else if(i==wd->count-1)
329 _elm_theme_object_set(obj, it->base, "segment", "base", "last");
333 _elm_theme_object_set(obj, it->base, "segment", "base", "default");
336 edje_object_signal_emit(it->base, "elm,state,text,visible", "elm");
337 edje_object_message_signal_process(it->base);
339 edje_object_part_text_set(it->base, "elm.text", it->label);
341 edje_object_part_swallow(it->base, "elm.swallow.content", it->icon);
342 edje_object_signal_emit(it->base, "elm,state,icon,visible", "elm");
349 static void _refresh_segment_ids(Evas_Object *obj)
351 Widget_Data *wd = elm_widget_data_get(obj);
354 Elm_Segment_Item *it;
357 if (wd->insert_index && wd->cur_seg_id >= wd->insert_index)
360 wd->insert_index = 0;
364 if (wd->cur_seg_id >= wd->del_index)
370 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
377 static void _state_value_set(Evas_Object *obj)
379 Widget_Data *wd = elm_widget_data_get(obj);
382 Elm_Segment_Item *it;
384 Evas_Coord mw, mh, x, y;
388 unsigned int count = eina_list_count(wd->seg_ctrl);
391 wd->item_width = wd->width/count;
395 evas_object_geometry_get(wd->ani_it->base, &x, &y, &w1, NULL);
396 if(wd->ani_it->delete_me)
398 w1-=(wd->item_width/15);
403 w1+=(wd->item_width/15);
404 if( w1 > wd->item_width )
408 w2 = (wd->width-w1)/(count -1);
415 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
417 edje_object_size_min_restricted_calc(it->base, &mw, &mh, 0, 0);
418 evas_object_size_hint_weight_set(it->base, 1.0, 1.0);
419 evas_object_size_hint_align_set(it->base, -1.0, -1.0);
421 if(wd->ani_it && it == wd->ani_it)
423 evas_object_resize(it->base, w1, wd->height);
424 evas_object_size_hint_min_set(it->base, w1, wd->height);
425 evas_object_size_hint_max_set(it->base, w1, wd->height);
429 evas_object_resize(it->base, w2, wd->height);
430 evas_object_size_hint_min_set(it->base, w2, wd->height);
431 evas_object_size_hint_max_set(it->base, w2, wd->height);
442 _animator_animate_add_cb(Evas_Object *obj)
444 Widget_Data *wd = elm_widget_data_get(obj);
448 evas_object_geometry_get(wd->ani_it->base, NULL, NULL, &w, NULL);
450 if( w < wd->item_width )
452 _state_value_set(obj);
453 evas_object_geometry_get(wd->ani_it->base, NULL, NULL, &w, NULL);
454 return ECORE_CALLBACK_RENEW;
458 ecore_animator_del(wd->ani);
461 return ECORE_CALLBACK_CANCEL;
467 _animator_animate_del_cb(Evas_Object *obj)
469 Widget_Data *wd = elm_widget_data_get(obj);
473 evas_object_geometry_get(wd->ani_it->base, NULL, NULL, &w, NULL);
476 _state_value_set(obj);
477 evas_object_geometry_get(wd->ani_it->base, NULL, NULL, &w, NULL);
478 return ECORE_CALLBACK_RENEW;
482 _item_free(obj, wd->ani_it );
483 _refresh_segment_ids(obj);
484 ecore_animator_del(wd->ani);
488 wd->id = eina_list_count(wd->seg_ctrl);
489 return ECORE_CALLBACK_CANCEL;
494 * Add a new segment to segmentcontrol
495 * @param obj The SegmentControl object
496 * @param icon The icon object for added segment
497 * @param label The label for added segment
498 * @param animate If 1 the action be animated with sliding effects default 0.
499 * @return The new segment or NULL if it cannot be created
501 * @ingroup SegmentControl SegmentControl
504 EAPI Elm_Segment_Item *
505 elm_segment_control_add_segment(Evas_Object *obj, Evas_Object *icon, const char *label, Eina_Bool animate)
507 Widget_Data *wd = elm_widget_data_get(obj);
511 Elm_Segment_Item *it;
513 it = _item_new(obj, label, icon);
517 wd->seg_ctrl = eina_list_append(wd->seg_ctrl, it);
518 wd->id = eina_list_count(wd->seg_ctrl);
522 edje_object_signal_callback_add(it->base, "elm,action,segment,click", "elm", _signal_segment_on, it);
524 wd->insert_index = 0;
526 _refresh_segment_ids(obj);
528 if(animate && it->segment_id && wd->ani_it == NULL)
530 evas_object_resize(it->base, 1, wd->height);
532 wd->ani = ecore_animator_add( _animator_animate_add_cb, obj );
535 _state_value_set(obj);
536 evas_object_show( it->base);
538 evas_object_box_append(wd->box, it->base);
539 evas_object_smart_calculate(wd->box);
545 static Elm_Segment_Item *
546 _item_find(Evas_Object *obj, unsigned int index)
548 Widget_Data *wd = elm_widget_data_get(obj);
552 Elm_Segment_Item *it;
556 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
567 static Elm_Segment_Item *
568 _item_search(Evas_Object *obj, Elm_Segment_Item *item)
570 Widget_Data *wd = elm_widget_data_get(obj);
574 Elm_Segment_Item *it;
577 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
587 * Insert a new segment to segmentcontrol
588 * @param obj The SegmentControl object
589 * @param icon The icon object for added segment
590 * @param label The label for added segment
591 * @param index The position at which segment to be inserted
592 * @param animate If 1 the action be animated with sliding effects default 0.
593 * @return The new segment or NULL if it cannot be created
595 * @ingroup SegmentControl SegmentControl
598 elm_segment_control_insert_segment_at(Evas_Object *obj, Evas_Object *icon, const char *label, unsigned int index, Eina_Bool animate)
600 Widget_Data *wd = elm_widget_data_get(obj);
603 Elm_Segment_Item *it, *it_rel;
605 it = _item_new(obj, label, icon);
606 it_rel = _item_find(obj, index);
609 wd->seg_ctrl = eina_list_append(wd->seg_ctrl, it);
614 wd->seg_ctrl = eina_list_prepend_relative(wd->seg_ctrl, it, it_rel);
616 edje_object_signal_callback_add(it->base, "elm,action,segment,click", "elm", _signal_segment_on, it);
617 wd->insert_index = index;
619 wd->id = eina_list_count(wd->seg_ctrl);
620 _refresh_segment_ids(obj);
625 if(animate && it->segment_id && wd->ani_it == NULL)
628 evas_object_resize(it->base, 1, wd->height);
629 wd->ani = ecore_animator_add( _animator_animate_add_cb, obj );
632 _state_value_set(obj);
634 evas_object_show( it->base);
636 if(index >= wd->id-1)
638 evas_object_box_append(wd->box, it->base);
642 evas_object_box_insert_at(wd->box, it->base, index);
645 evas_object_smart_calculate(wd->box);
651 * Delete a segment to segmentcontrol
652 * @param obj The SegmentControl object
653 * @param item The Segment to be deleted
654 * @param animate If 1 the action be animated with sliding effects default 0.
656 * @ingroup SegmentControl SegmentControl
659 elm_segment_control_delete_segment(Evas_Object *obj, Elm_Segment_Item *item, Eina_Bool animate)
661 Widget_Data *wd = elm_widget_data_get(obj);
666 Elm_Segment_Item *it;
667 it = _item_search(obj, item);
671 wd->del_index = it->segment_id;
673 if(animate && it->segment_id && wd->ani_it == NULL)
675 it->delete_me = EINA_TRUE;
677 wd->ani = ecore_animator_add( _animator_animate_del_cb, obj );
681 evas_object_box_remove(wd->box, it->base);
682 evas_object_smart_calculate(wd->box);
684 _refresh_segment_ids(obj);
685 _state_value_set(obj);
689 wd->id = eina_list_count(wd->seg_ctrl);
694 * Delete a segment to segmentcontrol
695 * @param obj The SegmentControl object
696 * @param index The position at which segment to be deleted
697 * @param animate If 1 the action be animated with sliding effects default 0.
699 * @ingroup SegmentControl SegmentControl
703 elm_segment_control_delete_segment_at(Evas_Object *obj, unsigned int index, Eina_Bool animate)
705 Widget_Data *wd = elm_widget_data_get(obj);
707 Elm_Segment_Item *it, *it_rel;
709 it = _item_find(obj, index);
714 wd->del_index = index;
716 if(animate && it->segment_id)
718 if(wd->ani_it == NULL)
721 it->delete_me = EINA_TRUE;
722 wd->ani = ecore_animator_add( _animator_animate_del_cb, obj );
726 wd->queue = eina_list_append(wd->queue, it);
731 evas_object_box_remove(wd->box, it->base);
732 evas_object_smart_calculate(wd->box);
734 _refresh_segment_ids(obj);
735 _state_value_set(obj);
740 wd->id = eina_list_count(wd->seg_ctrl);
745 * Get the label of a segment of segmentcontrol
746 * @param obj The SegmentControl object
747 * @param index The index of the segment
750 * @ingroup SegmentControl SegmentControl
754 elm_segment_control_get_segment_label_at(Evas_Object *obj, unsigned int index)
756 Elm_Segment_Item *it_rel;
757 Widget_Data *wd = elm_widget_data_get(obj);
760 it_rel = _item_find(obj, index);
763 return it_rel->label;
769 * Get the icon of a segment of segmentcontrol
770 * @param obj The SegmentControl object
771 * @param index The index of the segment
772 * @return The icon object
774 * @ingroup SegmentControl SegmentControl
778 elm_segment_control_get_segment_icon_at(Evas_Object *obj, unsigned int index)
780 Elm_Segment_Item *seg_rel;
781 Widget_Data *wd = elm_widget_data_get(obj);
784 seg_rel = _item_find(obj, index);
787 return seg_rel->icon;
793 * Get the currently selected segment of segmentcontrol
794 * @param obj The SegmentControl object
795 * @param value The current segment id
796 * @return The selected Segment
798 * @ingroup SegmentControl SegmentControl
801 EAPI Elm_Segment_Item *
802 elm_segment_control_selected_segment_get(const Evas_Object *obj, int *value)
804 Widget_Data *wd = elm_widget_data_get(obj);
805 if(!wd || !wd->seg_ctrl) return NULL;
807 Elm_Segment_Item *it;
810 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
812 if(it->segment_id == wd->cur_seg_id)
814 * value = wd->cur_seg_id;
822 * Get the count of segments of segmentcontrol
823 * @param obj The SegmentControl object
824 * @return The count of Segments
826 * @ingroup SegmentControl SegmentControl
830 elm_segment_control_get_segment_count(Evas_Object *obj)
832 Widget_Data *wd = elm_widget_data_get(obj);
839 * set the size of segmentcontrol
840 * @param obj The SegmentControl object
841 * @param width width of segment control
842 * @param height height of segment control
844 * @ingroup SegmentControl SegmentControl
848 elm_segment_control_set_size(Evas_Object *obj, int width, int height)
850 Widget_Data *wd = elm_widget_data_get(obj);
853 wd->scale_factor = elm_scale_get();
854 if ( wd->scale_factor == 0.0 ) {
855 wd->scale_factor = 1.0;
858 wd->item_width = wd->width = width*wd->scale_factor;
859 wd->height = height*wd->scale_factor;