1 #include <Elementary.h>
3 #include "elm_widget_container.h"
4 #include "elm_interface_scrollable.h"
6 static const char ELM_WIDGET_SMART_NAME[] = "elm_widget";
9 Elm_Widget_Smart_Data * sd = evas_object_smart_data_get(obj); \
10 if ((!sd) || (!_elm_widget_is(obj)))
11 #define INTERNAL_ENTRY \
12 Elm_Widget_Smart_Data * sd = evas_object_smart_data_get(obj); \
16 #define ELM_WIDGET_FOCUS_GET(obj) \
17 ((_elm_access_read_mode_get()) ? (elm_widget_highlight_get(obj)) : \
18 (elm_widget_focus_get(obj)))
19 typedef struct _Elm_Event_Cb_Data Elm_Event_Cb_Data;
20 typedef struct _Elm_Translate_String_Data Elm_Translate_String_Data;
22 struct _Elm_Event_Cb_Data
28 struct _Elm_Translate_String_Data
35 /* local subsystem globals */
36 static unsigned int focus_order = 0;
38 static inline Eina_Bool
39 _elm_widget_is(const Evas_Object *obj)
41 return evas_object_smart_type_check_ptr(obj, ELM_WIDGET_SMART_NAME);
44 static inline Eina_Bool
45 _is_focusable(Evas_Object *obj)
47 API_ENTRY return EINA_FALSE;
48 return sd->can_focus || (sd->child_can_focus);
51 static inline Eina_Bool
52 _elm_scrollable_is(const Evas_Object *obj)
54 INTERNAL_ENTRY EINA_FALSE;
55 return !!evas_object_smart_interface_get(obj, ELM_SCROLLABLE_IFACE_NAME);
58 /* what follows are basic (unimplemented) smart class functions */
59 #define UNIMPLEMENTED_MAKE(_prefix) \
61 _elm_widget_##_prefix##_func_unimplemented(Evas_Object * obj) \
63 WRN("The %s widget does not implement the \"" #_prefix "\" function.", \
64 elm_widget_type_get(obj)); \
68 UNIMPLEMENTED_MAKE(disable);
69 UNIMPLEMENTED_MAKE(translate);
71 #undef UNIMPLEMENTED_MAKE
75 * Resets the mirrored mode from the system mirror mode for widgets that are in
76 * automatic mirroring mode. This function does not call elm_widget_theme.
78 * @param obj The widget.
79 * @param mirrored EINA_TRUE to set mirrored mode. EINA_FALSE to unset.
82 _elm_widget_mirrored_reload(Evas_Object *obj)
85 Eina_Bool mirrored = elm_config_mirrored_get();
87 if (elm_widget_mirrored_automatic_get(obj) && (sd->is_mirrored != mirrored))
89 sd->is_mirrored = mirrored;
94 _elm_widget_theme_func(Evas_Object *obj)
96 _elm_widget_mirrored_reload(obj);
98 elm_widget_disabled_set(obj, elm_widget_disabled_get(obj));
104 _elm_widget_on_focus_region_func_unimplemented(const Evas_Object *obj __UNUSED__,
105 Evas_Coord *x __UNUSED__,
106 Evas_Coord *y __UNUSED__,
107 Evas_Coord *w __UNUSED__,
108 Evas_Coord *h __UNUSED__)
110 WRN("The %s widget does not implement the \"on_focus_region\" function.",
111 elm_widget_type_get(obj));
116 _elm_widget_on_focus_func_unimplemented(Evas_Object *obj)
118 WRN("The %s widget does not implement the \"on_focus\" function.",
119 elm_widget_type_get(obj));
124 _elm_widget_event_func_unimplemented(Evas_Object *obj,
125 Evas_Object *source __UNUSED__,
126 Evas_Callback_Type type __UNUSED__,
127 void *event_info __UNUSED__)
129 WRN("The %s widget does not implement the \"event\" function.",
130 elm_widget_type_get(obj));
135 _elm_widget_focus_next_func_unimplemented(const Evas_Object *obj,
136 Elm_Focus_Direction dir __UNUSED__,
137 Evas_Object **next __UNUSED__)
139 WRN("The %s widget does not implement the \"focus_next\" function.",
140 elm_widget_type_get(obj));
145 _elm_widget_focus_direction_func_unimplemented(const Evas_Object *obj,
146 const Evas_Object *b __UNUSED__,
147 double degree __UNUSED__,
148 Evas_Object **target __UNUSED__,
149 double *weight __UNUSED__)
151 WRN("The %s widget does not implement the \"focus_direction\" function.",
152 elm_widget_type_get(obj));
157 _parents_focus(Evas_Object *obj)
159 for (; obj; obj = elm_widget_parent_get(obj))
162 if (sd->focused) return;
168 _parents_unfocus(Evas_Object *obj)
170 for (; obj; obj = elm_widget_parent_get(obj))
173 if (!sd->focused) return;
179 _on_sub_obj_hide(void *data __UNUSED__,
182 void *event_info __UNUSED__)
184 elm_widget_focus_hide_handle(obj);
188 _on_sub_obj_del(void *data,
191 void *event_info __UNUSED__)
193 Elm_Widget_Smart_Data *sd = data;
195 if (_elm_widget_is(obj))
197 if (elm_widget_focus_get(obj)) _parents_unfocus(sd->obj);
199 if (obj == sd->resize_obj)
201 /* already dels sub object */
202 elm_widget_resize_object_set(sd->obj, NULL);
205 else if (obj == sd->hover_obj)
207 sd->hover_obj = NULL;
212 if (!elm_widget_sub_object_del(sd->obj, obj))
213 ERR("failed to remove sub object %p from %p\n", obj, sd->obj);
218 _elm_widget_sub_object_add_func(Evas_Object *obj,
221 double scale, pscale = elm_widget_scale_get(sobj);
222 Elm_Theme *th, *pth = elm_widget_theme_get(sobj);
223 Eina_Bool mirrored, pmirrored = elm_widget_mirrored_get(obj);
225 ELM_WIDGET_DATA_GET(obj, sd);
226 EINA_SAFETY_ON_TRUE_RETURN_VAL(obj == sobj, EINA_FALSE);
228 if (sobj == sd->parent_obj)
230 /* in this case, sobj must be an elm widget, or something
231 * very wrong is happening */
232 if (!_elm_widget_is(sobj)) return EINA_FALSE;
234 if (!elm_widget_sub_object_del(sobj, obj)) return EINA_FALSE;
235 WRN("You passed a parent object of obj = %p as the sub object = %p!",
239 if (_elm_widget_is(sobj))
241 ELM_WIDGET_DATA_GET(sobj, sdc);
243 if (sdc->parent_obj == obj) return EINA_TRUE;
246 if (!elm_widget_sub_object_del(sdc->parent_obj, sobj))
249 sdc->parent_obj = obj;
250 sdc->orient_mode = sd->orient_mode;
251 _elm_widget_top_win_focused_set(sobj, sd->top_win_focused);
253 /* update child focusable-ness on self and parents, now that a
254 * focusable child got in */
255 if (!sd->child_can_focus && (_is_focusable(sobj)))
257 Elm_Widget_Smart_Data *sdp = sd;
259 sdp->child_can_focus = EINA_TRUE;
260 while (sdp->parent_obj)
262 sdp = evas_object_smart_data_get(sdp->parent_obj);
264 if (sdp->child_can_focus) break;
266 sdp->child_can_focus = EINA_TRUE;
272 void *data = evas_object_data_get(sobj, "elm-parent");
276 if (data == obj) return EINA_TRUE;
277 if (!elm_widget_sub_object_del(data, sobj)) return EINA_FALSE;
281 sd->subobjs = eina_list_append(sd->subobjs, sobj);
282 evas_object_data_set(sobj, "elm-parent", obj);
283 evas_object_event_callback_add
284 (sobj, EVAS_CALLBACK_DEL, _on_sub_obj_del, sd);
285 if (_elm_widget_is(sobj))
287 evas_object_event_callback_add
288 (sobj, EVAS_CALLBACK_HIDE, _on_sub_obj_hide, sd);
290 scale = elm_widget_scale_get(sobj);
291 th = elm_widget_theme_get(sobj);
292 mirrored = elm_widget_mirrored_get(sobj);
294 if ((scale != pscale) || (th != pth) || (pmirrored != mirrored))
295 elm_widget_theme(sobj);
297 if (elm_widget_focus_get(sobj)) _parents_focus(obj);
304 _elm_widget_sub_object_del_func(Evas_Object *obj,
307 Evas_Object *sobj_parent;
309 if (!sobj) return EINA_FALSE;
311 ELM_WIDGET_DATA_GET(obj, sd);
312 EINA_SAFETY_ON_TRUE_RETURN_VAL(obj == sobj, EINA_FALSE);
314 sobj_parent = evas_object_data_del(sobj, "elm-parent");
315 if (sobj_parent != obj)
317 static int abort_on_warn = -1;
319 ERR("removing sub object %p (%s) from parent %p (%s), "
320 "but elm-parent is different %p (%s)!",
321 sobj, elm_widget_type_get(sobj), obj, elm_widget_type_get(obj),
322 sobj_parent, elm_widget_type_get(sobj_parent));
324 if (EINA_UNLIKELY(abort_on_warn == -1))
326 if (getenv("ELM_ERROR_ABORT")) abort_on_warn = 1;
327 else abort_on_warn = 0;
329 if (abort_on_warn == 1) abort();
334 if (_elm_widget_is(sobj))
336 if (elm_widget_focus_get(sobj))
338 elm_widget_tree_unfocusable_set(sobj, EINA_TRUE);
339 elm_widget_tree_unfocusable_set(sobj, EINA_FALSE);
341 if ((sd->child_can_focus) && (_is_focusable(sobj)))
343 Evas_Object *parent = obj;
345 /* update child focusable-ness on self and parents, now that a
346 * focusable child is gone */
352 ELM_WIDGET_DATA_GET(parent, sdp);
354 sdp->child_can_focus = EINA_FALSE;
355 EINA_LIST_FOREACH(sdp->subobjs, l, subobj)
357 if ((subobj != sobj) && (_is_focusable(subobj)))
359 sdp->child_can_focus = EINA_TRUE;
364 /* break again, child_can_focus went back to
366 if (sdp->child_can_focus) break;
367 parent = sdp->parent_obj;
371 ELM_WIDGET_DATA_GET(sobj, sdc);
372 sdc->parent_obj = NULL;
375 if (sd->resize_obj == sobj) sd->resize_obj = NULL;
377 sd->subobjs = eina_list_remove(sd->subobjs, sobj);
379 evas_object_event_callback_del_full
380 (sobj, EVAS_CALLBACK_DEL, _on_sub_obj_del, sd);
381 if (_elm_widget_is(sobj))
382 evas_object_event_callback_del_full
383 (sobj, EVAS_CALLBACK_HIDE, _on_sub_obj_hide, sd);
388 static const Evas_Smart_Cb_Description _smart_callbacks[] =
390 /* FIXME: complete later */
395 _smart_add(Evas_Object *obj)
397 const Evas_Smart_Class *sc;
398 const Evas_Smart *smart;
400 EVAS_SMART_DATA_ALLOC(obj, Elm_Widget_Smart_Data);
402 smart = evas_object_smart_smart_get(obj);
403 sc = evas_smart_class_get(smart);
404 priv->api = (const Elm_Widget_Smart_Class *)sc;
406 priv->x = priv->y = priv->w = priv->h = 0;
407 priv->mirrored_auto_mode = EINA_TRUE; /* will follow system locale
409 elm_widget_can_focus_set(obj, EINA_TRUE);
410 elm_widget_mirrored_set(obj, elm_config_mirrored_get());
412 /* just a helper for inheriting classes */
413 if (priv->resize_obj)
415 Evas_Object *r_obj = priv->resize_obj;
416 priv->resize_obj = NULL;
418 elm_widget_resize_object_set(obj, r_obj);
424 _if_focused_revert(Evas_Object *obj,
425 Eina_Bool can_focus_only)
428 Evas_Object *newest = NULL;
429 unsigned int newest_focus_order = 0;
433 if (!sd->focused) return;
434 if (!sd->parent_obj) return;
436 top = elm_widget_top_get(sd->parent_obj);
439 newest = elm_widget_newest_focus_order_get
440 (top, &newest_focus_order, can_focus_only);
443 elm_object_focus_set(newest, EINA_FALSE);
444 elm_object_focus_set(newest, EINA_TRUE);
450 _smart_del(Evas_Object *obj)
453 Elm_Translate_String_Data *ts;
454 Elm_Event_Cb_Data *ecb;
456 ELM_WIDGET_DATA_GET(obj, sd);
460 /* detach it from us */
461 evas_object_event_callback_del_full
462 (sd->hover_obj, EVAS_CALLBACK_DEL, _on_sub_obj_del, sd);
463 sd->hover_obj = NULL;
468 sobj = eina_list_data_get(sd->subobjs);
470 /* let the objects clean-up themselves and get rid of this list */
471 if (!elm_widget_sub_object_del(obj, sobj))
473 ERR("failed to remove sub object %p from %p\n", sobj, obj);
474 sd->subobjs = eina_list_remove_list
475 (sd->subobjs, sd->subobjs);
477 evas_object_del(sobj);
479 sd->tooltips = eina_list_free(sd->tooltips); /* should be empty anyway */
480 sd->cursors = eina_list_free(sd->cursors); /* should be empty anyway */
481 EINA_LIST_FREE (sd->translate_strings, ts)
483 eina_stringshare_del(ts->id);
484 eina_stringshare_del(ts->domain);
485 eina_stringshare_del(ts->string);
489 EINA_LIST_FREE (sd->event_cb, ecb)
492 if (sd->style) eina_stringshare_del(sd->style);
493 if (sd->theme) elm_theme_free(sd->theme);
494 _if_focused_revert(obj, EINA_TRUE);
495 if (sd->access_info) eina_stringshare_del(sd->access_info);
497 evas_object_smart_data_set(obj, NULL);
501 _smart_reconfigure(Elm_Widget_Smart_Data *sd)
505 evas_object_move(sd->resize_obj, sd->x, sd->y);
506 evas_object_resize(sd->resize_obj, sd->w, sd->h);
510 evas_object_move(sd->hover_obj, sd->x, sd->y);
511 evas_object_resize(sd->hover_obj, sd->w, sd->h);
516 _smart_move(Evas_Object *obj,
520 ELM_WIDGET_DATA_GET(obj, sd);
525 _smart_reconfigure(sd);
529 _smart_resize(Evas_Object *obj,
533 ELM_WIDGET_DATA_GET(obj, sd);
538 _smart_reconfigure(sd);
542 _smart_show(Evas_Object *obj)
547 if ((list = evas_object_smart_members_get(obj)))
549 EINA_LIST_FREE (list, o)
551 if (evas_object_data_get(o, "_elm_leaveme")) continue;
558 _smart_hide(Evas_Object *obj)
563 list = evas_object_smart_members_get(obj);
564 EINA_LIST_FREE (list, o)
566 if (evas_object_data_get(o, "_elm_leaveme")) continue;
572 _smart_color_set(Evas_Object *obj,
581 if ((list = evas_object_smart_members_get(obj)))
583 EINA_LIST_FREE (list, o)
585 if (evas_object_data_get(o, "_elm_leaveme")) continue;
586 evas_object_color_set(o, r, g, b, a);
592 _smart_clip_set(Evas_Object *obj,
598 if ((list = evas_object_smart_members_get(obj)))
600 EINA_LIST_FREE (list, o)
602 if (evas_object_data_get(o, "_elm_leaveme")) continue;
603 evas_object_clip_set(o, clip);
609 _smart_clip_unset(Evas_Object *obj)
614 if ((list = evas_object_smart_members_get(obj)))
616 EINA_LIST_FREE (list, o)
618 if (evas_object_data_get(o, "_elm_leaveme")) continue;
619 evas_object_clip_unset(o);
625 _smart_calculate(Evas_Object *obj __UNUSED__)
627 /* a NO-OP, on the base */
631 _smart_member_add(Evas_Object *obj,
636 if (evas_object_data_get(child, "_elm_leaveme")) return;
638 evas_object_color_get(obj, &r, &g, &b, &a);
639 evas_object_color_set(child, r, g, b, a);
641 evas_object_clip_set(child, evas_object_clip_get(obj));
643 if (evas_object_visible_get(obj))
644 evas_object_show(child);
646 evas_object_hide(child);
650 _smart_member_del(Evas_Object *obj __UNUSED__,
653 if (evas_object_data_get(child, "_elm_leaveme")) return;
654 evas_object_clip_unset(child);
658 _elm_widget_smart_set(Elm_Widget_Smart_Class *api)
660 Evas_Smart_Class *sc;
662 if (!(sc = (Evas_Smart_Class *)api))
665 sc->add = _smart_add;
666 sc->del = _smart_del;
667 sc->move = _smart_move;
668 sc->resize = _smart_resize;
669 sc->show = _smart_show;
670 sc->hide = _smart_hide;
671 sc->color_set = _smart_color_set;
672 sc->clip_set = _smart_clip_set;
673 sc->clip_unset = _smart_clip_unset;
674 sc->calculate = _smart_calculate;
675 sc->member_add = _smart_member_add;
676 sc->member_del = _smart_member_del;
678 #define API_DEFAULT_SET_UNIMPLEMENTED(_prefix) \
679 api->_prefix = _elm_widget_##_prefix##_func_unimplemented;
681 /* NB: always remember to call these parent versions on children,
682 * except for the unimplemented ones and calculate, which is moot */
684 #define API_DEFAULT_SET(_prefix) \
685 api->_prefix = _elm_widget_##_prefix##_func;
688 API_DEFAULT_SET_UNIMPLEMENTED(on_focus);
689 API_DEFAULT_SET_UNIMPLEMENTED(disable);
691 API_DEFAULT_SET(theme);
692 API_DEFAULT_SET_UNIMPLEMENTED(on_focus_region);
694 API_DEFAULT_SET_UNIMPLEMENTED(translate);
695 API_DEFAULT_SET_UNIMPLEMENTED(event);
696 API_DEFAULT_SET_UNIMPLEMENTED(focus_next);
697 API_DEFAULT_SET_UNIMPLEMENTED(focus_direction);
699 /* NB: because those two weren't hooks before, translate the
700 * individual calls to them on the widgets as we bring them to the
701 * new class hierarchy. also, sub_object_{add,del} must be
702 * different than member_{add,del} here, because widget parenting
703 * on elm does not always imply parent and child will live on the
705 API_DEFAULT_SET(sub_object_add);
706 API_DEFAULT_SET(sub_object_del);
708 #undef API_DEFAULT_SET
709 #undef API_DEFAULT_SET_UNIMPLEMENTED
711 sc->callbacks = _smart_callbacks;
715 static inline Eina_Bool
716 _elm_widget_focus_chain_manager_is(const Evas_Object *obj)
718 API_ENTRY return EINA_FALSE;
720 if (!sd->api) return EINA_FALSE;
721 return sd->api->focus_next &&
722 (sd->api->focus_next != _elm_widget_focus_next_func_unimplemented);
725 static inline Eina_Bool
726 _elm_widget_focus_direction_manager_is(const Evas_Object *obj)
728 API_ENTRY return EINA_FALSE;
730 if (!sd->api) return EINA_FALSE;
731 return sd->api->focus_direction &&
732 (sd->api->focus_direction !=
733 _elm_widget_focus_direction_func_unimplemented);
737 _obj_mouse_down(void *data,
739 Evas_Object *obj __UNUSED__,
742 Elm_Widget_Smart_Data *sd = data;
743 Evas_Event_Mouse_Down *ev = event_info;
744 if (!(ev->event_flags & EVAS_EVENT_FLAG_ON_HOLD))
745 sd->still_in = EINA_TRUE;
749 _obj_mouse_move(void *data,
754 Elm_Widget_Smart_Data *sd = data;
755 Evas_Event_Mouse_Move *ev = event_info;
758 if (ev->event_flags & EVAS_EVENT_FLAG_ON_HOLD)
759 sd->still_in = EINA_FALSE;
762 Evas_Coord x, y, w, h;
763 evas_object_geometry_get(obj, &x, &y, &w, &h);
764 if ((ev->cur.canvas.x < x) || (ev->cur.canvas.y < y) ||
765 (ev->cur.canvas.x >= (x + w)) || (ev->cur.canvas.y >= (y + h)))
766 sd->still_in = EINA_FALSE;
772 _obj_mouse_up(void *data,
775 void *event_info __UNUSED__)
777 Elm_Widget_Smart_Data *sd = data;
779 elm_widget_focus_mouse_up_handle(obj);
780 sd->still_in = EINA_FALSE;
784 _propagate_x_drag_lock(Evas_Object *obj,
790 Elm_Widget_Smart_Data *sd2 = evas_object_smart_data_get(sd->parent_obj);
793 sd2->child_drag_x_locked += dir;
794 _propagate_x_drag_lock(sd->parent_obj, dir);
800 _propagate_y_drag_lock(Evas_Object *obj,
806 Elm_Widget_Smart_Data *sd2 = evas_object_smart_data_get(sd->parent_obj);
809 sd2->child_drag_y_locked += dir;
810 _propagate_y_drag_lock(sd->parent_obj, dir);
816 _propagate_event(void *data,
822 Evas_Callback_Type type = (Evas_Callback_Type)(long)data;
823 Evas_Event_Flags *event_flags = NULL;
827 case EVAS_CALLBACK_KEY_DOWN:
829 Evas_Event_Key_Down *ev = event_info;
830 event_flags = &(ev->event_flags);
834 case EVAS_CALLBACK_KEY_UP:
836 Evas_Event_Key_Up *ev = event_info;
837 event_flags = &(ev->event_flags);
841 case EVAS_CALLBACK_MOUSE_WHEEL:
843 Evas_Event_Mouse_Wheel *ev = event_info;
844 event_flags = &(ev->event_flags);
852 elm_widget_event_propagate(obj, type, event_info, event_flags);
856 * If elm_widget_focus_region_get() returns EINA_FALSE, this function will
857 * ignore region show action.
860 _elm_widget_focus_region_show(const Evas_Object *obj)
862 Evas_Coord x, y, ox, oy, w, h;
867 o = elm_widget_parent_get(obj);
870 if (!elm_widget_focus_region_get(obj, &x, &y, NULL, NULL))
873 evas_object_geometry_get(obj, &ox, &oy, &w, &h);
874 if (w == 0 && h == 0) return;
878 if (_elm_scrollable_is(o))
880 Evas_Coord px, py, pw, ph;
883 evas_object_geometry_get(o, &px, &py, &pw, &ph);
885 if ((px <= ox) && (px + pw) >= (ox + w) &&
886 (py <= oy) && (py + ph) >= (oy + h))
888 // if object is already shown
889 o = elm_widget_parent_get(o);
892 else if ((px < ox) && ((px + pw) < (ox + w)))
894 // if object is over the viewport to the x axis.
897 else if ((py < oy) && ((py + ph) < (oy + h)))
899 // if object is over the viewport to the y axis.
903 ELM_SCROLLABLE_IFACE_GET(o, s_iface);
904 s_iface->content_pos_get(o, &rx, &ry);
905 s_iface->content_viewport_size_get(o, &w, &h);
910 s_iface->content_region_show(o, x, y, w, h);
914 o = elm_widget_parent_get(o);
919 _parent_focus(Evas_Object *obj)
923 if (sd->focused) return;
925 Evas_Object *o = elm_widget_parent_get(obj);
926 sd->focus_order_on_calc = EINA_TRUE;
928 if (o) _parent_focus(o);
930 if (!sd->focus_order_on_calc)
931 return; /* we don't want to override it if by means of any of the
932 callbacks below one gets to calculate our order
936 sd->focus_order = focus_order;
937 if (!sd->api) return;
938 if (sd->top_win_focused)
940 sd->focused = EINA_TRUE;
941 sd->api->on_focus(obj);
943 sd->focus_order_on_calc = EINA_FALSE;
945 if (_elm_config->access_mode == ELM_ACCESS_MODE_ON)
946 _elm_access_highlight_set(obj);
950 _elm_object_focus_chain_del_cb(void *data,
953 void *event_info __UNUSED__)
955 Elm_Widget_Smart_Data *sd = data;
957 sd->focus_chain = eina_list_remove(sd->focus_chain, obj);
960 EAPI const Elm_Widget_Smart_Class *
961 elm_widget_smart_class_get(void)
963 static Elm_Widget_Smart_Class _sc =
964 ELM_WIDGET_SMART_CLASS_INIT_NAME_VERSION(ELM_WIDGET_SMART_NAME);
965 static const Elm_Widget_Smart_Class *class = NULL;
970 _elm_widget_smart_set(&_sc);
977 elm_widget_add(Evas_Smart *smart,
983 e = evas_object_evas_get(parent);
986 o = evas_object_smart_add(e, smart);
987 elm_widget_parent_set(o, parent);
993 elm_widget_parent_set(Evas_Object *obj,
996 ELM_WIDGET_DATA_GET(obj, sd);
998 if (!sd->api->parent_set) return;
1000 sd->api->parent_set(obj, parent);
1004 elm_widget_api_check(int ver)
1006 if (ver != ELM_INTERNAL_API_VERSION)
1008 CRITICAL("Elementary widget api versions do not match");
1015 elm_widget_access(Evas_Object *obj,
1016 Eina_Bool is_access)
1020 Eina_Bool ret = EINA_TRUE;
1022 API_ENTRY return EINA_FALSE;
1023 EINA_LIST_FOREACH(sd->subobjs, l, child)
1024 ret &= elm_widget_access(child, is_access);
1026 if (sd->api && sd->api->access)
1027 sd->api->access(obj, is_access);
1035 elm_widget_theme(Evas_Object *obj)
1041 Eina_Bool ret = EINA_TRUE;
1043 API_ENTRY return EINA_FALSE;
1045 EINA_LIST_FOREACH(sd->subobjs, l, child)
1046 if (_elm_widget_is(child)) ret &= elm_widget_theme(child);
1047 if (sd->resize_obj && _elm_widget_is(sd->resize_obj))
1048 ret &= elm_widget_theme(sd->resize_obj);
1049 if (sd->hover_obj) ret &= elm_widget_theme(sd->hover_obj);
1051 EINA_LIST_FOREACH(sd->tooltips, l, tt)
1052 elm_tooltip_theme(tt);
1053 EINA_LIST_FOREACH(sd->cursors, l, cur)
1054 elm_cursor_theme(cur);
1056 if (!sd->api) return EINA_FALSE;
1058 ret &= sd->api->theme(obj);
1064 elm_widget_theme_specific(Evas_Object *obj,
1072 Elm_Theme *th2, *thdef;
1076 thdef = elm_theme_default_get();
1077 if (!th) th = thdef;
1081 if (!th2) th2 = thdef;
1089 if (th2 == thdef) break;
1090 th2 = th2->ref_theme;
1091 if (!th2) th2 = thdef;
1095 EINA_LIST_FOREACH(sd->subobjs, l, child)
1096 elm_widget_theme_specific(child, th, force);
1097 if (sd->resize_obj) elm_widget_theme(sd->resize_obj);
1098 if (sd->hover_obj) elm_widget_theme(sd->hover_obj);
1099 EINA_LIST_FOREACH(sd->tooltips, l, tt)
1100 elm_tooltip_theme(tt);
1101 EINA_LIST_FOREACH(sd->cursors, l, cur)
1102 elm_cursor_theme(cur);
1103 if (!sd->api) return;
1104 sd->api->theme(obj);
1108 * Returns the widget's mirrored mode.
1110 * @param obj The widget.
1111 * @return mirrored mode of the object.
1115 elm_widget_mirrored_get(const Evas_Object *obj)
1117 API_ENTRY return EINA_FALSE;
1118 return sd->is_mirrored;
1122 * Sets the widget's mirrored mode.
1124 * @param obj The widget.
1125 * @param mirrored EINA_TRUE to set mirrored mode. EINA_FALSE to unset.
1128 elm_widget_mirrored_set(Evas_Object *obj,
1133 mirrored = !!mirrored;
1135 if (sd->is_mirrored == mirrored) return;
1137 sd->is_mirrored = mirrored;
1138 elm_widget_theme(obj);
1142 * Returns the widget's mirrored mode setting.
1144 * @param obj The widget.
1145 * @return mirrored mode setting of the object.
1149 elm_widget_mirrored_automatic_get(const Evas_Object *obj)
1151 API_ENTRY return EINA_FALSE;
1152 return sd->mirrored_auto_mode;
1156 * Sets the widget's mirrored mode setting.
1157 * When widget in automatic mode, it follows the system mirrored mode set by
1158 * elm_mirrored_set().
1159 * @param obj The widget.
1160 * @param automatic EINA_TRUE for auto mirrored mode. EINA_FALSE for manual.
1163 elm_widget_mirrored_automatic_set(Evas_Object *obj,
1164 Eina_Bool automatic)
1167 if (sd->mirrored_auto_mode != automatic)
1169 sd->mirrored_auto_mode = automatic;
1173 elm_widget_mirrored_set(obj, elm_config_mirrored_get());
1179 elm_widget_on_show_region_hook_set(Evas_Object *obj,
1180 void (*func)(void *data,
1186 sd->on_show_region = func;
1187 sd->on_show_region_data = data;
1191 elm_widget_sub_object_add(Evas_Object *obj,
1194 API_ENTRY return EINA_FALSE;
1195 EINA_SAFETY_ON_TRUE_RETURN_VAL(obj == sobj, EINA_FALSE);
1197 if (!sd->api) return EINA_FALSE;
1198 return sd->api->sub_object_add(obj, sobj);
1202 elm_widget_sub_object_del(Evas_Object *obj,
1205 API_ENTRY return EINA_FALSE;
1206 EINA_SAFETY_ON_TRUE_RETURN_VAL(obj == sobj, EINA_FALSE);
1208 if (!sobj) return EINA_FALSE;
1210 if (!sd->api) return EINA_FALSE;
1211 return sd->api->sub_object_del(obj, sobj);
1214 //SHKWAK : Temp Function for Indicator Issue
1215 // THIS MUST BE REMOVED
1217 EAPI const Eina_List *
1218 elm_widget_sub_object_list_get(const Evas_Object *obj)
1220 API_ENTRY return NULL;
1221 return (const Eina_List *)sd->subobjs;
1227 /* a resize object is a sub object with some more callbacks on it and
1228 * a smart member of the parent
1231 elm_widget_resize_object_set(Evas_Object *obj,
1234 Evas_Object *parent;
1238 if (sd->resize_obj == sobj) return;
1240 // orphan previous resize obj
1243 evas_object_clip_unset(sd->resize_obj);
1244 evas_object_smart_member_del(sd->resize_obj);
1246 if (_elm_widget_is(sd->resize_obj))
1248 if (elm_widget_focus_get(sd->resize_obj)) _parents_unfocus(obj);
1251 elm_widget_sub_object_del(obj, sd->resize_obj);
1254 sd->resize_obj = sobj;
1257 evas_object_event_callback_del_full(obj,
1258 EVAS_CALLBACK_MOUSE_DOWN,
1259 _obj_mouse_down, sd);
1260 evas_object_event_callback_del_full(obj,
1261 EVAS_CALLBACK_MOUSE_MOVE,
1262 _obj_mouse_move, sd);
1263 evas_object_event_callback_del_full(obj,
1264 EVAS_CALLBACK_MOUSE_UP,
1269 // orphan new resize obj
1270 parent = evas_object_data_get(sobj, "elm-parent");
1271 if (parent && parent != obj)
1273 ELM_WIDGET_DATA_GET(parent, sdp);
1275 /* should be there, just being paranoid */
1278 if (sdp->resize_obj == sobj)
1279 elm_widget_resize_object_set(parent, NULL);
1281 elm_widget_sub_object_del(parent, sobj);
1285 elm_widget_sub_object_add(obj, sobj);
1287 evas_object_smart_member_add(sobj, obj);
1289 evas_object_event_callback_add(obj, EVAS_CALLBACK_MOUSE_DOWN,
1290 _obj_mouse_down, sd);
1291 evas_object_event_callback_add(obj, EVAS_CALLBACK_MOUSE_MOVE,
1292 _obj_mouse_move, sd);
1293 evas_object_event_callback_add(obj, EVAS_CALLBACK_MOUSE_UP,
1295 _smart_reconfigure(sd);
1298 /* WARNING: the programmer is responsible, in the scenario of
1299 * exchanging a hover object, of cleaning the old hover "target"
1303 elm_widget_hover_object_set(Evas_Object *obj,
1309 evas_object_event_callback_del_full(sd->hover_obj, EVAS_CALLBACK_DEL,
1310 _on_sub_obj_del, sd);
1312 sd->hover_obj = sobj;
1315 evas_object_event_callback_add(sobj, EVAS_CALLBACK_DEL,
1316 _on_sub_obj_del, sd);
1317 _smart_reconfigure(sd);
1322 elm_widget_can_focus_set(Evas_Object *obj,
1323 Eina_Bool can_focus)
1327 can_focus = !!can_focus;
1329 if (sd->can_focus == can_focus) return;
1330 sd->can_focus = can_focus;
1333 evas_object_event_callback_add(obj, EVAS_CALLBACK_KEY_DOWN,
1335 (void *)(long)EVAS_CALLBACK_KEY_DOWN);
1336 evas_object_event_callback_add(obj, EVAS_CALLBACK_KEY_UP,
1338 (void *)(long)EVAS_CALLBACK_KEY_UP);
1339 evas_object_event_callback_add(obj, EVAS_CALLBACK_MOUSE_WHEEL,
1341 (void *)(long)EVAS_CALLBACK_MOUSE_WHEEL);
1345 evas_object_event_callback_del(obj, EVAS_CALLBACK_KEY_DOWN,
1347 evas_object_event_callback_del(obj, EVAS_CALLBACK_KEY_UP,
1349 evas_object_event_callback_del(obj, EVAS_CALLBACK_MOUSE_WHEEL,
1355 elm_widget_can_focus_get(const Evas_Object *obj)
1357 API_ENTRY return EINA_FALSE;
1358 return sd->can_focus;
1362 elm_widget_child_can_focus_get(const Evas_Object *obj)
1364 API_ENTRY return EINA_FALSE;
1365 return sd->child_can_focus;
1371 * This API makes the widget object and its children to be unfocusable.
1373 * This API can be helpful for an object to be deleted.
1374 * When an object will be deleted soon, it and its children may not
1375 * want to get focus (by focus reverting or by other focus controls).
1376 * Then, just use this API before deleting.
1378 * @param obj The widget root of sub-tree
1379 * @param tree_unfocusable If true, set the object sub-tree as unfocusable
1384 elm_widget_tree_unfocusable_set(Evas_Object *obj,
1385 Eina_Bool tree_unfocusable)
1389 tree_unfocusable = !!tree_unfocusable;
1390 if (sd->tree_unfocusable == tree_unfocusable) return;
1391 sd->tree_unfocusable = tree_unfocusable;
1392 elm_widget_focus_tree_unfocusable_handle(obj);
1398 * This returns true, if the object sub-tree is unfocusable.
1400 * @param obj The widget root of sub-tree
1401 * @return EINA_TRUE if the object sub-tree is unfocusable
1406 elm_widget_tree_unfocusable_get(const Evas_Object *obj)
1408 API_ENTRY return EINA_FALSE;
1409 return sd->tree_unfocusable;
1415 * Get the list of focusable child objects.
1417 * This function retruns list of child objects which can get focus.
1419 * @param obj The parent widget
1420 * @retrun list of focusable child objects.
1425 elm_widget_can_focus_child_list_get(const Evas_Object *obj)
1427 API_ENTRY return NULL;
1430 Eina_List *child_list = NULL;
1435 EINA_LIST_FOREACH(sd->subobjs, l, child)
1437 if ((elm_widget_can_focus_get(child)) &&
1438 (evas_object_visible_get(child)) &&
1439 (!elm_widget_disabled_get(child)))
1440 child_list = eina_list_append(child_list, child);
1441 else if (elm_widget_is(child))
1443 Eina_List *can_focus_list;
1444 can_focus_list = elm_widget_can_focus_child_list_get(child);
1446 child_list = eina_list_merge(child_list, can_focus_list);
1454 elm_widget_highlight_ignore_set(Evas_Object *obj,
1458 sd->highlight_ignore = !!ignore;
1462 elm_widget_highlight_ignore_get(const Evas_Object *obj)
1464 API_ENTRY return EINA_FALSE;
1465 return sd->highlight_ignore;
1469 elm_widget_highlight_in_theme_set(Evas_Object *obj,
1470 Eina_Bool highlight)
1473 sd->highlight_in_theme = !!highlight;
1474 /* FIXME: if focused, it should switch from one mode to the other */
1478 elm_widget_highlight_in_theme_get(const Evas_Object *obj)
1480 API_ENTRY return EINA_FALSE;
1481 return sd->highlight_in_theme;
1485 elm_widget_focus_get(const Evas_Object *obj)
1487 API_ENTRY return EINA_FALSE;
1492 elm_widget_focused_object_get(const Evas_Object *obj)
1494 const Evas_Object *subobj;
1496 API_ENTRY return NULL;
1498 if (!sd->focused) return NULL;
1499 EINA_LIST_FOREACH(sd->subobjs, l, subobj)
1501 Evas_Object *fobj = elm_widget_focused_object_get(subobj);
1502 if (fobj) return fobj;
1504 return (Evas_Object *)obj;
1508 elm_widget_top_get(const Evas_Object *obj)
1510 API_ENTRY return NULL;
1511 if (sd->parent_obj) return elm_widget_top_get(sd->parent_obj);
1512 return (Evas_Object *)obj;
1516 elm_widget_is(const Evas_Object *obj)
1518 return _elm_widget_is(obj);
1522 elm_widget_parent_widget_get(const Evas_Object *obj)
1524 Evas_Object *parent;
1526 if (_elm_widget_is(obj))
1528 Elm_Widget_Smart_Data *sd = evas_object_smart_data_get(obj);
1529 if (!sd) return NULL;
1530 parent = sd->parent_obj;
1534 parent = evas_object_data_get(obj, "elm-parent");
1535 if (!parent) parent = evas_object_smart_parent_get(obj);
1540 Evas_Object *elm_parent;
1541 if (_elm_widget_is(parent)) break;
1542 elm_parent = evas_object_data_get(parent, "elm-parent");
1543 if (elm_parent) parent = elm_parent;
1544 else parent = evas_object_smart_parent_get(parent);
1550 elm_widget_parent2_get(const Evas_Object *obj)
1552 if (_elm_widget_is(obj))
1554 Elm_Widget_Smart_Data *sd = evas_object_smart_data_get(obj);
1555 if (sd) return sd->parent2;
1561 elm_widget_parent2_set(Evas_Object *obj, Evas_Object *parent)
1564 sd->parent2 = parent;
1568 elm_widget_event_callback_add(Evas_Object *obj,
1573 EINA_SAFETY_ON_NULL_RETURN(func);
1574 Elm_Event_Cb_Data *ecb = ELM_NEW(Elm_Event_Cb_Data);
1577 sd->event_cb = eina_list_append(sd->event_cb, ecb);
1581 elm_widget_event_callback_del(Evas_Object *obj,
1585 API_ENTRY return NULL;
1586 EINA_SAFETY_ON_NULL_RETURN_VAL(func, NULL);
1588 Elm_Event_Cb_Data *ecd;
1589 EINA_LIST_FOREACH(sd->event_cb, l, ecd)
1590 if ((ecd->func == func) && (ecd->data == data))
1593 sd->event_cb = eina_list_remove_list(sd->event_cb, l);
1594 return (void *)data;
1600 elm_widget_event_propagate(Evas_Object *obj,
1601 Evas_Callback_Type type,
1603 Evas_Event_Flags *event_flags)
1605 API_ENTRY return EINA_FALSE; //TODO reduce.
1607 if (!_elm_widget_is(obj)) return EINA_FALSE;
1608 Evas_Object *parent = obj;
1609 Elm_Event_Cb_Data *ecd;
1610 Eina_List *l, *l_prev;
1613 (!(event_flags && ((*event_flags) & EVAS_EVENT_FLAG_ON_HOLD))))
1615 sd = evas_object_smart_data_get(parent);
1616 if ((!sd) || (!_elm_widget_is(obj)))
1617 return EINA_FALSE; //Not Elm Widget
1618 if (!sd->api) return EINA_FALSE;
1620 if (sd->api->event(parent, obj, type, event_info))
1623 EINA_LIST_FOREACH_SAFE(sd->event_cb, l, l_prev, ecd)
1625 if (ecd->func((void *)ecd->data, parent, obj, type, event_info) ||
1626 (event_flags && ((*event_flags) & EVAS_EVENT_FLAG_ON_HOLD)))
1629 parent = sd->parent_obj;
1638 * Set custom focus chain.
1640 * This function i set one new and overwrite any previous custom focus chain
1641 * with the list of objects. The previous list will be deleted and this list
1642 * will be managed. After setted, don't modity it.
1644 * @note On focus cycle, only will be evaluated children of this container.
1646 * @param obj The container widget
1647 * @param objs Chain of objects to pass focus
1651 elm_widget_focus_custom_chain_set(Evas_Object *obj,
1656 if (!_elm_widget_focus_chain_manager_is(obj)) return;
1658 elm_widget_focus_custom_chain_unset(obj);
1663 EINA_LIST_FOREACH(objs, l, o)
1665 evas_object_event_callback_add(o, EVAS_CALLBACK_DEL,
1666 _elm_object_focus_chain_del_cb, sd);
1669 sd->focus_chain = objs;
1675 * Get custom focus chain
1677 * @param obj The container widget
1680 EAPI const Eina_List *
1681 elm_widget_focus_custom_chain_get(const Evas_Object *obj)
1683 API_ENTRY return NULL;
1684 return (const Eina_List *)sd->focus_chain;
1690 * Unset custom focus chain
1692 * @param obj The container widget
1696 elm_widget_focus_custom_chain_unset(Evas_Object *obj)
1699 Eina_List *l, *l_next;
1702 EINA_LIST_FOREACH_SAFE(sd->focus_chain, l, l_next, o)
1704 evas_object_event_callback_del_full(o, EVAS_CALLBACK_DEL,
1705 _elm_object_focus_chain_del_cb, sd);
1706 sd->focus_chain = eina_list_remove_list(sd->focus_chain, l);
1713 * Append object to custom focus chain.
1715 * @note If relative_child equal to NULL or not in custom chain, the object
1716 * will be added in end.
1718 * @note On focus cycle, only will be evaluated children of this container.
1720 * @param obj The container widget
1721 * @param child The child to be added in custom chain
1722 * @param relative_child The relative object to position the child
1726 elm_widget_focus_custom_chain_append(Evas_Object *obj,
1728 Evas_Object *relative_child)
1731 EINA_SAFETY_ON_NULL_RETURN(child);
1733 if (!_elm_widget_focus_chain_manager_is(obj)) return;
1735 evas_object_event_callback_del_full(child, EVAS_CALLBACK_DEL,
1736 _elm_object_focus_chain_del_cb, sd);
1738 if (!relative_child)
1739 sd->focus_chain = eina_list_append(sd->focus_chain, child);
1741 sd->focus_chain = eina_list_append_relative(sd->focus_chain,
1742 child, relative_child);
1748 * Prepend object to custom focus chain.
1750 * @note If relative_child equal to NULL or not in custom chain, the object
1751 * will be added in begin.
1753 * @note On focus cycle, only will be evaluated children of this container.
1755 * @param obj The container widget
1756 * @param child The child to be added in custom chain
1757 * @param relative_child The relative object to position the child
1761 elm_widget_focus_custom_chain_prepend(Evas_Object *obj,
1763 Evas_Object *relative_child)
1766 EINA_SAFETY_ON_NULL_RETURN(child);
1768 if (!_elm_widget_focus_chain_manager_is(obj)) return;
1770 evas_object_event_callback_del_full(child, EVAS_CALLBACK_DEL,
1771 _elm_object_focus_chain_del_cb, sd);
1773 if (!relative_child)
1774 sd->focus_chain = eina_list_prepend(sd->focus_chain, child);
1776 sd->focus_chain = eina_list_prepend_relative(sd->focus_chain,
1777 child, relative_child);
1783 * Give focus to next object in object tree.
1785 * Give focus to next object in focus chain of one object sub-tree.
1786 * If the last object of chain already have focus, the focus will go to the
1787 * first object of chain.
1789 * @param obj The widget root of sub-tree
1790 * @param dir Direction to cycle the focus
1795 elm_widget_focus_cycle(Evas_Object *obj,
1796 Elm_Focus_Direction dir)
1798 Evas_Object *target = NULL;
1799 if (!_elm_widget_is(obj))
1801 elm_widget_focus_next_get(obj, dir, &target);
1805 if (_elm_config->access_mode && _elm_access_read_mode_get())
1807 _elm_access_highlight_set(target);
1808 _elm_widget_focus_region_show(target);
1810 else elm_widget_focus_steal(target);
1817 * Give focus to near object(in object tree) in one direction.
1819 * Give focus to near object(in object tree) in direction of current
1820 * focused object. If none focusable object in given direction or
1821 * none focused object in object tree, the focus will not change.
1823 * @param obj The reference widget
1824 * @param degree Degree changes clockwise. i.e. 0-degree: Up,
1825 * 90-degree: Right, 180-degree: Down, and 270-degree: Left
1826 * @return EINA_TRUE if focus is moved.
1831 elm_widget_focus_direction_go(Evas_Object *obj,
1834 Evas_Object *target = NULL;
1835 Evas_Object *current_focused = NULL;
1836 double weight = 0.0;
1838 if (!_elm_widget_is(obj)) return EINA_FALSE;
1839 if (!elm_widget_focus_get(obj)) return EINA_FALSE;
1841 current_focused = elm_widget_focused_object_get(obj);
1843 if (elm_widget_focus_direction_get
1844 (obj, current_focused, degree, &target, &weight))
1846 elm_widget_focus_steal(target);
1853 _direction_weight_get(const Evas_Object *obj1,
1854 const Evas_Object *obj2,
1857 Evas_Coord obj_x1, obj_y1, w1, h1, obj_x2, obj_y2, w2, h2;
1858 double x1, yy1, x2, yy2, xx1, yyy1, xx2, yyy2;
1859 double ax, ay, cx, cy;
1860 double weight = -1.0, g = 0.0;
1862 if (obj1 == obj2) return 0.0;
1865 while (degree >= 360.0)
1867 while (degree < 0.0)
1870 evas_object_geometry_get(obj1, &obj_x1, &obj_y1, &w1, &h1);
1871 cx = obj_x1 + (w1 / 2.0);
1872 cy = obj_y1 + (h1 / 2.0);
1873 evas_object_geometry_get(obj2, &obj_x2, &obj_y2, &w2, &h2);
1875 /* For overlapping cases. */
1876 if (ELM_RECTS_INTERSECT(obj_x1, obj_y1, w1, h1, obj_x2, obj_y2, w2, h2))
1879 /* Change all points to relative one. */
1889 /* Get crossing points (ax, ay) between obj1 and a line extending
1890 * to the direction of current degree. */
1896 else if (degree == 90.0)
1901 else if (degree == 180.0)
1906 else if (degree == 270.0)
1913 g = tan(degree * (M_PI / 180.0));
1914 if ((degree > 0.0) && (degree < 90.0))
1917 if (ay <= yyy1) ax = xx1;
1924 else if ((degree > 90.0) && (degree < 180.0))
1927 if (ay <= yyy1) ax = x1;
1934 else if ((degree > 180.0) && (degree < 270.0))
1937 if (ay >= yy1) ax = x1;
1947 if (ay >= yy1) ax = xx1;
1956 /* Filter obj2, if it is not in the specific derection. */
1958 double rx[4] = {0.0, 0.0, 0.0, 0.0}, ry[4] = {0.0, 0.0, 0.0, 0.0};
1959 double t1, t2, u1, v1, u2, v2;
1961 if ((degree == 45.0) || (degree == 225.0) || (degree == 135.0) ||
1971 double g2 = tan((degree + 45.0) * (M_PI / 180.0));
1976 t1 = (u1 * ax) + (v1 * ay);
1977 t2 = (u2 * ax) + (v2 * ay);
1979 #define _R(x) (int)((x + 0.05) * 10.0)
1981 if ((_R(t1 * ((u1 * x2) + (v1 * yy2))) > 0) && (_R(t2 * ((u2 * x2) +
1987 if ((_R(t1 * ((u1 * x2) + (v1 * yyy2))) > 0) && (_R(t2 * ((u2 * x2) +
1993 if ((_R(t1 * ((u1 * xx2) + (v1 * yy2))) > 0) && (_R(t2 * ((u2 * xx2) +
1999 if ((_R(t1 * ((u1 * xx2) + (v1 * yyy2))) > 0) &&
2000 (_R(t2 * ((u2 * xx2) + (v2 * yyy2))) > 0))
2009 if ((_R(xx2) < 0) || (_R(yy2) > 0) || (_R(yyy2) < 0)) return 0.0;
2011 else if (degree == 90.0)
2013 if ((_R(yyy2) < 0) || (_R(x2) > 0) || (_R(xx2) < 0)) return 0.0;
2015 else if (degree == 180.0)
2017 if ((_R(x2) > 0) || (_R(yy2) > 0) || (_R(yyy2) < 0)) return 0.0;
2019 else if (degree == 270.0)
2021 if ((_R(yy2) > 0) || (_R(x2) > 0) || (_R(xx2) < 0)) return 0.0;
2025 if ((_R(g * x2) >= _R(yy2)) && (_R((g * x2)) <= _R(yyy2)))
2027 if (!((_R(ax * x2) > 0) && (_R(ay * (g * x2)) > 0)))
2030 else if ((_R(g * xx2) >= _R(yy2)) && (_R((g * xx2)) <= _R(yyy2)))
2032 if (!((_R(ax * xx2) > 0) && (_R(ay * (g * xx2)) > 0)))
2035 else if ((_R((1.0 / g) * yy2) >= _R(xx2)) && (_R((1.0 / g) * yy2)
2038 if (!((_R(ax * ((1.0 / g) * yy2)) > 0)
2039 && (_R(ay * yy2) > 0)))
2042 else if ((_R((1.0 / g) * yyy2) >= _R(xx2)) &&
2043 (_R((1.0 / g) * yyy2) <= _R(xx2)))
2045 if (!((_R(ax * ((1.0 / g) * yyy2)) > 0)
2046 && (_R(ay * yyy2) > 0))) return 0.0;
2052 /* Calculate the weight for obj2. */
2055 if (_R(xx1) > _R(x2)) weight = -1.0;
2056 else if ((_R(yy2) >= _R(yy1)) && (_R(yyy2) <= _R(yyy1)))
2057 weight = (x2 - xx1) * (x2 - xx1);
2058 else if (_R(yy2) > 0)
2059 weight = ((x2 - xx1) * (x2 - xx1)) + (yy2 * yy2);
2060 else if (_R(yyy2) < 0)
2061 weight = ((x2 - xx1) * (x2 - xx1)) + (yyy2 * yyy2);
2062 else weight = (x2 - xx1) * (x2 - xx1);
2064 else if (degree == 90.0)
2066 if (_R(yyy1) > _R(yy2)) weight = -1.0;
2067 else if ((_R(x2) >= _R(x1)) && (_R(xx2) <= _R(xx1)))
2068 weight = (yy2 - yyy1) * (yy2 - yyy1);
2069 else if (_R(x2) > 0)
2070 weight = (x2 * x2) + ((yy2 - yyy1) * (yy2 - yyy1));
2071 else if (_R(xx2) < 0)
2072 weight = (xx2 * xx2) + ((yy2 - yyy1) * (yy2 - yyy1));
2073 else weight = (yy2 - yyy1) * (yy2 - yyy1);
2075 else if (degree == 180.0)
2077 if (_R(x1) < _R(xx2)) weight = -1.0;
2078 else if ((_R(yy2) >= _R(yy1)) && (_R(yyy2) <= _R(yyy1)))
2079 weight = (x1 - xx2) * (x1 - xx2);
2080 else if (_R(yy2) > 0)
2081 weight = ((x1 - xx2) * (x1 - xx2)) + (yy2 * yy2);
2082 else if (_R(yyy2) < 0)
2083 weight = ((x1 - xx2) * (x1 - xx2)) + (yyy2 * yyy2);
2084 else weight = (x1 - xx2) * (x1 - xx2);
2086 else if (degree == 270.0)
2088 if (_R(yy1) < _R(yyy2)) weight = -1.0;
2089 else if ((_R(x2) >= _R(x1)) && (_R(xx2) <= _R(xx1)))
2090 weight = (yy1 - yyy2) * (yy1 - yyy2);
2091 else if (_R(x2) > 0)
2092 weight = (x2 * x2) + ((yy1 - yyy2) * (yy1 - yyy2));
2093 else if (_R(xx2) < 0)
2094 weight = (xx2 * xx2) + ((yy1 - yyy2) * (yy1 - yyy2));
2095 else weight = (yy1 - yyy2) * (yy1 - yyy2);
2100 double sx[4] = {0.0, 0.0, 0.0, 0.0}, sy[4] = {0.0, 0.0, 0.0, 0.0};
2101 double t_weight[4] = {-1.0, -1.0, -1.0, -1.0};
2102 if ((_R(g * x2) >= _R(yy2)) && (_R(g * x2) <= _R(yyy2)))
2106 t_weight[j++] = ((ax - x2) * (ax - x2)) +
2107 ((ay - (g * x2)) * (ay - (g * x2)));
2109 if ((_R(g * xx2) >= _R(yy2)) && (_R(g * xx2) <= _R(yyy2)))
2113 t_weight[j++] = ((ax - xx2) * (ax - xx2)) +
2114 ((ay - (g * xx2)) * (ay - (g * xx2)));
2116 if ((_R((1.0 / g) * yy2) >= _R(x2)) && (_R((1.0 / g) * yy2) <= _R(xx2)))
2118 sx[j] = (1.0 / g) * yy2;
2121 ((ax - ((1.0 / g) * yy2)) * (ax - ((1.0 / g) * yy2))) +
2122 ((ay - yy2) * (ay - yy2));
2124 if ((_R((1.0 / g) * yyy2) >= _R(x2)) && (_R((1.0 / g) * yyy2)
2127 sx[j] = (1.0 / g) * yyy2;
2130 ((ax - ((1.0 / g) * yyy2)) * (ax - ((1.0 / g) * yyy2))) +
2131 ((ay - yyy2) * (ay - yyy2));
2134 if ((j > 2) || ((j == 2) && ((_R(sx[0]) != _R(sx[1])) ||
2135 (_R(sy[0]) != _R(sy[1])))))
2139 if (_R(t_weight[k]) == 0) return -1.0;
2140 if ((1 / weight) < (1 / t_weight[k])) weight = t_weight[k];
2147 double ccx, ccy, t1_weight, x_diff, y_diff;
2148 ccx = ((1.0 / g) * rx[k] + ry[k]) / (g + (1.0 / g));
2150 x_diff = rx[k] - ccx;
2151 if (x_diff < 0) x_diff *= -1.0;
2152 y_diff = ry[k] - ccy;
2153 if (y_diff < 0) y_diff *= -1.0;
2155 (((ax - ccx) * (ax - ccx)) + ((ay - ccy) * (ay - ccy))) +
2156 ((x_diff * x_diff * x_diff) + (y_diff * y_diff * y_diff));
2157 if ((_R(t1_weight) != 0) && ((1 / weight) < (1 / t1_weight)))
2162 /* Return the current object's weight. */
2163 if (weight == -1.0) return 0.0;
2164 if (_R(weight) == 0) return -1.0;
2168 return 1.0 / weight;
2174 * Get near object in one direction of base object.
2176 * Get near object(in the object sub-tree) in one direction of
2177 * base object. Return the near object by reference.
2178 * By initializing weight, you can filter objects locating far
2179 * from base object. If object is in the specific direction,
2180 * weight is (1/(distance^2)). If object is not exactly in one
2181 * direction, some penalty will be added.
2183 * @param obj The widget root of sub-tree
2184 * @param base The base object of the direction
2185 * @param degree Degree changes clockwise. i.e. 0-degree: Up,
2186 * 90-degree: Right, 180-degree: Down, and 270-degree: Left
2187 * @param direction The near object in one direction
2188 * @param weight The weight is bigger when the object is located near
2189 * @return EINA_TRUE if near object is updated.
2194 elm_widget_focus_direction_get(const Evas_Object *obj,
2195 const Evas_Object *base,
2197 Evas_Object **direction,
2202 API_ENTRY return EINA_FALSE;
2204 /* -1 means the best was already decided. Don't need any more searching. */
2205 if (!direction || !weight || !base || (obj == base))
2208 /* Ignore if disabled */
2209 if ((!evas_object_visible_get(obj))
2210 || (elm_widget_disabled_get(obj))
2211 || (elm_widget_tree_unfocusable_get(obj)))
2214 if (!sd->api) return EINA_FALSE;
2217 if (_elm_widget_focus_direction_manager_is(obj))
2218 return sd->api->focus_direction(obj, base, degree, direction, weight);
2220 if (!elm_widget_can_focus_get(obj) || elm_widget_focus_get(obj))
2223 c_weight = _direction_weight_get(base, obj, degree);
2224 if ((c_weight == -1.0) ||
2225 ((c_weight != 0.0) && (*weight != -1.0) &&
2226 ((int)(*weight * 1000000) <= (int)(c_weight * 1000000))))
2228 if ((int)(*weight * 1000000) == (int)(c_weight * 1000000))
2230 Elm_Widget_Smart_Data *sd1 =
2231 evas_object_smart_data_get(*direction);
2234 if (sd->focus_order <= sd1->focus_order)
2238 *direction = (Evas_Object *)obj;
2248 * Get near object in one direction of base object in list.
2250 * Get near object in one direction of base object in the specific
2251 * object list. Return the near object by reference.
2252 * By initializing weight, you can filter objects locating far
2253 * from base object. If object is in the specific direction,
2254 * weight is (1/(distance^2)). If object is not exactly in one
2255 * direction, some penalty will be added.
2257 * @param obj The widget root of sub-tree
2258 * @param base The base object of the direction
2259 * @param items list with ordered objects
2260 * @param list_data_get function to get the object from one item of list
2261 * @param degree Degree changes clockwise. i.e. 0-degree: Up,
2262 * 90-degree: Right, 180-degree: Down, and 270-degree: Left
2263 * @param direction The near object in one direction
2264 * @param weight The weight is bigger when the object is located near
2265 * @return EINA_TRUE if near object is updated.
2270 elm_widget_focus_list_direction_get(const Evas_Object *obj,
2271 const Evas_Object *base,
2272 const Eina_List *items,
2273 void *(*list_data_get)(const Eina_List *l),
2275 Evas_Object **direction,
2278 API_ENTRY return EINA_FALSE;
2279 if (!direction || !weight || !base || !items)
2282 const Eina_List *l = items;
2283 Evas_Object *current_best = *direction;
2285 for (; l; l = eina_list_next(l))
2287 Evas_Object *cur = list_data_get(l);
2288 elm_widget_focus_direction_get(cur, base, degree, direction, weight);
2290 if (current_best != *direction)
2299 * Get next object in focus chain of object tree.
2301 * Get next object in focus chain of one object sub-tree.
2302 * Return the next object by reference. If don't have any candidate to receive
2303 * focus before chain end, the first candidate will be returned.
2305 * @param obj The widget root of sub-tree
2306 * @param dir Direction os focus chain
2307 * @param next The next object in focus chain
2308 * @return EINA_TRUE if don't need focus chain restart/loop back
2309 * to use 'next' obj.
2314 elm_widget_focus_next_get(const Evas_Object *obj,
2315 Elm_Focus_Direction dir,
2322 API_ENTRY return EINA_FALSE;
2324 /* Ignore if disabled */
2325 if ((!evas_object_visible_get(obj))
2326 || (elm_widget_disabled_get(obj))
2327 || (elm_widget_tree_unfocusable_get(obj)))
2330 if (!sd->api) return EINA_FALSE;
2333 if (_elm_widget_focus_chain_manager_is(obj))
2336 ret = sd->api->focus_next(obj, dir, next);
2337 if (!ret && elm_widget_focus_get(obj))
2339 Evas_Object *o = NULL;
2340 if (dir == ELM_FOCUS_PREVIOUS)
2341 o = sd->focus_previous;
2342 else if (dir == ELM_FOCUS_NEXT)
2344 else if (dir == ELM_FOCUS_UP)
2346 else if (dir == ELM_FOCUS_DOWN)
2348 else if (dir == ELM_FOCUS_RIGHT)
2349 o = sd->focus_right;
2350 else if (dir == ELM_FOCUS_LEFT)
2363 if (!elm_widget_can_focus_get(obj))
2366 /* focusable object but does not have access info */
2367 if (_elm_config->access_mode)
2369 if (!_elm_access_object_get(obj)) return EINA_FALSE;
2372 if (elm_widget_focus_get(obj))
2374 if (dir == ELM_FOCUS_PREVIOUS)
2375 *next = sd->focus_previous;
2376 else if (dir == ELM_FOCUS_NEXT)
2377 *next = sd->focus_next;
2378 else if (dir == ELM_FOCUS_UP)
2379 *next = sd->focus_up;
2380 else if (dir == ELM_FOCUS_DOWN)
2381 *next = sd->focus_down;
2382 else if (dir == ELM_FOCUS_RIGHT)
2383 *next = sd->focus_right;
2384 else if (dir == ELM_FOCUS_LEFT)
2385 *next = sd->focus_left;
2391 *next = (Evas_Object *)obj;
2392 return !ELM_WIDGET_FOCUS_GET(obj);
2398 * Get next object in focus chain of object tree in list.
2400 * Get next object in focus chain of one object sub-tree ordered by one list.
2401 * Return the next object by reference. If don't have any candidate to receive
2402 * focus before list end, the first candidate will be returned.
2404 * @param obj The widget root of sub-tree
2405 * @param dir Direction os focus chain
2406 * @param items list with ordered objects
2407 * @param list_data_get function to get the object from one item of list
2408 * @param next The next object in focus chain
2409 * @return EINA_TRUE if don't need focus chain restart/loop back
2410 * to use 'next' obj.
2415 elm_widget_focus_list_next_get(const Evas_Object *obj,
2416 const Eina_List *items,
2417 void *(*list_data_get)(const Eina_List *list),
2418 Elm_Focus_Direction dir,
2421 Eina_List *(*list_next)(const Eina_List *list) = NULL;
2422 Evas_Object *focused_object = NULL;
2428 if (!_elm_widget_is(obj))
2434 /* When Up, Down, Right, or Left, try direction_get first. */
2435 focused_object = elm_widget_focused_object_get(obj);
2438 if((dir == ELM_FOCUS_UP)
2439 || (dir == ELM_FOCUS_DOWN)
2440 || (dir == ELM_FOCUS_RIGHT)
2441 || (dir == ELM_FOCUS_LEFT))
2443 *next = elm_widget_focus_next_object_get(focused_object, dir);
2452 if (dir == ELM_FOCUS_UP) degree = 0.0;
2453 else if (dir == ELM_FOCUS_DOWN) degree = 180.0;
2454 else if (dir == ELM_FOCUS_RIGHT) degree = 90.0;
2455 else if (dir == ELM_FOCUS_LEFT) degree = 270.0;
2457 if (elm_widget_focus_list_direction_get(obj, focused_object,
2458 items, list_data_get,
2459 degree, &n, &weight))
2469 if (dir == ELM_FOCUS_PREVIOUS)
2471 items = eina_list_last(items);
2472 list_next = eina_list_prev;
2474 else if ((dir == ELM_FOCUS_NEXT)
2475 || (dir == ELM_FOCUS_UP)
2476 || (dir == ELM_FOCUS_DOWN)
2477 || (dir == ELM_FOCUS_RIGHT)
2478 || (dir == ELM_FOCUS_LEFT))
2479 list_next = eina_list_next;
2483 const Eina_List *l = items;
2485 /* Recovery last focused sub item */
2486 if (ELM_WIDGET_FOCUS_GET(obj))
2488 for (; l; l = list_next(l))
2490 Evas_Object *cur = list_data_get(l);
2491 if (ELM_WIDGET_FOCUS_GET(cur)) break;
2494 /* Focused object, but no focused sub item */
2498 const Eina_List *start = l;
2499 Evas_Object *to_focus = NULL;
2501 /* Interate sub items */
2502 /* Go to end of list */
2503 for (; l; l = list_next(l))
2505 Evas_Object *tmp = NULL;
2506 Evas_Object *cur = list_data_get(l);
2508 if (elm_widget_parent_get(cur) != obj)
2511 /* Try Focus cycle in subitem */
2512 if (elm_widget_focus_next_get(cur, dir, &tmp))
2517 else if ((dir == ELM_FOCUS_UP)
2518 || (dir == ELM_FOCUS_DOWN)
2519 || (dir == ELM_FOCUS_RIGHT)
2520 || (dir == ELM_FOCUS_LEFT))
2522 if (tmp && elm_widget_focus_get(cur))
2528 else if ((tmp) && (!to_focus))
2534 /* Get First possible */
2535 for (; l != start; l = list_next(l))
2537 Evas_Object *tmp = NULL;
2538 Evas_Object *cur = list_data_get(l);
2540 if (elm_widget_parent_get(cur) != obj)
2543 /* Try Focus cycle in subitem */
2544 elm_widget_focus_next_get(cur, dir, &tmp);
2560 * Get next object which was set with specific focus direction.
2562 * Get next object which was set by elm_widget_focus_next_object_set
2563 * with specific focus directioin.
2565 * @param obj The widget
2566 * @param dir Direction of focus
2567 * @return Widget which was registered with sepecific focus direction.
2572 elm_widget_focus_next_object_get(const Evas_Object *obj, Elm_Focus_Direction dir)
2574 API_ENTRY return NULL;
2576 if (dir == ELM_FOCUS_PREVIOUS)
2577 return sd->focus_previous;
2578 else if (dir == ELM_FOCUS_NEXT)
2579 return sd->focus_next;
2580 else if (dir == ELM_FOCUS_UP)
2581 return sd->focus_up;
2582 else if (dir == ELM_FOCUS_DOWN)
2583 return sd->focus_down;
2584 else if (dir == ELM_FOCUS_RIGHT)
2585 return sd->focus_right;
2586 else if (dir == ELM_FOCUS_LEFT)
2587 return sd->focus_left;
2595 * Set next object with specific focus direction.
2597 * When a widget is set with specific focus direction, this widget will be
2598 * the first candidate when finding the next focus object.
2599 * Focus next object can be registered with six directions that are previous,
2600 * next, up, down, right, and left.
2602 * @param obj The widget
2603 * @param next Next focus object
2604 * @param dir Direction of focus
2609 elm_widget_focus_next_object_set(Evas_Object *obj, Evas_Object *next, Elm_Focus_Direction dir)
2613 if (dir == ELM_FOCUS_PREVIOUS)
2614 sd->focus_previous = next;
2615 else if (dir == ELM_FOCUS_NEXT)
2616 sd->focus_next = next;
2617 else if (dir == ELM_FOCUS_UP)
2618 sd->focus_up = next;
2619 else if (dir == ELM_FOCUS_DOWN)
2620 sd->focus_down = next;
2621 else if (dir == ELM_FOCUS_RIGHT)
2622 sd->focus_right = next;
2623 else if (dir == ELM_FOCUS_LEFT)
2624 sd->focus_left = next;
2629 elm_widget_highlight_get(const Evas_Object *obj)
2631 API_ENTRY return EINA_FALSE;
2632 return sd->highlighted;
2636 elm_widget_parent_highlight_set(Evas_Object *obj,
2637 Eina_Bool highlighted)
2641 highlighted = !!highlighted;
2643 Evas_Object *o = elm_widget_parent_get(obj);
2645 if (o) elm_widget_parent_highlight_set(o, highlighted);
2647 sd->highlighted = highlighted;
2651 elm_widget_signal_emit(Evas_Object *obj,
2652 const char *emission,
2657 if (evas_object_smart_type_check(obj, "elm_layout"))
2658 elm_layout_signal_emit(obj, emission, source);
2659 else if (evas_object_smart_type_check(obj, "elm_icon"))
2661 WRN("Deprecated function. This functionality on icon objects"
2662 " will be dropped on a next release.");
2663 _elm_icon_signal_emit(obj, emission, source);
2668 elm_widget_signal_callback_add(Evas_Object *obj,
2669 const char *emission,
2671 Edje_Signal_Cb func,
2676 EINA_SAFETY_ON_NULL_RETURN(func);
2678 if (evas_object_smart_type_check(obj, "elm_layout"))
2679 elm_layout_signal_callback_add(obj, emission, source, func, data);
2680 else if (evas_object_smart_type_check(obj, "elm_icon"))
2682 WRN("Deprecated function. This functionality on icon objects"
2683 " will be dropped on a next release.");
2685 _elm_icon_signal_callback_add(obj, emission, source, func, data);
2690 elm_widget_signal_callback_del(Evas_Object *obj,
2691 const char *emission,
2693 Edje_Signal_Cb func)
2697 API_ENTRY return NULL;
2699 if (evas_object_smart_type_check(obj, "elm_layout"))
2700 data = elm_layout_signal_callback_del(obj, emission, source, func);
2701 else if (evas_object_smart_type_check(obj, "elm_icon"))
2703 WRN("Deprecated function. This functionality on icon objects"
2704 " will be dropped on a next release.");
2706 data = _elm_icon_signal_callback_del(obj, emission, source, func);
2713 elm_widget_focus_set(Evas_Object *obj,
2718 if (!sd->api) return;
2723 sd->focus_order = focus_order;
2724 sd->focused = EINA_TRUE;
2725 sd->api->on_focus(obj);
2730 if ((_is_focusable(sd->resize_obj)) &&
2731 (!elm_widget_disabled_get(sd->resize_obj)))
2733 elm_widget_focus_set(sd->resize_obj, first);
2740 EINA_LIST_FOREACH(sd->subobjs, l, child)
2742 if ((_is_focusable(child)) &&
2743 (!elm_widget_disabled_get(child)))
2745 elm_widget_focus_set(child, first);
2756 EINA_LIST_REVERSE_FOREACH(sd->subobjs, l, child)
2758 if ((_is_focusable(child)) &&
2759 (!elm_widget_disabled_get(child)))
2761 elm_widget_focus_set(child, first);
2767 if ((_is_focusable(sd->resize_obj)) &&
2768 (!elm_widget_disabled_get(sd->resize_obj)))
2770 elm_widget_focus_set(sd->resize_obj, first);
2777 elm_widget_parent_get(const Evas_Object *obj)
2779 API_ENTRY return NULL;
2780 return sd->parent_obj;
2784 elm_widget_focused_object_clear(Evas_Object *obj)
2788 if (!sd->api) return;
2790 if (!sd->focused) return;
2792 // FIXME: evas_object_ref/unref is temporary code to fix logical issue.
2793 // After Eo is applied to elementary, remove these.
2794 evas_object_ref(obj);
2795 if (sd->resize_obj && elm_widget_focus_get(sd->resize_obj))
2796 elm_widget_focused_object_clear(sd->resize_obj);
2801 EINA_LIST_FOREACH(sd->subobjs, l, child)
2803 if (elm_widget_focus_get(child))
2805 elm_widget_focused_object_clear(child);
2810 sd->focused = EINA_FALSE;
2811 sd->api->on_focus(obj);
2812 evas_object_unref(obj);
2816 elm_widget_focus_steal(Evas_Object *obj)
2818 Evas_Object *parent, *parent2, *o;
2821 if (sd->focused) return;
2822 if (sd->disabled) return;
2823 if (!sd->can_focus) return;
2824 if (sd->tree_unfocusable) return;
2828 o = elm_widget_parent_get(parent);
2830 sd = evas_object_smart_data_get(o);
2831 if (sd->disabled || sd->tree_unfocusable) return;
2832 if (sd->focused) break;
2835 if ((!elm_widget_parent_get(parent)) &&
2836 (!elm_widget_parent2_get(parent)))
2837 elm_widget_focused_object_clear(parent);
2840 parent2 = elm_widget_parent_get(parent);
2841 if (!parent2) parent2 = elm_widget_parent2_get(parent);
2843 sd = evas_object_smart_data_get(parent);
2846 if ((sd->resize_obj) && (elm_widget_focus_get(sd->resize_obj)))
2847 elm_widget_focused_object_clear(sd->resize_obj);
2852 EINA_LIST_FOREACH(sd->subobjs, l, child)
2854 if (elm_widget_focus_get(child))
2856 elm_widget_focused_object_clear(child);
2864 _elm_widget_focus_region_show(obj);
2869 elm_widget_focus_restore(Evas_Object *obj)
2871 Evas_Object *newest = NULL;
2872 unsigned int newest_focus_order = 0;
2875 newest = elm_widget_newest_focus_order_get(obj, &newest_focus_order, EINA_TRUE);
2878 elm_object_focus_set(newest, EINA_FALSE);
2879 elm_object_focus_set(newest, EINA_TRUE);
2884 _elm_widget_top_win_focused_set(Evas_Object *obj,
2885 Eina_Bool top_win_focused)
2891 if (sd->top_win_focused == top_win_focused) return;
2893 _elm_widget_top_win_focused_set(sd->resize_obj, top_win_focused);
2894 EINA_LIST_FOREACH(sd->subobjs, l, child)
2896 _elm_widget_top_win_focused_set(child, top_win_focused);
2898 sd->top_win_focused = top_win_focused;
2902 _elm_widget_top_win_focused_get(const Evas_Object *obj)
2904 API_ENTRY return EINA_FALSE;
2905 return sd->top_win_focused;
2909 elm_widget_disabled_set(Evas_Object *obj,
2914 if (sd->disabled == disabled) return;
2915 sd->disabled = !!disabled;
2916 elm_widget_focus_disabled_handle(obj);
2917 if (!sd->api) return;
2918 sd->api->disable(obj);
2922 elm_widget_disabled_get(const Evas_Object *obj)
2925 return sd->disabled;
2929 elm_widget_show_region_set(Evas_Object *obj,
2934 Eina_Bool forceshow)
2936 Evas_Object *parent_obj, *child_obj;
2937 Evas_Coord px, py, cx, cy;
2941 evas_smart_objects_calculate(evas_object_evas_get(obj));
2942 ELM_WIDGET_CHECK_OR_RETURN(obj);
2944 if (!forceshow && (x == sd->rx) && (y == sd->ry) &&
2945 (w == sd->rw) && (h == sd->rh)) return;
2951 if (sd->on_show_region)
2953 (sd->on_show_region_data, obj);
2957 parent_obj = sd->parent_obj;
2958 child_obj = sd->obj;
2959 if ((!parent_obj) || (!_elm_widget_is(parent_obj))) break;
2960 sd = evas_object_smart_data_get(parent_obj);
2963 evas_object_geometry_get(parent_obj, &px, &py, NULL, NULL);
2964 evas_object_geometry_get(child_obj, &cx, &cy, NULL, NULL);
2973 if (sd->on_show_region)
2976 (sd->on_show_region_data, parent_obj);
2983 elm_widget_show_region_get(const Evas_Object *obj,
2999 * Get the focus region of the given widget.
3001 * @return show region or not
3002 * (@c EINA_TRUE = show region/@c EINA_FALSE = do not show region). Default is @c EINA_FALSE.
3004 * The focus region is the area of a widget that should brought into the
3005 * visible area when the widget is focused. Mostly used to show the part of
3006 * an entry where the cursor is, for example. The area returned is relative
3007 * to the object @p obj.
3009 * @param obj The widget object
3010 * @param x Where to store the x coordinate of the area
3011 * @param y Where to store the y coordinate of the area
3012 * @param w Where to store the width of the area
3013 * @param h Where to store the height of the area
3018 elm_widget_focus_region_get(const Evas_Object *obj,
3024 API_ENTRY return EINA_FALSE;
3025 if (!sd->api->on_focus_region(obj, x, y, w, h))
3027 evas_object_geometry_get(obj, NULL, NULL, w, h);
3035 elm_widget_scrollable_children_get(Evas_Object *obj)
3037 Eina_List *l, *ret = NULL;
3040 API_ENTRY return NULL;
3042 EINA_LIST_FOREACH(sd->subobjs, l, child)
3044 if (_elm_scrollable_is(child))
3045 ret = eina_list_append(ret, child);
3052 elm_widget_scroll_hold_push(Evas_Object *obj)
3056 if (sd->scroll_hold == 1)
3058 if (_elm_scrollable_is(obj))
3060 ELM_SCROLLABLE_IFACE_GET(obj, s_iface);
3061 s_iface->hold_set(obj, EINA_TRUE);
3065 Eina_List *scr_children, *l;
3068 scr_children = elm_widget_scrollable_children_get(obj);
3069 EINA_LIST_FOREACH(scr_children, l, child)
3071 ELM_SCROLLABLE_IFACE_GET(child, s_iface);
3072 s_iface->hold_set(child, EINA_TRUE);
3074 eina_list_free(scr_children);
3077 if (sd->parent_obj) elm_widget_scroll_hold_push(sd->parent_obj);
3078 // FIXME: on delete/reparent hold pop
3082 elm_widget_scroll_hold_pop(Evas_Object *obj)
3086 if (!sd->scroll_hold)
3088 if (_elm_scrollable_is(obj))
3090 ELM_SCROLLABLE_IFACE_GET(obj, s_iface);
3091 s_iface->hold_set(obj, EINA_FALSE);
3095 Eina_List *scr_children, *l;
3098 scr_children = elm_widget_scrollable_children_get(obj);
3099 EINA_LIST_FOREACH(scr_children, l, child)
3101 ELM_SCROLLABLE_IFACE_GET(child, s_iface);
3102 s_iface->hold_set(child, EINA_FALSE);
3104 eina_list_free(scr_children);
3107 if (sd->parent_obj) elm_widget_scroll_hold_pop(sd->parent_obj);
3108 if (sd->scroll_hold < 0) sd->scroll_hold = 0;
3112 elm_widget_scroll_hold_get(const Evas_Object *obj)
3115 return sd->scroll_hold;
3119 elm_widget_scroll_freeze_push(Evas_Object *obj)
3122 sd->scroll_freeze++;
3123 if (sd->scroll_freeze == 1)
3125 if (_elm_scrollable_is(obj))
3127 ELM_SCROLLABLE_IFACE_GET(obj, s_iface);
3128 s_iface->freeze_set(obj, EINA_TRUE);
3132 Eina_List *scr_children, *l;
3135 scr_children = elm_widget_scrollable_children_get(obj);
3136 EINA_LIST_FOREACH(scr_children, l, child)
3138 ELM_SCROLLABLE_IFACE_GET(child, s_iface);
3139 s_iface->freeze_set(child, EINA_TRUE);
3141 eina_list_free(scr_children);
3144 if (sd->parent_obj) elm_widget_scroll_freeze_push(sd->parent_obj);
3145 // FIXME: on delete/reparent freeze pop
3149 elm_widget_scroll_freeze_pop(Evas_Object *obj)
3152 sd->scroll_freeze--;
3153 if (!sd->scroll_freeze)
3155 if (_elm_scrollable_is(obj))
3157 ELM_SCROLLABLE_IFACE_GET(obj, s_iface);
3158 s_iface->freeze_set(obj, EINA_FALSE);
3162 Eina_List *scr_children, *l;
3165 scr_children = elm_widget_scrollable_children_get(obj);
3166 EINA_LIST_FOREACH(scr_children, l, child)
3168 ELM_SCROLLABLE_IFACE_GET(child, s_iface);
3169 s_iface->freeze_set(child, EINA_FALSE);
3171 eina_list_free(scr_children);
3174 if (sd->parent_obj) elm_widget_scroll_freeze_pop(sd->parent_obj);
3175 if (sd->scroll_freeze < 0) sd->scroll_freeze = 0;
3179 elm_widget_scroll_freeze_get(const Evas_Object *obj)
3182 return sd->scroll_freeze;
3186 elm_widget_scale_set(Evas_Object *obj,
3190 if (scale <= 0.0) scale = 0.0;
3191 if (sd->scale != scale)
3194 elm_widget_theme(obj);
3199 elm_widget_scale_get(const Evas_Object *obj)
3201 API_ENTRY return 1.0;
3202 // FIXME: save walking up the tree by storing/caching parent scale
3203 if (sd->scale == 0.0)
3206 return elm_widget_scale_get(sd->parent_obj);
3214 elm_widget_theme_set(Evas_Object *obj,
3218 if (sd->theme != th)
3220 if (sd->theme) elm_theme_free(sd->theme);
3223 elm_widget_theme(obj);
3228 elm_widget_text_part_set(Evas_Object *obj,
3234 if (evas_object_smart_type_check(obj, "elm_layout"))
3235 elm_layout_text_set(obj, part, label);
3239 elm_widget_text_part_get(const Evas_Object *obj,
3242 API_ENTRY return NULL;
3244 if (evas_object_smart_type_check(obj, "elm_layout"))
3245 return elm_layout_text_get(obj, part);
3251 elm_widget_domain_translatable_text_part_set(Evas_Object *obj,
3258 Elm_Translate_String_Data *ts = NULL;
3261 str = eina_stringshare_add(part);
3262 EINA_LIST_FOREACH(sd->translate_strings, l, ts)
3269 eina_stringshare_del(str);
3272 ts = malloc(sizeof(Elm_Translate_String_Data));
3276 ts->domain = eina_stringshare_add(domain);
3277 ts->string = eina_stringshare_add(label);
3278 sd->translate_strings = eina_list_append(sd->translate_strings, ts);
3284 eina_stringshare_replace(&ts->domain, domain);
3285 eina_stringshare_replace(&ts->string, label);
3289 sd->translate_strings = eina_list_remove_list(
3290 sd->translate_strings, l);
3291 eina_stringshare_del(ts->id);
3292 eina_stringshare_del(ts->domain);
3293 eina_stringshare_del(ts->string);
3296 eina_stringshare_del(str);
3300 if (label && label[0])
3301 label = dgettext(domain, label);
3303 elm_widget_text_part_set(obj, part, label);
3307 elm_widget_translatable_text_part_get(const Evas_Object *obj,
3310 const char *str, *ret = NULL;
3312 Elm_Translate_String_Data *ts;
3313 API_ENTRY return NULL;
3315 str = eina_stringshare_add(part);
3316 EINA_LIST_FOREACH(sd->translate_strings, l, ts)
3322 eina_stringshare_del(str);
3327 elm_widget_translate(Evas_Object *obj)
3332 Elm_Translate_String_Data *ts;
3337 EINA_LIST_FOREACH(sd->subobjs, l, child)
3338 elm_widget_translate(child);
3339 if (sd->resize_obj) elm_widget_translate(sd->resize_obj);
3340 if (sd->hover_obj) elm_widget_translate(sd->hover_obj);
3341 if (!sd->api) return;
3342 sd->api->translate(obj);
3345 EINA_LIST_FOREACH(sd->translate_strings, l, ts)
3347 const char *s = dgettext(ts->domain, ts->string);
3348 elm_widget_text_part_set(obj, ts->id, s);
3354 elm_widget_content_part_set(Evas_Object *obj,
3356 Evas_Object *content)
3360 if (!sd->api) return;
3361 if (evas_object_smart_type_check(obj, "elm_container"))
3362 ELM_CONTAINER_CLASS(sd->api)->content_set(obj, part, content);
3366 elm_widget_content_part_get(const Evas_Object *obj,
3369 API_ENTRY return NULL;
3371 if (!sd->api) return NULL;
3373 if (evas_object_smart_type_check(obj, "elm_container"))
3374 return ELM_CONTAINER_CLASS(sd->api)->content_get(obj, part);
3380 elm_widget_content_part_unset(Evas_Object *obj,
3383 API_ENTRY return NULL;
3385 if (!sd->api) return NULL;
3386 if (evas_object_smart_type_check(obj, "elm_container"))
3387 return ELM_CONTAINER_CLASS(sd->api)->content_unset(obj, part);
3393 elm_widget_access_info_set(Evas_Object *obj,
3397 if (sd->access_info) eina_stringshare_del(sd->access_info);
3398 if (!txt) sd->access_info = NULL;
3399 else sd->access_info = eina_stringshare_add(txt);
3403 elm_widget_access_info_get(const Evas_Object *obj)
3405 API_ENTRY return NULL;
3406 return sd->access_info;
3410 elm_widget_theme_get(const Evas_Object *obj)
3412 API_ENTRY return NULL;
3416 return elm_widget_theme_get(sd->parent_obj);
3424 elm_widget_style_set(Evas_Object *obj,
3427 API_ENTRY return EINA_FALSE;
3429 if (eina_stringshare_replace(&sd->style, style))
3430 return elm_widget_theme(obj);
3436 elm_widget_style_get(const Evas_Object *obj)
3438 API_ENTRY return NULL;
3439 if (sd->style) return sd->style;
3444 elm_widget_tooltip_add(Evas_Object *obj,
3448 sd->tooltips = eina_list_append(sd->tooltips, tt);
3452 elm_widget_tooltip_del(Evas_Object *obj,
3456 sd->tooltips = eina_list_remove(sd->tooltips, tt);
3460 elm_widget_cursor_add(Evas_Object *obj,
3464 sd->cursors = eina_list_append(sd->cursors, cur);
3468 elm_widget_cursor_del(Evas_Object *obj,
3472 sd->cursors = eina_list_remove(sd->cursors, cur);
3476 elm_widget_drag_lock_x_set(Evas_Object *obj,
3480 if (sd->drag_x_locked == lock) return;
3481 sd->drag_x_locked = lock;
3482 if (sd->drag_x_locked) _propagate_x_drag_lock(obj, 1);
3483 else _propagate_x_drag_lock(obj, -1);
3487 elm_widget_drag_lock_y_set(Evas_Object *obj,
3491 if (sd->drag_y_locked == lock) return;
3492 sd->drag_y_locked = lock;
3493 if (sd->drag_y_locked) _propagate_y_drag_lock(obj, 1);
3494 else _propagate_y_drag_lock(obj, -1);
3498 elm_widget_drag_lock_x_get(const Evas_Object *obj)
3500 API_ENTRY return EINA_FALSE;
3501 return sd->drag_x_locked;
3505 elm_widget_drag_lock_y_get(const Evas_Object *obj)
3507 API_ENTRY return EINA_FALSE;
3508 return sd->drag_y_locked;
3512 elm_widget_drag_child_locked_x_get(const Evas_Object *obj)
3515 return sd->child_drag_x_locked;
3519 elm_widget_drag_child_locked_y_get(const Evas_Object *obj)
3522 return sd->child_drag_y_locked;
3526 elm_widget_theme_object_set(Evas_Object *obj,
3529 const char *welement,
3532 API_ENTRY return EINA_FALSE;
3535 if (!_elm_theme_object_set(obj, edj, wname, welement, wstyle))
3538 if (sd->orient_mode != -1)
3541 snprintf(buf, sizeof(buf), "elm,state,orient,%d", sd->orient_mode);
3542 elm_widget_signal_emit(obj, buf, "elm");
3549 elm_widget_is_check(const Evas_Object *obj)
3551 static int abort_on_warn = -1;
3552 if (elm_widget_is(obj))
3555 ERR("Passing Object: %p.", obj);
3556 if (abort_on_warn == -1)
3558 if (getenv("ELM_ERROR_ABORT")) abort_on_warn = 1;
3559 else abort_on_warn = 0;
3561 if (abort_on_warn == 1) abort();
3566 elm_widget_type_get(const Evas_Object *obj)
3568 API_ENTRY return NULL;
3570 return evas_object_type_get(obj);
3574 elm_widget_type_check(const Evas_Object *obj,
3578 const char *provided, *expected = "(unknown)";
3579 static int abort_on_warn = -1;
3581 provided = elm_widget_type_get(obj);
3582 /* TODO: eventually migrate to check_ptr version */
3583 if (evas_object_smart_type_check(obj, type)) return EINA_TRUE;
3584 if (type) expected = type;
3585 if ((!provided) || (!provided[0]))
3587 provided = evas_object_type_get(obj);
3588 if ((!provided) || (!provided[0]))
3589 provided = "(unknown)";
3591 ERR("Passing Object: %p in function: %s, of type: '%s' when expecting"
3592 " type: '%s'", obj, func, provided, expected);
3593 if (abort_on_warn == -1)
3595 if (getenv("ELM_ERROR_ABORT")) abort_on_warn = 1;
3596 else abort_on_warn = 0;
3598 if (abort_on_warn == 1) abort();
3602 static Evas_Object *
3603 _widget_name_find(const Evas_Object *obj,
3610 INTERNAL_ENTRY NULL;
3612 if (!_elm_widget_is(obj)) return NULL;
3615 s = evas_object_name_get(sd->resize_obj);
3616 if ((s) && (!strcmp(s, name))) return sd->resize_obj;
3617 if ((recurse != 0) &&
3618 ((child = _widget_name_find(sd->resize_obj, name, recurse - 1))))
3621 EINA_LIST_FOREACH(sd->subobjs, l, child)
3623 s = evas_object_name_get(child);
3624 if ((s) && (!strcmp(s, name))) return child;
3625 if ((recurse != 0) &&
3626 ((child = _widget_name_find(child, name, recurse - 1))))
3631 s = evas_object_name_get(sd->hover_obj);
3632 if ((s) && (!strcmp(s, name))) return sd->hover_obj;
3633 if ((recurse != 0) &&
3634 ((child = _widget_name_find(sd->hover_obj, name, recurse - 1))))
3641 elm_widget_name_find(const Evas_Object *obj,
3645 API_ENTRY return NULL;
3646 if (!name) return NULL;
3647 return _widget_name_find(obj, name, recurse);
3651 elm_widget_orientation_mode_disabled_set(Evas_Object *obj, Eina_Bool disabled)
3653 int orient_mode = -1;
3657 if (disabled && (sd->orient_mode == -1)) return;
3658 if (!disabled && (sd->orient_mode != -1)) return;
3662 //Get current orient mode from it's parent otherwise, 0.
3663 sd->orient_mode = 0;
3664 ELM_WIDGET_DATA_GET(sd->parent_obj, sd_parent);
3665 if (!sd_parent) orient_mode = 0;
3666 else orient_mode = sd_parent->orient_mode;
3668 elm_widget_orientation_set(obj, orient_mode);
3672 elm_widget_orientation_mode_disabled_get(const Evas_Object *obj)
3676 API_ENTRY return EINA_FALSE;
3678 if (sd->orient_mode == -1) ret = EINA_TRUE;
3679 else ret = EINA_FALSE;
3684 elm_widget_orientation_set(Evas_Object *obj, int rotation)
3691 if ((sd->orient_mode == rotation) || (sd->orient_mode == -1)) return;
3693 sd->orient_mode = rotation;
3695 EINA_LIST_FOREACH (sd->subobjs, l, child)
3696 elm_widget_orientation_set(child, rotation);
3701 snprintf(buf, sizeof(buf), "elm,state,orient,%d", sd->orient_mode);
3702 elm_widget_signal_emit(obj, buf, "elm");
3709 * Split string in words
3711 * @param str Source string
3712 * @return List of const words
3714 * @see elm_widget_stringlist_free()
3718 elm_widget_stringlist_get(const char *str)
3720 Eina_List *list = NULL;
3722 if (!str) return NULL;
3723 for (b = s = str; 1; s++)
3725 if ((*s == ' ') || (!*s))
3727 char *t = malloc(s - b + 1);
3730 strncpy(t, b, s - b);
3732 list = eina_list_append(list, eina_stringshare_add(t));
3743 elm_widget_stringlist_free(Eina_List *list)
3746 EINA_LIST_FREE (list, s)
3747 eina_stringshare_del(s);
3751 elm_widget_focus_hide_handle(Evas_Object *obj)
3753 if (!_elm_widget_is(obj))
3755 _if_focused_revert(obj, EINA_TRUE);
3759 elm_widget_focus_mouse_up_handle(Evas_Object *obj)
3761 Evas_Object *o = obj;
3764 if (_elm_widget_is(o)) break;
3765 o = evas_object_smart_parent_get(o);
3769 if (!_is_focusable(o)) return;
3770 elm_widget_focus_steal(o);
3774 elm_widget_focus_tree_unfocusable_handle(Evas_Object *obj)
3778 //FIXME: Need to check whether the object is unfocusable or not.
3780 if (!elm_widget_parent_get(obj))
3781 elm_widget_focused_object_clear(obj);
3783 _if_focused_revert(obj, EINA_TRUE);
3787 elm_widget_focus_disabled_handle(Evas_Object *obj)
3791 elm_widget_focus_tree_unfocusable_handle(obj);
3795 elm_widget_focus_order_get(const Evas_Object *obj)
3798 return sd->focus_order;
3802 elm_widget_newest_focus_order_get(const Evas_Object *obj,
3803 unsigned int *newest_focus_order,
3804 Eina_Bool can_focus_only)
3807 Evas_Object *child, *ret, *best;
3809 API_ENTRY return NULL;
3811 if (!evas_object_visible_get(obj)
3812 || (elm_widget_disabled_get(obj))
3813 || (elm_widget_tree_unfocusable_get(obj)))
3817 if (*newest_focus_order < sd->focus_order)
3819 *newest_focus_order = sd->focus_order;
3820 best = (Evas_Object *)obj;
3822 EINA_LIST_FOREACH(sd->subobjs, l, child)
3824 ret = elm_widget_newest_focus_order_get
3825 (child, newest_focus_order, can_focus_only);
3831 if ((!best) || (!elm_widget_can_focus_get(best)))
3838 elm_widget_activate(Evas_Object *obj, Elm_Activate act)
3840 Evas_Object *parent;
3846 if (sd->api->activate)
3847 ret = sd->api->activate(obj, act);
3851 parent = elm_widget_parent_get(obj);
3853 elm_widget_activate(parent, act);
3861 * Returns the widget's Evas_Display_Mode
3863 * @param obj The widget.
3864 * @return Evas_Display_Mode of the object.
3866 * @see elm_widget_display_mode_set().
3869 EAPI Evas_Display_Mode
3870 elm_widget_display_mode_get(const Evas_Object *obj)
3872 Evas_Display_Mode new_mode;
3873 Evas_Object *parent;
3875 API_ENTRY return EVAS_DISPLAY_MODE_NONE;
3877 new_mode = evas_object_size_hint_display_mode_get(obj);
3878 parent = elm_widget_parent_get(obj);
3880 if ((new_mode == EVAS_DISPLAY_MODE_INHERIT) && parent)
3881 return elm_widget_display_mode_get(parent);
3889 * Sets the widget and child widget's Evas_Display_Mode.
3891 * @param obj The widget.
3892 * @param dispmode Evas_Display_Mode to set widget's mode.
3894 * Widgets are resized by several reasons.
3895 * Evas_Display_Mode can help for widgets to get one more reason of resize.
3896 * For example, elm conform widget resizes it's contents when keypad state changed.
3897 * After keypad showing, conform widget can change child's Evas_Display_Mode.
3901 elm_widget_display_mode_set(Evas_Object *obj, Evas_Display_Mode dispmode)
3903 Evas_Display_Mode child_mode;
3909 if (elm_widget_display_mode_get(obj) == dispmode) return;
3910 evas_object_size_hint_display_mode_set(obj, dispmode);
3912 //TODO: Need to deal with EVAS_DISPLAY_MODE_INHERIT efficiently.
3913 EINA_LIST_FOREACH (sd->subobjs, l, child)
3915 child_mode = evas_object_size_hint_display_mode_get(child);
3916 if (child_mode != EVAS_DISPLAY_MODE_DONT_CHANGE)
3918 elm_widget_display_mode_set(child, dispmode);
3924 // temporary code. should be removed after eo is applied.
3926 _elm_widget_orient_signal_emit(Evas_Object *obj)
3928 ELM_WIDGET_DATA_GET(obj, sd);
3930 if (sd->orient_mode > 0)
3932 snprintf(buf, sizeof(buf), "elm,state,orient,%d", sd->orient_mode);
3933 elm_widget_signal_emit(obj, buf, "elm");
3940 * Allocate a new Elm_Widget_Item-derived structure.
3942 * The goal of this structure is to provide common ground for actions
3943 * that a widget item have, such as the owner widget, callback to
3944 * notify deletion, data pointer and maybe more.
3946 * @param widget the owner widget that holds this item, must be an elm_widget!
3947 * @param alloc_size any number greater than sizeof(Elm_Widget_Item) that will
3948 * be used to allocate memory.
3950 * @return allocated memory that is already zeroed out, or NULL on errors.
3952 * @see elm_widget_item_new() convenience macro.
3953 * @see elm_widget_item_del() to release memory.
3956 EAPI Elm_Widget_Item *
3957 _elm_widget_item_new(Evas_Object *widget,
3960 if (!_elm_widget_is(widget))
3963 Elm_Widget_Item *item;
3965 EINA_SAFETY_ON_TRUE_RETURN_VAL(alloc_size < sizeof(Elm_Widget_Item), NULL);
3966 EINA_SAFETY_ON_TRUE_RETURN_VAL(!_elm_widget_is(widget), NULL);
3968 item = calloc(1, alloc_size);
3969 EINA_SAFETY_ON_NULL_RETURN_VAL(item, NULL);
3971 EINA_MAGIC_SET(item, ELM_WIDGET_ITEM_MAGIC);
3972 item->widget = widget;
3977 _elm_widget_item_free(Elm_Widget_Item *item)
3979 Elm_Widget_Item_Signal_Data *wisd;
3981 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
3984 item->del_func((void *)item->data, item->widget, item);
3987 evas_object_del(item->view);
3989 if (item->access_info)
3990 eina_stringshare_del(item->access_info);
3992 EINA_LIST_FREE(item->signals, wisd)
3994 eina_stringshare_del(wisd->emission);
3995 eina_stringshare_del(wisd->source);
3999 EINA_MAGIC_SET(item, EINA_MAGIC_NONE);
4006 * Releases widget item memory, calling back del_cb() if it exists.
4008 * If there is a Elm_Widget_Item::del_cb, then it will be called prior
4009 * to memory release. Note that elm_widget_item_pre_notify_del() calls
4010 * this function and then unset it, thus being useful for 2 step
4011 * cleanup whenever the del_cb may use any of the data that must be
4012 * deleted from item.
4014 * The Elm_Widget_Item::view will be deleted (evas_object_del()) if it
4017 * @param item a valid #Elm_Widget_Item to be deleted.
4018 * @see elm_widget_item_del() convenience macro.
4022 _elm_widget_item_del(Elm_Widget_Item *item)
4024 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4025 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4026 item->on_deletion = EINA_TRUE;
4028 //Widget item delete callback
4029 if (item->del_pre_func)
4030 if (item->del_pre_func((Elm_Object_Item *)item))
4031 _elm_widget_item_free(item);
4037 * Set the function to notify to widgets when item is being deleted by user.
4039 * @param item a valid #Elm_Widget_Item to be notified
4040 * @see elm_widget_item_del_pre_hook_set() convenience macro.
4044 _elm_widget_item_del_pre_hook_set(Elm_Widget_Item *item,
4045 Elm_Widget_Del_Pre_Cb func)
4047 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4048 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4049 item->del_pre_func = func;
4055 * Notify object will be deleted without actually deleting it.
4057 * This function will callback Elm_Widget_Item::del_cb if it is set
4058 * and then unset it so it is not called twice (ie: from
4059 * elm_widget_item_del()).
4061 * @param item a valid #Elm_Widget_Item to be notified
4062 * @see elm_widget_item_pre_notify_del() convenience macro.
4066 _elm_widget_item_pre_notify_del(Elm_Widget_Item *item)
4068 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4069 if (!item->del_func) return;
4070 item->del_func((void *)item->data, item->widget, item);
4071 item->del_func = NULL;
4077 * Set the function to notify when item is being deleted.
4079 * This function will complain if there was a callback set already,
4080 * however it will set the new one.
4082 * The callback will be called from elm_widget_item_pre_notify_del()
4083 * or elm_widget_item_del() will be called with:
4084 * - data: the Elm_Widget_Item::data value.
4085 * - obj: the Elm_Widget_Item::widget evas object.
4086 * - event_info: the item being deleted.
4088 * @param item a valid #Elm_Widget_Item to be notified
4089 * @see elm_widget_item_del_cb_set() convenience macro.
4093 _elm_widget_item_del_cb_set(Elm_Widget_Item *item,
4096 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4097 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4099 if ((item->del_func) && (item->del_func != func))
4100 WRN("You're replacing a previously set del_cb %p of item %p with %p",
4101 item->del_func, item, func);
4103 item->del_func = func;
4109 * Retrieves owner widget of this item.
4111 * @param item a valid #Elm_Widget_Item to get data from.
4112 * @return owner widget of this item.
4116 _elm_widget_item_widget_get(const Elm_Widget_Item *item)
4118 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, NULL);
4119 return item->widget;
4125 * Set user-data in this item.
4127 * User data may be used to identify this item or just store any
4128 * application data. It is automatically given as the first parameter
4129 * of the deletion notify callback.
4131 * @param item a valid #Elm_Widget_Item to store data in.
4132 * @param data user data to store.
4133 * @see elm_widget_item_del_cb_set() convenience macro.
4137 _elm_widget_item_data_set(Elm_Widget_Item *item,
4140 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4141 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4143 if ((item->data) && (item->data != data))
4144 DBG("Replacing item %p data %p with %p", item, item->data, data);
4151 * Retrieves user-data of this item.
4153 * @param item a valid #Elm_Widget_Item to get data from.
4154 * @see elm_widget_item_data_set()
4158 _elm_widget_item_data_get(const Elm_Widget_Item *item)
4160 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, NULL);
4161 return (void *)item->data;
4165 _elm_widget_item_disabled_set(Elm_Widget_Item *item,
4168 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4169 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4171 if (item->disabled == disabled) return;
4172 item->disabled = !!disabled;
4173 if (item->disable_func) item->disable_func(item);
4177 _elm_widget_item_disabled_get(const Elm_Widget_Item *item)
4179 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, EINA_FALSE);
4180 return item->disabled;
4184 _elm_widget_item_disable_hook_set(Elm_Widget_Item *item,
4185 Elm_Widget_Disable_Cb func)
4187 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4188 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4190 item->disable_func = func;
4193 typedef struct _Elm_Widget_Item_Tooltip Elm_Widget_Item_Tooltip;
4195 struct _Elm_Widget_Item_Tooltip
4197 Elm_Widget_Item *item;
4198 Elm_Tooltip_Item_Content_Cb func;
4199 Evas_Smart_Cb del_cb;
4203 static Evas_Object *
4204 _elm_widget_item_tooltip_label_create(void *data,
4205 Evas_Object *obj __UNUSED__,
4206 Evas_Object *tooltip,
4207 void *item __UNUSED__)
4209 Evas_Object *label = elm_label_add(tooltip);
4212 elm_object_style_set(label, "tooltip");
4213 elm_object_text_set(label, data);
4217 static Evas_Object *
4218 _elm_widget_item_tooltip_trans_label_create(void *data,
4219 Evas_Object *obj __UNUSED__,
4220 Evas_Object *tooltip,
4221 void *item __UNUSED__)
4223 Evas_Object *label = elm_label_add(tooltip);
4226 elm_object_style_set(label, "tooltip");
4227 elm_object_translatable_text_set(label, data);
4232 _elm_widget_item_tooltip_label_del_cb(void *data,
4233 Evas_Object *obj __UNUSED__,
4234 void *event_info __UNUSED__)
4236 eina_stringshare_del(data);
4242 * Set the text to be shown in the widget item.
4244 * @param item Target item
4245 * @param text The text to set in the content
4247 * Setup the text as tooltip to object. The item can have only one tooltip,
4248 * so any previous tooltip data is removed.
4253 _elm_widget_item_tooltip_text_set(Elm_Widget_Item *item,
4256 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4257 EINA_SAFETY_ON_NULL_RETURN(text);
4258 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4260 text = eina_stringshare_add(text);
4261 _elm_widget_item_tooltip_content_cb_set
4262 (item, _elm_widget_item_tooltip_label_create, text,
4263 _elm_widget_item_tooltip_label_del_cb);
4267 _elm_widget_item_tooltip_translatable_text_set(Elm_Widget_Item *item,
4270 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4271 EINA_SAFETY_ON_NULL_RETURN(text);
4272 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4274 text = eina_stringshare_add(text);
4275 _elm_widget_item_tooltip_content_cb_set
4276 (item, _elm_widget_item_tooltip_trans_label_create, text,
4277 _elm_widget_item_tooltip_label_del_cb);
4280 static Evas_Object *
4281 _elm_widget_item_tooltip_create(void *data,
4283 Evas_Object *tooltip)
4285 Elm_Widget_Item_Tooltip *wit = data;
4286 return wit->func((void *)wit->data, obj, tooltip, wit->item);
4290 _elm_widget_item_tooltip_del_cb(void *data,
4292 void *event_info __UNUSED__)
4294 Elm_Widget_Item_Tooltip *wit = data;
4295 if (wit->del_cb) wit->del_cb((void *)wit->data, obj, wit->item);
4302 * Set the content to be shown in the tooltip item
4304 * Setup the tooltip to item. The item can have only one tooltip,
4305 * so any previous tooltip data is removed. @p func(with @p data) will
4306 * be called every time that need show the tooltip and it should
4307 * return a valid Evas_Object. This object is then managed fully by
4308 * tooltip system and is deleted when the tooltip is gone.
4310 * @param item the widget item being attached a tooltip.
4311 * @param func the function used to create the tooltip contents.
4312 * @param data what to provide to @a func as callback data/context.
4313 * @param del_cb called when data is not needed anymore, either when
4314 * another callback replaces @func, the tooltip is unset with
4315 * elm_widget_item_tooltip_unset() or the owner @a item
4316 * dies. This callback receives as the first parameter the
4317 * given @a data, and @c event_info is the item.
4322 _elm_widget_item_tooltip_content_cb_set(Elm_Widget_Item *item,
4323 Elm_Tooltip_Item_Content_Cb func,
4325 Evas_Smart_Cb del_cb)
4327 Elm_Widget_Item_Tooltip *wit;
4329 ELM_WIDGET_ITEM_CHECK_OR_GOTO(item, error_noitem);
4330 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4333 _elm_widget_item_tooltip_unset(item);
4337 wit = ELM_NEW(Elm_Widget_Item_Tooltip);
4338 if (!wit) goto error;
4342 wit->del_cb = del_cb;
4344 elm_object_sub_tooltip_content_cb_set
4345 (item->view, item->widget, _elm_widget_item_tooltip_create, wit,
4346 _elm_widget_item_tooltip_del_cb);
4351 if (del_cb) del_cb((void *)data, NULL, item);
4354 if (del_cb) del_cb((void *)data, item->widget, item);
4360 * Unset tooltip from item
4362 * @param item widget item to remove previously set tooltip.
4364 * Remove tooltip from item. The callback provided as del_cb to
4365 * elm_widget_item_tooltip_content_cb_set() will be called to notify
4366 * it is not used anymore.
4368 * @see elm_widget_item_tooltip_content_cb_set()
4373 _elm_widget_item_tooltip_unset(Elm_Widget_Item *item)
4375 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4376 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4378 elm_object_tooltip_unset(item->view);
4384 * Sets a different style for this item tooltip.
4386 * @note before you set a style you should define a tooltip with
4387 * elm_widget_item_tooltip_content_cb_set() or
4388 * elm_widget_item_tooltip_text_set()
4390 * @param item widget item with tooltip already set.
4391 * @param style the theme style to use (default, transparent, ...)
4396 _elm_widget_item_tooltip_style_set(Elm_Widget_Item *item,
4399 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4400 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4402 elm_object_tooltip_style_set(item->view, style);
4406 _elm_widget_item_tooltip_window_mode_set(Elm_Widget_Item *item,
4409 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, EINA_FALSE);
4410 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item, EINA_FALSE);
4412 return elm_object_tooltip_window_mode_set(item->view, disable);
4416 _elm_widget_item_tooltip_window_mode_get(const Elm_Widget_Item *item)
4418 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, EINA_FALSE);
4419 return elm_object_tooltip_window_mode_get(item->view);
4425 * Get the style for this item tooltip.
4427 * @param item widget item with tooltip already set.
4428 * @return style the theme style in use, defaults to "default". If the
4429 * object does not have a tooltip set, then NULL is returned.
4434 _elm_widget_item_tooltip_style_get(const Elm_Widget_Item *item)
4436 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, NULL);
4437 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item, NULL);
4439 return elm_object_tooltip_style_get(item->view);
4443 _elm_widget_item_cursor_set(Elm_Widget_Item *item,
4446 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4447 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4449 elm_object_sub_cursor_set(item->view, item->widget, cursor);
4453 _elm_widget_item_cursor_get(const Elm_Widget_Item *item)
4455 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, NULL);
4456 return elm_object_cursor_get(item->view);
4460 _elm_widget_item_cursor_unset(Elm_Widget_Item *item)
4462 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4463 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4465 elm_object_cursor_unset(item->view);
4471 * Sets a different style for this item cursor.
4473 * @note before you set a style you should define a cursor with
4474 * elm_widget_item_cursor_set()
4476 * @param item widget item with cursor already set.
4477 * @param style the theme style to use (default, transparent, ...)
4482 _elm_widget_item_cursor_style_set(Elm_Widget_Item *item,
4485 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4486 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4488 elm_object_cursor_style_set(item->view, style);
4494 * Get the style for this item cursor.
4496 * @param item widget item with cursor already set.
4497 * @return style the theme style in use, defaults to "default". If the
4498 * object does not have a cursor set, then NULL is returned.
4503 _elm_widget_item_cursor_style_get(const Elm_Widget_Item *item)
4505 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, NULL);
4506 return elm_object_cursor_style_get(item->view);
4512 * Set if the cursor set should be searched on the theme or should use
4513 * the provided by the engine, only.
4515 * @note before you set if should look on theme you should define a cursor
4516 * with elm_object_cursor_set(). By default it will only look for cursors
4517 * provided by the engine.
4519 * @param item widget item with cursor already set.
4520 * @param engine_only boolean to define it cursors should be looked only
4521 * between the provided by the engine or searched on widget's theme as well.
4526 _elm_widget_item_cursor_engine_only_set(Elm_Widget_Item *item,
4527 Eina_Bool engine_only)
4529 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4530 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4532 elm_object_cursor_theme_search_enabled_set(item->view, engine_only);
4538 * Get the cursor engine only usage for this item cursor.
4540 * @param item widget item with cursor already set.
4541 * @return engine_only boolean to define it cursors should be looked only
4542 * between the provided by the engine or searched on widget's theme as well. If
4543 * the object does not have a cursor set, then EINA_FALSE is returned.
4548 _elm_widget_item_cursor_engine_only_get(const Elm_Widget_Item *item)
4550 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, EINA_FALSE);
4551 return elm_object_cursor_theme_search_enabled_get(item->view);
4555 _elm_widget_item_part_content_set(Elm_Widget_Item *item,
4557 Evas_Object *content)
4559 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4560 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4561 if (!item->content_set_func)
4563 ERR("%s does not support elm_object_item_part_content_set() API.",
4564 elm_widget_type_get(item->widget));
4567 item->content_set_func((Elm_Object_Item *)item, part, content);
4571 _elm_widget_item_part_content_get(const Elm_Widget_Item *item,
4574 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, NULL);
4575 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item, NULL);
4577 return item->content_get_func((Elm_Object_Item *)item, part);
4581 _elm_widget_item_part_content_unset(Elm_Widget_Item *item,
4584 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, NULL);
4585 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item, NULL);
4586 if (!item->content_unset_func)
4588 ERR("%s does not support elm_object_item_part_content_unset() API.",
4589 elm_widget_type_get(item->widget));
4593 return item->content_unset_func((Elm_Object_Item *)item, part);
4597 _elm_widget_item_part_text_set(Elm_Widget_Item *item,
4601 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4602 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4603 if (!item->text_set_func)
4605 ERR("%s does not support elm_object_item_part_text_set() API.",
4606 elm_widget_type_get(item->widget));
4610 item->text_set_func((Elm_Object_Item *)item, part, label);
4614 _elm_widget_item_part_text_get(const Elm_Widget_Item *item,
4617 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, NULL);
4618 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item, NULL);
4619 if (!item->text_get_func)
4621 ERR("%s does not support elm_object_item_part_text_get() API.",
4622 elm_widget_type_get(item->widget));
4626 return item->text_get_func((Elm_Object_Item *)item, part);
4630 _elm_widget_item_content_set_hook_set(Elm_Widget_Item *item,
4631 Elm_Widget_Content_Set_Cb func)
4633 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4634 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4636 item->content_set_func = func;
4640 _elm_widget_item_content_get_hook_set(Elm_Widget_Item *item,
4641 Elm_Widget_Content_Get_Cb func)
4643 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4644 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4646 item->content_get_func = func;
4650 _elm_widget_item_content_unset_hook_set(Elm_Widget_Item *item,
4651 Elm_Widget_Content_Unset_Cb func)
4653 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4654 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4656 item->content_unset_func = func;
4660 _elm_widget_item_text_set_hook_set(Elm_Widget_Item *item,
4661 Elm_Widget_Text_Set_Cb func)
4663 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4664 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4666 item->text_set_func = func;
4670 _elm_widget_item_text_get_hook_set(Elm_Widget_Item *item,
4671 Elm_Widget_Text_Get_Cb func)
4673 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4674 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4676 item->text_get_func = func;
4680 _elm_widget_item_signal_emit(Elm_Widget_Item *item,
4681 const char *emission,
4684 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4685 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4687 if (item->signal_emit_func)
4688 item->signal_emit_func((Elm_Object_Item *)item, emission, source);
4692 _elm_widget_item_signal_emit_hook_set(Elm_Widget_Item *item,
4693 Elm_Widget_Signal_Emit_Cb func)
4695 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4696 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4698 item->signal_emit_func = func;
4703 _elm_widget_item_signal_cb(void *data, Evas_Object *obj __UNUSED__, const char *emission,
4706 Elm_Widget_Item_Signal_Data *wisd = data;
4707 wisd->func(wisd->data, wisd->item, emission, source);
4711 _elm_widget_item_signal_callback_add(Elm_Widget_Item *item,
4712 const char *emission,
4714 Elm_Widget_Item_Signal_Cb func,
4717 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4718 EINA_SAFETY_ON_NULL_RETURN(func);
4720 Elm_Widget_Item_Signal_Data *wisd;
4722 wisd = malloc(sizeof(Elm_Widget_Item_Signal_Data));
4728 wisd->emission = eina_stringshare_add(emission);
4729 wisd->source = eina_stringshare_add(source);
4731 if (_elm_widget_is(item->view))
4732 elm_object_signal_callback_add(item->view, emission, source, _elm_widget_item_signal_cb, wisd);
4733 else if (!strcmp(evas_object_type_get(item->view), "edje"))
4734 edje_object_signal_callback_add(item->view, emission, source, _elm_widget_item_signal_cb, wisd);
4737 WRN("The %s widget item doesn't support signal callback add!",
4738 evas_object_type_get(item->widget));
4743 item->signals = eina_list_append(item->signals, wisd);
4747 _elm_widget_item_signal_callback_del(Elm_Widget_Item *item,
4748 const char *emission,
4750 Elm_Widget_Item_Signal_Cb func)
4752 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item, NULL);
4753 EINA_SAFETY_ON_NULL_RETURN_VAL(func, NULL);
4755 Elm_Widget_Item_Signal_Data *wisd;
4759 EINA_LIST_FOREACH(item->signals, l, wisd)
4761 if ((wisd->func == func) && !strcmp(wisd->emission, emission) &&
4762 !strcmp(wisd->source, source))
4764 item->signals = eina_list_remove_list(item->signals, l);
4765 eina_stringshare_del(wisd->emission);
4766 eina_stringshare_del(wisd->source);
4769 if (_elm_widget_is(item->view))
4770 elm_object_signal_callback_del(item->view, emission, source,
4771 _elm_widget_item_signal_cb);
4772 else if (!strcmp(evas_object_type_get(item->view), "edje"))
4773 edje_object_signal_callback_del_full(item->view, emission,
4775 _elm_widget_item_signal_cb,
4784 _elm_widget_item_access_info_set(Elm_Widget_Item *item,
4787 ELM_WIDGET_ITEM_CHECK_OR_RETURN(item);
4788 ELM_WIDGET_ITEM_RETURN_IF_ONDEL(item);
4790 if (item->access_info) eina_stringshare_del(item->access_info);
4791 if (!txt) item->access_info = NULL;
4792 else item->access_info = eina_stringshare_add(txt);
4795 /* happy debug functions */
4798 _sub_obj_tree_dump(const Evas_Object *obj,
4803 for (i = 0; i < lvl * 3; i++)
4806 if (_elm_widget_is(obj))
4810 printf("+ %s(%p)\n",
4811 elm_widget_type_get(obj),
4814 _sub_obj_tree_dump(sd->resize_obj, lvl + 1);
4815 EINA_LIST_FOREACH(sd->subobjs, l, obj)
4817 if (obj != sd->resize_obj)
4818 _sub_obj_tree_dump(obj, lvl + 1);
4822 printf("+ %s(%p)\n", evas_object_type_get(obj), obj);
4826 _sub_obj_tree_dot_dump(const Evas_Object *obj,
4829 if (!_elm_widget_is(obj))
4833 Eina_Bool visible = evas_object_visible_get(obj);
4834 Eina_Bool disabled = elm_widget_disabled_get(obj);
4835 Eina_Bool focused = elm_widget_focus_get(obj);
4836 Eina_Bool can_focus = elm_widget_can_focus_get(obj);
4840 fprintf(output, "\"%p\" -- \"%p\" [ color=black", sd->parent_obj, obj);
4843 fprintf(output, ", style=bold");
4846 fprintf(output, ", color=gray28");
4848 fprintf(output, " ];\n");
4851 fprintf(output, "\"%p\" [ label = \"{%p|%s|%s|visible: %d|"
4852 "disabled: %d|focused: %d/%d|focus order:%d}\"",
4853 obj, obj, elm_widget_type_get(obj),
4854 evas_object_name_get(obj), visible, disabled, focused, can_focus,
4858 fprintf(output, ", style=bold");
4861 fprintf(output, ", fontcolor=gray28");
4863 if ((disabled) || (!visible))
4864 fprintf(output, ", color=gray");
4866 fprintf(output, " ];\n");
4870 EINA_LIST_FOREACH(sd->subobjs, l, o)
4871 _sub_obj_tree_dot_dump(o, output);
4877 elm_widget_tree_dump(const Evas_Object *top)
4880 if (!_elm_widget_is(top))
4882 _sub_obj_tree_dump(top, 0);
4890 elm_widget_tree_dot_dump(const Evas_Object *top,
4894 if (!_elm_widget_is(top))
4896 fprintf(output, "graph " " { node [shape=record];\n");
4897 _sub_obj_tree_dot_dump(top, output);
4898 fprintf(output, "}\n");