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 _mouse_up(void *data, Evas *e, Evas_Object *obj, void *event_info)
78 Elm_Segment_Item *item = (Elm_Segment_Item *) data;
79 Widget_Data *wd = elm_widget_data_get(item->obj);
83 if(wd->selected == EINA_TRUE)
85 wd->selected = EINA_FALSE;
89 if(wd->longpressed == EINA_FALSE)
91 edje_object_signal_emit(item->base, "elm,action,unfocus", "elm");
92 edje_object_signal_emit(item->base, "elm,state,text,visible", "elm");
96 ecore_timer_del(item->long_timer);
97 item->long_timer = NULL;
102 _signal_segment_on(void *data)
104 Elm_Segment_Item *item = (Elm_Segment_Item *) data;
105 Widget_Data *wd = elm_widget_data_get(item->obj);
109 if (item->long_timer)
111 ecore_timer_del(item->long_timer);
112 item->long_timer = NULL;
114 wd->longpressed = EINA_TRUE;
115 edje_object_signal_emit(item->base, "elm,state,segment,on", "elm");
116 edje_object_signal_emit(item->base, "elm,state,text,change", "elm");
118 Elm_Segment_Item *it;
121 if (item->segment_id == wd->cur_seg_id)
123 wd->cur_seg_id = item->segment_id;
124 evas_object_smart_callback_call(item->obj, "changed", (void*)wd->cur_seg_id);
127 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
129 if (it->segment_id == wd->cur_seg_id)
131 edje_object_signal_emit(it->base, "elm,action,unfocus", "elm");
132 edje_object_signal_emit(it->base, "elm,state,segment,off", "elm");
133 edje_object_signal_emit(it->base, "elm,state,text,visible", "elm");
137 wd->cur_seg_id = item->segment_id;
138 evas_object_smart_callback_call(item->obj, "changed", (void*)wd->cur_seg_id);
143 _mouse_down(void *data, Evas *evas, Evas_Object *obj, void *event_info)
145 Elm_Segment_Item *item = (Elm_Segment_Item *) data;
146 Widget_Data *wd = elm_widget_data_get(item->obj);
149 wd->longpressed = EINA_FALSE;
151 if (item->segment_id == wd->cur_seg_id)
153 wd->selected = EINA_TRUE;
157 edje_object_signal_emit(item->base, "elm,action,focus", "elm");
158 edje_object_signal_emit(item->base, "elm,state,text,visible", "elm");
160 if (item->long_timer) ecore_timer_del(item->long_timer);
161 item->long_timer = ecore_timer_add(0.3, _signal_segment_on, item);
165 _theme_hook(Evas_Object *obj)
167 _elm_theme_object_set(obj, obj, "segmented-control", "base", elm_widget_style_get(obj));
173 _item_free(Evas_Object *obj, Elm_Segment_Item *it)
175 Widget_Data *wd = elm_widget_data_get(obj);
179 wd->seg_ctrl = eina_list_remove(wd->seg_ctrl, it);
181 if(it->icon) evas_object_del(it->icon);
182 if(it->base) evas_object_del(it->base);
183 if(it->label) eina_stringshare_del(it->label);
184 if (it->long_timer) ecore_timer_del(it->long_timer);
193 _del_hook(Evas_Object *obj)
195 Widget_Data *wd = elm_widget_data_get(obj);
196 Elm_Segment_Item *it;
197 Eina_List *l, *clear = NULL;
199 EINA_LIST_FOREACH(wd->seg_ctrl, l, it) clear = eina_list_append(clear, it);
200 EINA_LIST_FREE(clear, it) _item_free(obj, it);
210 _layout(Evas_Object *o, Evas_Object_Box_Data *priv, void *data)
212 Widget_Data *wd = data;
214 _els_box_layout(o, priv, 1, 0); /* making box layout non homogenous */
220 _segment_resizing(void *data)
222 Widget_Data *wd = elm_widget_data_get((Evas_Object *)data);
224 Evas_Coord w = 0, h = 0;
226 evas_object_geometry_get(wd->base, NULL, NULL, &w, &h);
227 wd->item_width = wd->width = w;
229 _state_value_set((Evas_Object *)data);
232 static void _object_resize(void *data, Evas *e, Evas_Object *obj, void *event_info)
236 wd = elm_widget_data_get((Evas_Object *)data);
239 ecore_job_add(_segment_resizing, (Evas_Object *)data);
243 * Add a new segmentcontrol to the parent
244 * @param parent The parent object
245 * @return The new object or NULL if it cannot be created
247 * @ingroup SegmentControl SegmentControl
250 elm_segment_control_add(Evas_Object *parent)
256 wd = ELM_NEW(Widget_Data);
257 e = evas_object_evas_get(parent);
258 obj = elm_widget_add(e);
259 elm_widget_type_set(obj, "segmented-control");
260 elm_widget_sub_object_add(parent, obj);
261 elm_widget_on_focus_hook_set( obj, _on_focus_hook, NULL );
262 elm_widget_data_set(obj, wd);
263 elm_widget_del_hook_set(obj, _del_hook);
264 elm_widget_theme_hook_set(obj, _theme_hook);
266 wd->base = edje_object_add(e);
267 _elm_theme_object_set(obj, wd->base, "segmented-control", "base", "default");
268 elm_widget_resize_object_set(obj, wd->base);
269 wd->box = evas_object_box_add(e);
270 evas_object_box_layout_set(wd->box, _layout, wd, NULL);
271 elm_widget_sub_object_add(obj, wd->box);
272 edje_object_part_swallow(wd->base, "elm.swallow.content", wd->box);
273 evas_object_show(wd->box);
275 evas_object_event_callback_add(obj, EVAS_CALLBACK_RESIZE, _object_resize, obj);
278 wd->insert_index = 0;
280 wd->selected = EINA_FALSE;
285 static Elm_Segment_Item*
286 _item_new(Evas_Object *obj, const char *label, Evas_Object *icon)
288 Widget_Data *wd = elm_widget_data_get(obj);
289 if (!wd) return NULL;
291 Elm_Segment_Item *it;
292 it = calloc(1, sizeof( Elm_Segment_Item));
293 if (!it) return NULL;
297 if(obj) it->obj = obj;
298 it->delete_me = EINA_FALSE;
299 it->segment_id = wd->id;
301 it->base = edje_object_add(evas_object_evas_get(obj));
302 _elm_theme_object_set(obj, it->base, "segment", "base", elm_object_style_get(it->base));
304 if (it->label) eina_stringshare_del(it->label);
307 it->label = eina_stringshare_add(label);
314 if ((it->icon != icon) && (it->icon))
315 elm_widget_sub_object_del(obj, it->icon);
319 elm_widget_sub_object_add(obj, icon);
320 Evas_Coord minw = -1, minh = -1, maxw = -1, maxh = -1;
321 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
322 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
324 evas_object_size_hint_weight_set(it->base, 1.0, -1.0);
325 evas_object_size_hint_align_set(it->base, 1.0, -1.0);
326 evas_object_size_hint_min_set(it->base, -1, -1);
327 evas_object_size_hint_max_set(it->base, maxw, maxh);
330 edje_object_size_min_restricted_calc(obj, &mw, &mh, 0, 0);
331 evas_object_size_hint_weight_set(obj, 1.0, 1.0);
332 evas_object_size_hint_align_set(obj, -1.0, -1.0);
338 static void _update_list(Evas_Object *obj)
340 Widget_Data *wd = elm_widget_data_get(obj);
343 Elm_Segment_Item *it;
346 wd->count = eina_list_count(wd->seg_ctrl);
350 it = _item_find(obj, 0);
351 _elm_theme_object_set(obj, it->base, "segment", "base", "single"); edje_object_signal_emit(it->base, "elm,state,segment,on", "elm");
352 edje_object_signal_emit(it->base, "elm,state,text,visible", "elm");
353 edje_object_signal_emit(it->base, "elm,state,text,change", "elm");
354 edje_object_message_signal_process(it->base);
356 edje_object_part_text_set(it->base, "elm.text", it->label);
358 edje_object_part_swallow(it->base, "elm.swallow.content", it->icon);
359 edje_object_signal_emit(it->base, "elm,state,icon,visible", "elm");
363 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
367 _elm_theme_object_set(obj, it->base, "segment", "base", "first");
369 else if(i==wd->count-1)
371 _elm_theme_object_set(obj, it->base, "segment", "base", "last");
375 _elm_theme_object_set(obj, it->base, "segment", "base", "default");
378 edje_object_signal_emit(it->base, "elm,state,text,visible", "elm");
379 edje_object_message_signal_process(it->base);
381 edje_object_part_text_set(it->base, "elm.text", it->label);
383 edje_object_part_swallow(it->base, "elm.swallow.content", it->icon);
384 edje_object_signal_emit(it->base, "elm,state,icon,visible", "elm");
391 static void _refresh_segment_ids(Evas_Object *obj)
393 Widget_Data *wd = elm_widget_data_get(obj);
395 Elm_Segment_Item *it;
397 if (wd->insert_index && wd->cur_seg_id >= wd->insert_index)
400 wd->insert_index = 0;
404 if (wd->cur_seg_id >= wd->del_index)
409 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
416 static void _state_value_set(Evas_Object *obj)
418 Widget_Data *wd = elm_widget_data_get(obj);
420 Elm_Segment_Item *it;
422 Evas_Coord mw, mh, x, y;
424 unsigned int count = eina_list_count(wd->seg_ctrl);
426 wd->item_width = wd->width/count;
429 evas_object_geometry_get(wd->ani_it->base, &x, &y, &w1, NULL);
430 if (wd->ani_it->delete_me)
432 w1-=(wd->item_width/15);
437 w1+=(wd->item_width/15);
438 if( w1 > wd->item_width )
441 w2 = (wd->width-w1)/(count -1);
448 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
450 edje_object_size_min_restricted_calc(it->base, &mw, &mh, 0, 0);
451 evas_object_size_hint_weight_set(it->base, 1.0, 1.0);
452 evas_object_size_hint_align_set(it->base, -1.0, -1.0);
454 if(wd->ani_it && it == wd->ani_it)
456 evas_object_resize(it->base, w1, wd->height);
457 evas_object_size_hint_min_set(it->base, w1, wd->height);
458 evas_object_size_hint_max_set(it->base, w1, wd->height);
462 evas_object_resize(it->base, w2, wd->height);
463 evas_object_size_hint_min_set(it->base, w2, wd->height);
464 evas_object_size_hint_max_set(it->base, w2, wd->height);
474 _animator_animate_add_cb(Evas_Object *obj)
476 Widget_Data *wd = elm_widget_data_get(obj);
480 evas_object_geometry_get(wd->ani_it->base, NULL, NULL, &w, NULL);
481 if( w < wd->item_width )
483 _state_value_set(obj);
484 evas_object_geometry_get(wd->ani_it->base, NULL, NULL, &w, NULL);
485 return ECORE_CALLBACK_RENEW;
489 ecore_animator_del(wd->ani);
492 return ECORE_CALLBACK_CANCEL;
498 _animator_animate_del_cb(Evas_Object *obj)
500 Widget_Data *wd = elm_widget_data_get(obj);
503 evas_object_geometry_get(wd->ani_it->base, NULL, NULL, &w, NULL);
506 _state_value_set(obj);
507 evas_object_geometry_get(wd->ani_it->base, NULL, NULL, &w, NULL);
508 return ECORE_CALLBACK_RENEW;
512 _item_free(obj, wd->ani_it );
513 _refresh_segment_ids(obj);
514 ecore_animator_del(wd->ani);
518 wd->id = eina_list_count(wd->seg_ctrl);
519 return ECORE_CALLBACK_CANCEL;
524 * Add a new segment to segmentcontrol
525 * @param obj The SegmentControl object
526 * @param icon The icon object for added segment
527 * @param label The label for added segment
528 * @param animate If 1 the action be animated with sliding effects default 0.
529 * @return The new segment or NULL if it cannot be created
531 * @ingroup SegmentControl SegmentControl
534 EAPI Elm_Segment_Item *
535 elm_segment_control_add_segment(Evas_Object *obj, Evas_Object *icon, const char *label, Eina_Bool animate)
537 Widget_Data *wd = elm_widget_data_get(obj);
540 Elm_Segment_Item *it;
542 it = _item_new(obj, label, icon);
545 wd->seg_ctrl = eina_list_append(wd->seg_ctrl, it);
546 wd->id = eina_list_count(wd->seg_ctrl);
548 evas_object_event_callback_add(it->base, EVAS_CALLBACK_MOUSE_DOWN, _mouse_down, it);
549 evas_object_event_callback_add(it->base, EVAS_CALLBACK_MOUSE_UP, _mouse_up, it);
550 wd->insert_index = 0;
552 _refresh_segment_ids(obj);
554 if(animate && it->segment_id && wd->ani_it == NULL)
556 evas_object_resize(it->base, 1, wd->height);
558 wd->ani = ecore_animator_add( _animator_animate_add_cb, obj );
561 _state_value_set(obj);
562 evas_object_show( it->base);
564 evas_object_box_append(wd->box, it->base);
565 evas_object_smart_calculate(wd->box);
571 static Elm_Segment_Item *
572 _item_find(Evas_Object *obj, unsigned int index)
574 Widget_Data *wd = elm_widget_data_get(obj);
575 if (!wd) return NULL;
577 Elm_Segment_Item *it;
580 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
591 static Elm_Segment_Item *
592 _item_search(Evas_Object *obj, Elm_Segment_Item *item)
594 Widget_Data *wd = elm_widget_data_get(obj);
598 Elm_Segment_Item *it;
600 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
610 * Insert a new segment to segmentcontrol
611 * @param obj The SegmentControl object
612 * @param icon The icon object for added segment
613 * @param label The label for added segment
614 * @param index The position at which segment to be inserted
615 * @param animate If 1 the action be animated with sliding effects default 0.
616 * @return The new segment or NULL if it cannot be created
618 * @ingroup SegmentControl SegmentControl
621 elm_segment_control_insert_segment_at(Evas_Object *obj, Evas_Object *icon, const char *label, unsigned int index, Eina_Bool animate)
623 Widget_Data *wd = elm_widget_data_get(obj);
626 Elm_Segment_Item *it, *it_rel;
628 it = _item_new(obj, label, icon);
629 it_rel = _item_find(obj, index);
632 wd->seg_ctrl = eina_list_append(wd->seg_ctrl, it);
637 wd->seg_ctrl = eina_list_prepend_relative(wd->seg_ctrl, it, it_rel);
639 evas_object_event_callback_add(it->base, EVAS_CALLBACK_MOUSE_DOWN, _mouse_down, it);
640 evas_object_event_callback_add(it->base, EVAS_CALLBACK_MOUSE_UP, _mouse_up, it);
641 wd->insert_index = index;
642 wd->id = eina_list_count(wd->seg_ctrl);
643 _refresh_segment_ids(obj);
646 if(animate && it->segment_id && wd->ani_it == NULL)
649 evas_object_resize(it->base, 1, wd->height);
650 wd->ani = ecore_animator_add( _animator_animate_add_cb, obj );
653 _state_value_set(obj);
655 evas_object_show( it->base);
657 if(index >= wd->id-1)
659 evas_object_box_append(wd->box, it->base);
663 evas_object_box_insert_at(wd->box, it->base, index);
666 evas_object_smart_calculate(wd->box);
671 * Delete a segment to segmentcontrol
672 * @param obj The SegmentControl object
673 * @param item The Segment to be deleted
674 * @param animate If 1 the action be animated with sliding effects default 0.
676 * @ingroup SegmentControl SegmentControl
679 elm_segment_control_delete_segment(Evas_Object *obj, Elm_Segment_Item *item, Eina_Bool animate)
681 Widget_Data *wd = elm_widget_data_get(obj);
686 Elm_Segment_Item *it;
687 it = _item_search(obj, item);
690 wd->del_index = it->segment_id;
691 if(animate && it->segment_id && wd->ani_it == NULL)
693 it->delete_me = EINA_TRUE;
695 wd->ani = ecore_animator_add( _animator_animate_del_cb, obj );
699 evas_object_box_remove(wd->box, it->base);
700 evas_object_smart_calculate(wd->box);
702 _refresh_segment_ids(obj);
703 _state_value_set(obj);
706 wd->id = eina_list_count(wd->seg_ctrl);
711 * Delete a segment to segmentcontrol
712 * @param obj The SegmentControl object
713 * @param index The position at which segment to be deleted
714 * @param animate If 1 the action be animated with sliding effects default 0.
716 * @ingroup SegmentControl SegmentControl
720 elm_segment_control_delete_segment_at(Evas_Object *obj, unsigned int index, Eina_Bool animate)
722 Widget_Data *wd = elm_widget_data_get(obj);
724 Elm_Segment_Item *it;
726 it = _item_find(obj, index);
730 wd->del_index = index;
731 if(animate && it->segment_id)
733 if(wd->ani_it == NULL)
736 it->delete_me = EINA_TRUE;
737 wd->ani = ecore_animator_add( _animator_animate_del_cb, obj );
742 evas_object_box_remove(wd->box, it->base);
743 evas_object_smart_calculate(wd->box);
745 _refresh_segment_ids(obj);
746 _state_value_set(obj);
749 wd->id = eina_list_count(wd->seg_ctrl);
754 * Get the label of a segment of segmentcontrol
755 * @param obj The SegmentControl object
756 * @param index The index of the segment
759 * @ingroup SegmentControl SegmentControl
763 elm_segment_control_get_segment_label_at(Evas_Object *obj, unsigned int index)
765 Elm_Segment_Item *it_rel;
766 Widget_Data *wd = elm_widget_data_get(obj);
769 it_rel = _item_find(obj, index);
771 if(it_rel) return it_rel->label;
777 * Get the icon of a segment of segmentcontrol
778 * @param obj The SegmentControl object
779 * @param index The index of the segment
780 * @return The icon object
782 * @ingroup SegmentControl SegmentControl
786 elm_segment_control_get_segment_icon_at(Evas_Object *obj, unsigned int index)
788 Elm_Segment_Item *seg_rel;
789 Widget_Data *wd = elm_widget_data_get(obj);
792 seg_rel = _item_find(obj, index);
794 if(seg_rel) return seg_rel->icon;
800 * Get the currently selected segment of segmentcontrol
801 * @param obj The SegmentControl object
802 * @param value The current segment id
803 * @return The selected Segment
805 * @ingroup SegmentControl SegmentControl
808 EAPI Elm_Segment_Item *
809 elm_segment_control_selected_segment_get(const Evas_Object *obj, int *value)
811 Widget_Data *wd = elm_widget_data_get(obj);
812 if(!wd || !wd->seg_ctrl) return NULL;
814 Elm_Segment_Item *it;
817 EINA_LIST_FOREACH(wd->seg_ctrl, l, it)
819 if(it->segment_id == wd->cur_seg_id)
821 *value = wd->cur_seg_id;
829 * Get the count of segments of segmentcontrol
830 * @param obj The SegmentControl object
831 * @return The count of Segments
833 * @ingroup SegmentControl SegmentControl
837 elm_segment_control_get_segment_count(Evas_Object *obj)
839 Widget_Data *wd = elm_widget_data_get(obj);