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;
24 Elm_Segment_Item *ani_it;
27 unsigned int insert_index;
28 unsigned int del_index;
29 unsigned int cur_seg_id;
31 Eina_Bool longpressed : 1;
32 Eina_Bool selected : 1;
35 struct _Elm_Segment_Item
41 Eina_Bool delete_me : 1;
43 Ecore_Timer *long_timer;
46 static void _mouse_down(void *data, Evas *evas, Evas_Object *obj, void *event_info);
47 static void _mouse_up(void *data, Evas *e, Evas_Object *obj, void *event_info);
48 static void _signal_segment_on(void *data);
49 static void _theme_hook(Evas_Object *obj);
50 static void _item_free(Evas_Object *obj, Elm_Segment_Item *it);
51 static void _del_hook(Evas_Object *obj);
52 static void _layout(Evas_Object *o, Evas_Object_Box_Data *priv, void *data);
53 static void _update_list(Evas_Object *obj);
54 static void _refresh_segment_ids(Evas_Object *obj);
55 static void _state_value_set(Evas_Object *obj);
57 static Elm_Segment_Item* _item_new(Evas_Object *obj, const char *label, Evas_Object *icon);
58 static Elm_Segment_Item *_item_find(Evas_Object *obj, unsigned int index);
60 static int * _animator_animate_add_cb(Evas_Object *obj);
61 static int * _animator_animate_del_cb(Evas_Object *obj);
64 _on_focus_hook(void *data, Evas_Object *obj)
66 Widget_Data *wd = elm_widget_data_get(obj);
69 if (elm_widget_focus_get(obj))
70 evas_object_focus_set((Evas_Object *)wd->seg_ctrl, 1);
72 evas_object_focus_set((Evas_Object *)wd->seg_ctrl, 0);
76 _signal_segment_on(void *data)
78 Elm_Segment_Item *item = (Elm_Segment_Item *) data;
79 Widget_Data *wd = elm_widget_data_get(item->obj);
83 wd->selected = EINA_TRUE;
87 ecore_timer_del(item->long_timer);
88 item->long_timer = NULL;
90 wd->longpressed = EINA_TRUE;
91 edje_object_signal_emit(item->base, "elm,state,segment,on", "elm");
92 edje_object_signal_emit(item->base, "elm,state,text,change", "elm");
97 if (item->segment_id == wd->cur_seg_id)
99 wd->cur_seg_id = item->segment_id;
100 evas_object_smart_callback_call(item->obj, "changed", (void*)wd->cur_seg_id);
103 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
105 if (it->segment_id == wd->cur_seg_id)
107 edje_object_signal_emit(it->base, "elm,action,unfocus", "elm");
108 edje_object_signal_emit(it->base, "elm,state,segment,off", "elm");
109 edje_object_signal_emit(it->base, "elm,state,text,visible", "elm");
113 wd->cur_seg_id = item->segment_id;
114 evas_object_smart_callback_call(item->obj, "changed", (void*)wd->cur_seg_id);
119 _mouse_up(void *data, Evas *e, Evas_Object *obj, void *event_info)
121 Elm_Segment_Item *item = (Elm_Segment_Item *) data;
122 Widget_Data *wd = elm_widget_data_get(item->obj);
123 Evas_Event_Mouse_Up * ev = event_info;
124 Evas_Coord x, y, w, h;
128 evas_object_geometry_get(obj, &x, &y, &w, &h);
129 if(ev->output.x > x && ev->output.x < x+w && ev->output.y > y && ev->output.y < y+h && wd->selected == EINA_FALSE)
131 _signal_segment_on(item);
135 wd->selected = EINA_FALSE;
139 if(wd->longpressed == EINA_FALSE)
141 edje_object_signal_emit(item->base, "elm,action,unfocus", "elm");
142 edje_object_signal_emit(item->base, "elm,state,text,visible", "elm");
144 if (item->long_timer)
146 ecore_timer_del(item->long_timer);
147 item->long_timer = NULL;
152 _mouse_move(void *data, Evas *evas, Evas_Object *obj, void *event_info)
154 Elm_Segment_Item *item = (Elm_Segment_Item *) data;
155 Widget_Data *wd = elm_widget_data_get(item->obj);
156 Evas_Event_Mouse_Move * ev = event_info;
157 Evas_Coord x, y, w, h;
161 evas_object_geometry_get(obj, &x, &y, &w, &h);
162 if(ev->cur.output.x > x && ev->cur.output.x < x+w && ev->cur.output.y > y && ev->cur.output.y < y+h)
167 if(wd->longpressed == EINA_FALSE)
169 edje_object_signal_emit(item->base, "elm,action,unfocus", "elm");
170 edje_object_signal_emit(item->base, "elm,state,text,visible", "elm");
172 if (item->long_timer)
174 ecore_timer_del(item->long_timer);
175 item->long_timer = NULL;
180 _mouse_down(void *data, Evas *evas, Evas_Object *obj, void *event_info)
182 Elm_Segment_Item *item = (Elm_Segment_Item *) data;
183 Widget_Data *wd = elm_widget_data_get(item->obj);
186 wd->longpressed = EINA_FALSE;
188 if (item->segment_id == wd->cur_seg_id)
190 wd->selected = EINA_TRUE;
194 edje_object_signal_emit(item->base, "elm,action,focus", "elm");
195 edje_object_signal_emit(item->base, "elm,state,text,visible", "elm");
197 if (item->long_timer) ecore_timer_del(item->long_timer);
198 item->long_timer = ecore_timer_add(0.3, _signal_segment_on, item);
202 _theme_hook(Evas_Object *obj)
204 _elm_theme_object_set(obj, obj, "segmented-control", "base", elm_widget_style_get(obj));
210 _item_free(Evas_Object *obj, Elm_Segment_Item *it)
212 Widget_Data *wd = elm_widget_data_get(obj);
216 wd->seg_ctrl = eina_list_remove(wd->seg_ctrl, it);
218 if(it->icon) evas_object_del(it->icon);
219 if(it->base) evas_object_del(it->base);
220 if(it->label) eina_stringshare_del(it->label);
221 if (it->long_timer) ecore_timer_del(it->long_timer);
230 _del_hook(Evas_Object *obj)
232 Widget_Data *wd = elm_widget_data_get(obj);
233 Elm_Segment_Item *it;
234 Eina_List *l, *clear = NULL;
236 EINA_LIST_FOREACH(wd->seg_ctrl, l, it) clear = eina_list_append(clear, it);
237 EINA_LIST_FREE(clear, it) _item_free(obj, it);
247 _layout(Evas_Object *o, Evas_Object_Box_Data *priv, void *data)
249 Widget_Data *wd = data;
251 _els_box_layout(o, priv, 1, 0); /* making box layout non homogenous */
257 _segment_resizing(void *data)
259 Widget_Data *wd = elm_widget_data_get((Evas_Object *)data);
261 Evas_Coord w = 0, h = 0;
263 evas_object_geometry_get(wd->base, NULL, NULL, &w, &h);
264 wd->item_width = wd->width = w;
266 _state_value_set((Evas_Object *)data);
269 static void _object_resize(void *data, Evas *e, Evas_Object *obj, void *event_info)
273 wd = elm_widget_data_get((Evas_Object *)data);
276 ecore_job_add(_segment_resizing, (Evas_Object *)data);
280 * Add a new segmentcontrol to the parent
281 * @param parent The parent object
282 * @return The new object or NULL if it cannot be created
284 * @ingroup SegmentControl SegmentControl
287 elm_segment_control_add(Evas_Object *parent)
293 wd = ELM_NEW(Widget_Data);
294 e = evas_object_evas_get(parent);
295 obj = elm_widget_add(e);
296 elm_widget_type_set(obj, "segmented-control");
297 elm_widget_sub_object_add(parent, obj);
298 elm_widget_on_focus_hook_set( obj, _on_focus_hook, NULL );
299 elm_widget_data_set(obj, wd);
300 elm_widget_del_hook_set(obj, _del_hook);
301 elm_widget_theme_hook_set(obj, _theme_hook);
303 wd->base = edje_object_add(e);
304 _elm_theme_object_set(obj, wd->base, "segmented-control", "base", "default");
305 elm_widget_resize_object_set(obj, wd->base);
306 wd->box = evas_object_box_add(e);
307 evas_object_box_layout_set(wd->box, _layout, wd, NULL);
308 elm_widget_sub_object_add(obj, wd->box);
309 edje_object_part_swallow(wd->base, "elm.swallow.content", wd->box);
310 evas_object_show(wd->box);
312 evas_object_event_callback_add(obj, EVAS_CALLBACK_RESIZE, _object_resize, obj);
315 wd->insert_index = 0;
317 wd->selected = EINA_FALSE;
322 static Elm_Segment_Item*
323 _item_new(Evas_Object *obj, const char *label, Evas_Object *icon)
325 Widget_Data *wd = elm_widget_data_get(obj);
326 if (!wd) return NULL;
328 Elm_Segment_Item *it;
329 it = calloc(1, sizeof( Elm_Segment_Item));
330 if (!it) return NULL;
334 if(obj) it->obj = obj;
335 it->delete_me = EINA_FALSE;
336 it->segment_id = wd->id;
338 it->base = edje_object_add(evas_object_evas_get(obj));
339 _elm_theme_object_set(obj, it->base, "segment", "base", elm_object_style_get(it->base));
341 if (it->label) eina_stringshare_del(it->label);
344 it->label = eina_stringshare_add(label);
351 if ((it->icon != icon) && (it->icon))
352 elm_widget_sub_object_del(obj, it->icon);
356 elm_widget_sub_object_add(obj, icon);
357 Evas_Coord minw = -1, minh = -1, maxw = -1, maxh = -1;
358 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
359 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
361 evas_object_size_hint_weight_set(it->base, 1.0, -1.0);
362 evas_object_size_hint_align_set(it->base, 1.0, -1.0);
363 evas_object_size_hint_min_set(it->base, -1, -1);
364 evas_object_size_hint_max_set(it->base, maxw, maxh);
367 edje_object_size_min_restricted_calc(obj, &mw, &mh, 0, 0);
368 evas_object_size_hint_weight_set(obj, 1.0, 1.0);
369 evas_object_size_hint_align_set(obj, -1.0, -1.0);
375 static void _update_list(Evas_Object *obj)
377 Widget_Data *wd = elm_widget_data_get(obj);
380 Elm_Segment_Item *it;
383 wd->count = eina_list_count(wd->seg_ctrl);
387 it = _item_find(obj, 0);
388 _elm_theme_object_set(obj, it->base, "segment", "base", "single"); edje_object_signal_emit(it->base, "elm,state,segment,on", "elm");
389 edje_object_signal_emit(it->base, "elm,state,text,visible", "elm");
390 edje_object_signal_emit(it->base, "elm,state,text,change", "elm");
391 edje_object_message_signal_process(it->base);
393 edje_object_part_text_set(it->base, "elm.text", it->label);
395 edje_object_part_swallow(it->base, "elm.swallow.content", it->icon);
396 edje_object_signal_emit(it->base, "elm,state,icon,visible", "elm");
400 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
404 _elm_theme_object_set(obj, it->base, "segment", "base", "first");
406 else if(i==wd->count-1)
408 _elm_theme_object_set(obj, it->base, "segment", "base", "last");
412 _elm_theme_object_set(obj, it->base, "segment", "base", "default");
415 edje_object_signal_emit(it->base, "elm,state,text,visible", "elm");
416 edje_object_message_signal_process(it->base);
418 edje_object_part_text_set(it->base, "elm.text", it->label);
420 edje_object_part_swallow(it->base, "elm.swallow.content", it->icon);
421 edje_object_signal_emit(it->base, "elm,state,icon,visible", "elm");
428 static void _refresh_segment_ids(Evas_Object *obj)
430 Widget_Data *wd = elm_widget_data_get(obj);
432 Elm_Segment_Item *it;
434 if (wd->insert_index && wd->cur_seg_id >= wd->insert_index)
437 wd->insert_index = 0;
441 if (wd->cur_seg_id >= wd->del_index)
446 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
453 static void _state_value_set(Evas_Object *obj)
455 Widget_Data *wd = elm_widget_data_get(obj);
457 Elm_Segment_Item *it;
459 Evas_Coord mw, mh, x, y;
461 unsigned int count = eina_list_count(wd->seg_ctrl);
463 wd->item_width = wd->width/count;
466 evas_object_geometry_get(wd->ani_it->base, &x, &y, &w1, NULL);
467 if (wd->ani_it->delete_me)
469 w1-=(wd->item_width/15);
474 w1+=(wd->item_width/15);
475 if( w1 > wd->item_width )
478 w2 = (wd->width-w1)/(count -1);
485 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
487 edje_object_size_min_restricted_calc(it->base, &mw, &mh, 0, 0);
488 evas_object_size_hint_weight_set(it->base, 1.0, 1.0);
489 evas_object_size_hint_align_set(it->base, -1.0, -1.0);
491 if(wd->ani_it && it == wd->ani_it)
493 evas_object_resize(it->base, w1, wd->height);
494 evas_object_size_hint_min_set(it->base, w1, wd->height);
495 evas_object_size_hint_max_set(it->base, w1, wd->height);
499 evas_object_resize(it->base, w2, wd->height);
500 evas_object_size_hint_min_set(it->base, w2, wd->height);
501 evas_object_size_hint_max_set(it->base, w2, wd->height);
511 _animator_animate_add_cb(Evas_Object *obj)
513 Widget_Data *wd = elm_widget_data_get(obj);
517 evas_object_geometry_get(wd->ani_it->base, NULL, NULL, &w, NULL);
518 if( w < wd->item_width )
520 _state_value_set(obj);
521 evas_object_geometry_get(wd->ani_it->base, NULL, NULL, &w, NULL);
522 return ECORE_CALLBACK_RENEW;
526 ecore_animator_del(wd->ani);
529 return ECORE_CALLBACK_CANCEL;
535 _animator_animate_del_cb(Evas_Object *obj)
537 Widget_Data *wd = elm_widget_data_get(obj);
540 evas_object_geometry_get(wd->ani_it->base, NULL, NULL, &w, NULL);
543 _state_value_set(obj);
544 evas_object_geometry_get(wd->ani_it->base, NULL, NULL, &w, NULL);
545 return ECORE_CALLBACK_RENEW;
549 _item_free(obj, wd->ani_it );
550 _refresh_segment_ids(obj);
551 ecore_animator_del(wd->ani);
555 wd->id = eina_list_count(wd->seg_ctrl);
556 return ECORE_CALLBACK_CANCEL;
561 * Add a new segment to segmentcontrol
562 * @param obj The SegmentControl object
563 * @param icon The icon object for added segment
564 * @param label The label for added segment
565 * @param animate If 1 the action be animated with sliding effects default 0.
566 * @return The new segment or NULL if it cannot be created
568 * @ingroup SegmentControl SegmentControl
571 EAPI Elm_Segment_Item *
572 elm_segment_control_add_segment(Evas_Object *obj, Evas_Object *icon, const char *label, Eina_Bool animate)
574 Widget_Data *wd = elm_widget_data_get(obj);
577 Elm_Segment_Item *it;
579 it = _item_new(obj, label, icon);
582 wd->seg_ctrl = eina_list_append(wd->seg_ctrl, it);
583 wd->id = eina_list_count(wd->seg_ctrl);
585 evas_object_event_callback_add(it->base, EVAS_CALLBACK_MOUSE_DOWN, _mouse_down, it);
586 evas_object_event_callback_add(it->base, EVAS_CALLBACK_MOUSE_MOVE, _mouse_move, it);
587 evas_object_event_callback_add(it->base, EVAS_CALLBACK_MOUSE_UP, _mouse_up, it);
588 wd->insert_index = 0;
590 _refresh_segment_ids(obj);
592 if(animate && it->segment_id && wd->ani_it == NULL)
594 evas_object_resize(it->base, 1, wd->height);
596 wd->ani = ecore_animator_add( _animator_animate_add_cb, obj );
599 _state_value_set(obj);
600 evas_object_show( it->base);
602 evas_object_box_append(wd->box, it->base);
603 evas_object_smart_calculate(wd->box);
609 static Elm_Segment_Item *
610 _item_find(Evas_Object *obj, unsigned int index)
612 Widget_Data *wd = elm_widget_data_get(obj);
613 if (!wd) return NULL;
615 Elm_Segment_Item *it;
618 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
629 static Elm_Segment_Item *
630 _item_search(Evas_Object *obj, Elm_Segment_Item *item)
632 Widget_Data *wd = elm_widget_data_get(obj);
636 Elm_Segment_Item *it;
638 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
648 * Insert a new segment to segmentcontrol
649 * @param obj The SegmentControl object
650 * @param icon The icon object for added segment
651 * @param label The label for added segment
652 * @param index The position at which segment to be inserted
653 * @param animate If 1 the action be animated with sliding effects default 0.
654 * @return The new segment or NULL if it cannot be created
656 * @ingroup SegmentControl SegmentControl
659 elm_segment_control_insert_segment_at(Evas_Object *obj, Evas_Object *icon, const char *label, unsigned int index, Eina_Bool animate)
661 Widget_Data *wd = elm_widget_data_get(obj);
664 Elm_Segment_Item *it, *it_rel;
666 it = _item_new(obj, label, icon);
667 it_rel = _item_find(obj, index);
670 wd->seg_ctrl = eina_list_append(wd->seg_ctrl, it);
675 wd->seg_ctrl = eina_list_prepend_relative(wd->seg_ctrl, it, it_rel);
677 evas_object_event_callback_add(it->base, EVAS_CALLBACK_MOUSE_DOWN, _mouse_down, it);
678 evas_object_event_callback_add(it->base, EVAS_CALLBACK_MOUSE_UP, _mouse_up, it);
679 wd->insert_index = index;
680 wd->id = eina_list_count(wd->seg_ctrl);
681 _refresh_segment_ids(obj);
684 if(animate && it->segment_id && wd->ani_it == NULL)
687 evas_object_resize(it->base, 1, wd->height);
688 wd->ani = ecore_animator_add( _animator_animate_add_cb, obj );
691 _state_value_set(obj);
693 evas_object_show( it->base);
695 if(index >= wd->id-1)
697 evas_object_box_append(wd->box, it->base);
701 evas_object_box_insert_at(wd->box, it->base, index);
704 evas_object_smart_calculate(wd->box);
709 * Delete a segment to segmentcontrol
710 * @param obj The SegmentControl object
711 * @param item The Segment to be deleted
712 * @param animate If 1 the action be animated with sliding effects default 0.
714 * @ingroup SegmentControl SegmentControl
717 elm_segment_control_delete_segment(Evas_Object *obj, Elm_Segment_Item *item, Eina_Bool animate)
719 Widget_Data *wd = elm_widget_data_get(obj);
724 Elm_Segment_Item *it;
725 it = _item_search(obj, item);
728 wd->del_index = it->segment_id;
729 if(animate && it->segment_id && wd->ani_it == NULL)
731 it->delete_me = EINA_TRUE;
733 wd->ani = ecore_animator_add( _animator_animate_del_cb, obj );
737 evas_object_box_remove(wd->box, it->base);
738 evas_object_smart_calculate(wd->box);
740 _refresh_segment_ids(obj);
741 _state_value_set(obj);
744 wd->id = eina_list_count(wd->seg_ctrl);
749 * Delete a segment to segmentcontrol
750 * @param obj The SegmentControl object
751 * @param index The position at which segment to be deleted
752 * @param animate If 1 the action be animated with sliding effects default 0.
754 * @ingroup SegmentControl SegmentControl
758 elm_segment_control_delete_segment_at(Evas_Object *obj, unsigned int index, Eina_Bool animate)
760 Widget_Data *wd = elm_widget_data_get(obj);
762 Elm_Segment_Item *it;
764 it = _item_find(obj, index);
768 wd->del_index = index;
769 if(animate && it->segment_id)
771 if(wd->ani_it == NULL)
774 it->delete_me = EINA_TRUE;
775 wd->ani = ecore_animator_add( _animator_animate_del_cb, obj );
780 evas_object_box_remove(wd->box, it->base);
781 evas_object_smart_calculate(wd->box);
783 _refresh_segment_ids(obj);
784 _state_value_set(obj);
787 wd->id = eina_list_count(wd->seg_ctrl);
792 * Get the label of a segment of segmentcontrol
793 * @param obj The SegmentControl object
794 * @param index The index of the segment
797 * @ingroup SegmentControl SegmentControl
801 elm_segment_control_get_segment_label_at(Evas_Object *obj, unsigned int index)
803 Elm_Segment_Item *it_rel;
804 Widget_Data *wd = elm_widget_data_get(obj);
807 it_rel = _item_find(obj, index);
809 if(it_rel) return it_rel->label;
815 * Get the icon of a segment of segmentcontrol
816 * @param obj The SegmentControl object
817 * @param index The index of the segment
818 * @return The icon object
820 * @ingroup SegmentControl SegmentControl
824 elm_segment_control_get_segment_icon_at(Evas_Object *obj, unsigned int index)
826 Elm_Segment_Item *seg_rel;
827 Widget_Data *wd = elm_widget_data_get(obj);
830 seg_rel = _item_find(obj, index);
832 if(seg_rel) return seg_rel->icon;
838 * Get the currently selected segment of segmentcontrol
839 * @param obj The SegmentControl object
840 * @param value The current segment id
841 * @return The selected Segment
843 * @ingroup SegmentControl SegmentControl
846 EAPI Elm_Segment_Item *
847 elm_segment_control_selected_segment_get(const Evas_Object *obj, int *value)
849 Widget_Data *wd = elm_widget_data_get(obj);
850 if(!wd || !wd->seg_ctrl) return NULL;
852 Elm_Segment_Item *it;
855 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
857 if(it->segment_id == wd->cur_seg_id)
859 *value = wd->cur_seg_id;
867 * Get the count of segments of segmentcontrol
868 * @param obj The SegmentControl object
869 * @return The count of Segments
871 * @ingroup SegmentControl SegmentControl
875 elm_segment_control_get_segment_count(Evas_Object *obj)
877 Widget_Data *wd = elm_widget_data_get(obj);