elementary - entry, genlist, gengrid, image, icon, hover, frame, diskselector, index...
[framework/uifw/elementary.git] / src / lib / elm_gengrid.c
1 #include <Elementary.h>
2 #include <Elementary_Cursor.h>
3 #include "elm_priv.h"
4
5 /**
6  * @defgroup Gengrid Gengrid
7  *
8  * This widget aims to position objects in a grid layout while
9  * actually building only the visible ones, using the same idea as
10  * genlist: the user define a class for each item, specifying
11  * functions that will be called at object creation and deletion.
12  *
13  * Signals that you can add callbacks for are:
14  *
15  * clicked - The user has double-clicked or pressed enter on
16  * a item. The event_infoparameter is the Gengrid item
17  * that was double-clicked.
18  *
19  * selected - The user has made an item selected. The event_info
20  * parameter is the Gengrid item that was selected.
21  *
22  * unselected - The user has made an item unselected. The event_info
23  * parameter is the Gengrid item that was unselected.
24  *
25  * realized - This is called when the item in the Gengrid is created
26  * as a real evas object. event_info is the Gengrid item that was
27  * created. The object may be deleted at any time, so it is up to the
28  * caller to not use the object pointer from
29  * elm_gengrid_item_object_get() in a way where it may point to freed
30  * objects.
31  *
32  * unrealized - This is called when the real evas object for this item
33  * is deleted. event_info is the Gengrid item that was created.
34  *
35  * changed - Called when an item is added, removed, resized or moved
36  * and when gengrid is resized or horizontal property changes.
37  *
38  * drag,start,up - Called when the item in the Gengrid has been
39  * dragged (not scrolled) up.
40  *
41  * drag,start,down - Called when the item in the Gengrid has been
42  * dragged (not scrolled) down.
43  *
44  * drag,start,left - Called when the item in the Gengrid has been
45  * dragged (not scrolled) left.
46  *
47  * drag,start,right - Called when the item in the Gengrid has been
48  * dragged (not scrolled) right.
49  *
50  * drag,stop - Called when the item in the Gengrid has stopped being
51  * dragged.
52  *
53  * drag - Called when the item in the Gengrid is being dragged.
54  *
55  * scroll - called when the content has been scrolled (moved).
56  *
57  * scroll,drag,start - called when dragging the content has started.
58  *
59  * scroll,drag,stop - called when dragging the content has stopped.
60  *
61  *
62  * A item in the Gengrid can have 0 or more text labels (they can be
63  * regular text or textblock - that's up to the style to determine), 0
64  * or more icons (which are simply objects swallowed into the Gengrid
65  * item) and 0 or more boolean states that can be used for check,
66  * radio or other indicators by the edje theme style.  A item may be
67  * one of several styles (Elementary provides 1 by default -
68  * "default", but this can be extended by system or application custom
69  * themes/overlays/extensions).
70  *
71  * In order to implement the ability to add and delete items on the
72  * fly, Gengrid implements a class/callback system where the
73  * application provides a structure with information about that type
74  * of item (Gengrid may contain multiple different items with
75  * different classes, states and styles). Gengrid will call the
76  * functions in this struct (methods) when a item is "realized" (that
77  * is created dynamically while scrolling). All objects will simply be
78  * deleted when no longer needed with evas_object_del(). The
79  * Elm_GenGrid_Item_Class structure contains the following members:
80  *
81  * item_style - This is a constant string and simply defines the name
82  * of the item style. It must be specified and the default should be
83  * "default".
84  *
85  * func.label_get - This function is called when an actual item object
86  * is created. The data parameter is the one passed to
87  * elm_gengrid_item_append() and related item creation functions. The
88  * obj parameter is the Gengrid object and the part parameter is the
89  * string name of the text part in the edje design that is listed as
90  * one of the possible labels that can be set. This function must
91  * return a strdup'()ed string as the caller will free() it when done.
92  *
93  * func.icon_get - This function is called when an actual item object
94  * is created. The data parameter is the one passed to
95  * elm_gengrid_item_append() and related item creation functions. The
96  * obj parameter is the Gengrid object and the part parameter is the
97  * string name of the icon part in the edje design that is listed as
98  * one of the possible icons that can be set. This must return NULL
99  * for no object or a valid object. The object will be deleted by
100  * Gengrid on shutdown or when the item is unrealized.
101  *
102  * func.state_get - This function is called when an actual item object
103  * is created. The data parameter is the one passed to
104  * elm_gengrid_item_append() and related item creation functions. The
105  * obj parameter is the Gengrid object and the part parameter is the
106  * string name of th state part in the edje design that is listed as
107  * one of the possible states that can be set. Return 0 for false and
108  * 1 for true. Gengrid will emit a signal to the edje object with
109  * "elm,state,XXX,active" "elm" when true (the default is false),
110  * where XXX is the name of the part.
111  *
112  * func.del - This is called when elm_gengrid_item_del() is called on
113  * a item or elm_gengrid_clear() is called on the Gengrid. This is
114  * intended for use when actual Gengrid items are deleted, so any
115  * backing data attached to the item (e.g. its data parameter on
116  * creation) can be deleted.
117  *
118  * If the application wants multiple items to be able to be selected,
119  * elm_gengrid_multi_select_set() can enable this. If the Gengrid is
120  * single-selection only (the default), then
121  * elm_gengrid_select_item_get() will return the selected item, if
122  * any, or NULL if none is selected. If the Gengrid is multi-select
123  * then elm_gengrid_selected_items_get() will return a list (that is
124  * only valid as long as no items are modified (added, deleted,
125  * selected or unselected).
126  *
127  * If a item changes (state of boolean changes, label or icons
128  * change), then use elm_gengrid_item_update() to have Gengrid update
129  * the item with the new state. Gengrid will re-realize the item thus
130  * call the functions in the _Elm_Gengrid_Item_Class for that item.
131  *
132  * To programmatically (un)select a item use
133  * elm_gengrid_item_selected_set().  To get its selected state use
134  * elm_gengrid_item_selected_get(). To make a item disabled (unable to
135  * be selected and appear differently) use
136  * elm_gengrid_item_disabled_set() to set this and
137  * elm_gengrid_item_disabled_get() to get the disabled state.
138  *
139  * Cells will only call their selection func and callback when first
140  * becoming selected. Any further clicks will do nothing, unless you
141  * enable always select with
142  * elm_gengrid_always_select_mode_set(). This means event if selected,
143  * every click will make the selected callbacks be called.
144  * elm_gengrid_no_select_mode_set() will turn off the ability to
145  * select items entirely and they will neither appear selected nor
146  * call selected callback function.
147  *
148  * Remember that you can create new styles and add your own theme
149  * augmentation per application with elm_theme_extension_add(). If you
150  * absolutely must have a specific style that overrides any theme the
151  * user or system sets up you can use elm_theme_overlay_add() to add
152  * such a file.
153  *
154  * --
155  * TODO:
156  *  * Handle non-homogeneous objects too.
157  */
158
159  typedef struct _Widget_Data Widget_Data;
160  typedef struct _Pan         Pan;
161
162 #define PRELOAD 1
163
164  struct _Elm_Gengrid_Item
165 {
166    Elm_Widget_Item               base;
167    EINA_INLIST;
168    Evas_Object                  *spacer;
169    const Elm_Gengrid_Item_Class *gic;
170    Ecore_Timer                  *long_timer;
171    Widget_Data                  *wd;
172    Eina_List                    *labels, *icons, *states, *icon_objs;
173    struct
174      {
175         Evas_Smart_Cb func;
176         const void   *data;
177      } func;
178
179    Evas_Coord x, y, dx, dy;
180    int        relcount;
181    int        walking;
182
183    struct
184      {
185         const void                 *data;
186         Elm_Tooltip_Item_Content_Cb content_cb;
187         Evas_Smart_Cb               del_cb;
188         const char                 *style;
189      } tooltip;
190
191    const char *mouse_cursor;
192
193    Eina_Bool   want_unrealize : 1;
194    Eina_Bool   realized : 1;
195    Eina_Bool   dragging : 1;
196    Eina_Bool   down : 1;
197    Eina_Bool   delete_me : 1;
198    Eina_Bool   display_only : 1;
199    Eina_Bool   disabled : 1;
200    Eina_Bool   selected : 1;
201    Eina_Bool   hilighted : 1;
202 };
203
204 struct _Widget_Data
205 {
206    Evas_Object      *self, *scr;
207    Evas_Object      *pan_smart;
208    Pan              *pan;
209    Eina_Inlist      *items;
210    Ecore_Job        *calc_job;
211    Eina_List        *selected;
212    Elm_Gengrid_Item *last_selected_item;
213    double            align_x, align_y;
214
215    Evas_Coord        pan_x, pan_y;
216    Evas_Coord        item_width, item_height; /* Each item size */
217    Evas_Coord        minw, minh; /* Total obj size */
218    unsigned int      nmax;
219    long              count;
220    int               walking;
221
222    Eina_Bool         horizontal : 1;
223    Eina_Bool         on_hold : 1;
224    Eina_Bool         longpressed : 1;
225    Eina_Bool         multi : 1;
226    Eina_Bool         no_select : 1;
227    Eina_Bool         wasselected : 1;
228    Eina_Bool         always_select : 1;
229    Eina_Bool         clear_me : 1;
230 };
231
232 #define ELM_GENGRID_ITEM_FROM_INLIST(item) \
233    ((item) ? EINA_INLIST_CONTAINER_GET(item, Elm_Gengrid_Item) : NULL)
234
235 struct _Pan
236 {
237    Evas_Object_Smart_Clipped_Data __clipped_data;
238    Widget_Data                   *wd;
239 };
240
241 static const char *widtype = NULL;
242 static void      _item_hilight(Elm_Gengrid_Item *item);
243 static void      _item_unrealize(Elm_Gengrid_Item *item);
244 static void      _item_select(Elm_Gengrid_Item *item);
245 static void      _item_unselect(Elm_Gengrid_Item *item);
246 static void      _calc_job(void *data);
247 static void      _on_focus_hook(void        *data,
248                                 Evas_Object *obj);
249 static Eina_Bool _item_multi_select_up(Widget_Data *wd);
250 static Eina_Bool _item_multi_select_down(Widget_Data *wd);
251 static Eina_Bool _item_multi_select_left(Widget_Data *wd);
252 static Eina_Bool _item_multi_select_right(Widget_Data *wd);
253 static Eina_Bool _item_single_select_up(Widget_Data *wd);
254 static Eina_Bool _item_single_select_down(Widget_Data *wd);
255 static Eina_Bool _item_single_select_left(Widget_Data *wd);
256 static Eina_Bool _item_single_select_right(Widget_Data *wd);
257 static Eina_Bool _event_hook(Evas_Object       *obj,
258                              Evas_Object       *src,
259                              Evas_Callback_Type type,
260                              void              *event_info);
261 static Eina_Bool _deselect_all_items(Widget_Data *wd);
262
263 static Evas_Smart_Class _pan_sc = EVAS_SMART_CLASS_INIT_VERSION;
264 static void _mirrored_set(Evas_Object *obj, Eina_Bool rtl);
265
266 static Eina_Bool
267 _event_hook(Evas_Object       *obj,
268             Evas_Object *src   __UNUSED__,
269             Evas_Callback_Type type,
270             void              *event_info)
271 {
272    if (type != EVAS_CALLBACK_KEY_DOWN) return EINA_FALSE;
273    Evas_Event_Key_Down *ev = event_info;
274    Widget_Data *wd = elm_widget_data_get(obj);
275    if (!wd) return EINA_FALSE;
276    if (!wd->items) return EINA_FALSE;
277    if (ev->event_flags & EVAS_EVENT_FLAG_ON_HOLD) return EINA_FALSE;
278    if (elm_widget_disabled_get(obj)) return EINA_FALSE;
279
280    Elm_Gengrid_Item *item = NULL;
281    Evas_Coord x = 0;
282    Evas_Coord y = 0;
283    Evas_Coord step_x = 0;
284    Evas_Coord step_y = 0;
285    Evas_Coord v_w = 0;
286    Evas_Coord v_h = 0;
287    Evas_Coord page_x = 0;
288    Evas_Coord page_y = 0;
289
290    elm_smart_scroller_child_pos_get(wd->scr, &x, &y);
291    elm_smart_scroller_step_size_get(wd->scr, &step_x, &step_y);
292    elm_smart_scroller_page_size_get(wd->scr, &page_x, &page_y);
293    elm_smart_scroller_child_viewport_size_get(wd->scr, &v_w, &v_h);
294
295    if ((!strcmp(ev->keyname, "Left")) || (!strcmp(ev->keyname, "KP_Left")))
296      {
297         if ((wd->horizontal) &&
298             (((evas_key_modifier_is_set(ev->modifiers, "Shift")) &&
299               (_item_multi_select_up(wd)))
300              || (_item_single_select_up(wd))))
301           {
302              ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
303              return EINA_TRUE;
304           }
305         else if ((!wd->horizontal) &&
306                  (((evas_key_modifier_is_set(ev->modifiers, "Shift")) &&
307                    (_item_multi_select_left(wd)))
308                   || (_item_single_select_left(wd))))
309           {
310              ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
311              return EINA_TRUE;
312           }
313         else
314           x -= step_x;
315      }
316    else if ((!strcmp(ev->keyname, "Right")) || (!strcmp(ev->keyname, "KP_Right")))
317      {
318         if ((wd->horizontal) &&
319             (((evas_key_modifier_is_set(ev->modifiers, "Shift")) &&
320               (_item_multi_select_down(wd)))
321              || (_item_single_select_down(wd))))
322           {
323              ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
324              return EINA_TRUE;
325           }
326         else if ((!wd->horizontal) &&
327                  (((evas_key_modifier_is_set(ev->modifiers, "Shift")) &&
328                    (_item_multi_select_right(wd)))
329                   || (_item_single_select_right(wd))))
330           {
331              ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
332              return EINA_TRUE;
333           }
334         else
335           x += step_x;
336      }
337    else if ((!strcmp(ev->keyname, "Up")) || (!strcmp(ev->keyname, "KP_Up")))
338      {
339         if ((wd->horizontal) &&
340             (((evas_key_modifier_is_set(ev->modifiers, "Shift")) &&
341               (_item_multi_select_left(wd)))
342              || (_item_single_select_left(wd))))
343           {
344              ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
345              return EINA_TRUE;
346           }
347         else if ((!wd->horizontal) &&
348                  (((evas_key_modifier_is_set(ev->modifiers, "Shift")) &&
349                    (_item_multi_select_up(wd)))
350                   || (_item_single_select_up(wd))))
351           {
352              ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
353              return EINA_TRUE;
354           }
355         else
356           y -= step_y;
357      }
358    else if ((!strcmp(ev->keyname, "Down")) || (!strcmp(ev->keyname, "KP_Down")))
359      {
360         if ((wd->horizontal) &&
361             (((evas_key_modifier_is_set(ev->modifiers, "Shift")) &&
362               (_item_multi_select_right(wd)))
363              || (_item_single_select_right(wd))))
364           {
365              ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
366              return EINA_TRUE;
367           }
368         else if ((!wd->horizontal) &&
369                  (((evas_key_modifier_is_set(ev->modifiers, "Shift")) &&
370                    (_item_multi_select_down(wd)))
371                   || (_item_single_select_down(wd))))
372           {
373              ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
374              return EINA_TRUE;
375           }
376         else
377           y += step_y;
378      }
379    else if ((!strcmp(ev->keyname, "Home")) || (!strcmp(ev->keyname, "KP_Home")))
380      {
381         item = elm_gengrid_first_item_get(obj);
382         elm_gengrid_item_bring_in(item);
383         ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
384         return EINA_TRUE;
385      }
386    else if ((!strcmp(ev->keyname, "End")) || (!strcmp(ev->keyname, "KP_End")))
387      {
388         item = elm_gengrid_last_item_get(obj);
389         elm_gengrid_item_bring_in(item);
390         ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
391         return EINA_TRUE;
392      }
393    else if ((!strcmp(ev->keyname, "Prior")) ||
394             (!strcmp(ev->keyname, "KP_Prior")))
395      {
396         if (wd->horizontal)
397           {
398              if (page_x < 0)
399                x -= -(page_x * v_w) / 100;
400              else
401                x -= page_x;
402           }
403         else
404           {
405              if (page_y < 0)
406                y -= -(page_y * v_h) / 100;
407              else
408                y -= page_y;
409           }
410      }
411    else if ((!strcmp(ev->keyname, "Next")) || (!strcmp(ev->keyname, "KP_Next")))
412      {
413         if (wd->horizontal)
414           {
415              if (page_x < 0)
416                x += -(page_x * v_w) / 100;
417              else
418                x += page_x;
419           }
420         else
421           {
422              if (page_y < 0)
423                y += -(page_y * v_h) / 100;
424              else
425                y += page_y;
426           }
427      }
428    else if (!strcmp(ev->keyname, "Escape"))
429      {
430         if (!_deselect_all_items(wd)) return EINA_FALSE;
431         ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
432         return EINA_TRUE;
433      }
434    else if ((!strcmp(ev->keyname, "Return")) ||
435             (!strcmp(ev->keyname, "KP_Enter")) ||
436             (!strcmp(ev->keyname, "space")))
437      {
438         item = elm_gengrid_selected_item_get(obj);
439         evas_object_smart_callback_call(item->wd->self, "clicked", item);
440      }
441    else return EINA_FALSE;
442
443    ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
444    elm_smart_scroller_child_pos_set(wd->scr, x, y);
445    return EINA_TRUE;
446 }
447
448 static Eina_Bool
449 _deselect_all_items(Widget_Data *wd)
450 {
451    if (!wd->selected) return EINA_FALSE;
452    while(wd->selected)
453      elm_gengrid_item_selected_set(wd->selected->data, EINA_FALSE);
454
455    return EINA_TRUE;
456 }
457
458 static Eina_Bool
459 _item_multi_select_left(Widget_Data *wd)
460 {
461    if (!wd->selected) return EINA_FALSE;
462
463    Elm_Gengrid_Item *prev = elm_gengrid_item_prev_get(wd->last_selected_item);
464    if (!prev) return EINA_TRUE;
465    if (elm_gengrid_item_selected_get(prev))
466      {
467         elm_gengrid_item_selected_set(wd->last_selected_item, EINA_FALSE);
468         wd->last_selected_item = prev;
469         elm_gengrid_item_show(wd->last_selected_item);
470      }
471    else
472      {
473         elm_gengrid_item_selected_set(prev, EINA_TRUE);
474         elm_gengrid_item_show(prev);
475      }
476
477    return EINA_TRUE;
478 }
479
480 static Eina_Bool
481 _item_multi_select_right(Widget_Data *wd)
482 {
483    if (!wd->selected) return EINA_FALSE;
484
485    Elm_Gengrid_Item *next = elm_gengrid_item_next_get(wd->last_selected_item);
486    if (!next) return EINA_TRUE;
487    if (elm_gengrid_item_selected_get(next))
488      {
489         elm_gengrid_item_selected_set(wd->last_selected_item, EINA_FALSE);
490         wd->last_selected_item = next;
491         elm_gengrid_item_show(wd->last_selected_item);
492      }
493    else
494      {
495         elm_gengrid_item_selected_set(next, EINA_TRUE);
496         elm_gengrid_item_show(next);
497      }
498
499    return EINA_TRUE;
500 }
501
502 static Eina_Bool
503 _item_multi_select_up(Widget_Data *wd)
504 {
505    unsigned int i;
506    Eina_Bool r = EINA_TRUE;
507
508    if (!wd->selected) return EINA_FALSE;
509
510    for (i = 0; (r) && (i < wd->nmax); i++)
511      r &= _item_multi_select_left(wd);
512
513    return r;
514 }
515
516 static Eina_Bool
517 _item_multi_select_down(Widget_Data *wd)
518 {
519    unsigned int i;
520    Eina_Bool r = EINA_TRUE;
521
522    if (!wd->selected) return EINA_FALSE;
523
524    for (i = 0; (r) && (i < wd->nmax); i++)
525      r &= _item_multi_select_right(wd);
526
527    return r;
528 }
529
530 static Eina_Bool
531 _item_single_select_up(Widget_Data *wd)
532 {
533    unsigned int i;
534
535    Elm_Gengrid_Item *prev;
536
537    if (!wd->selected)
538      {
539         prev = ELM_GENGRID_ITEM_FROM_INLIST(wd->items->last);
540         while ((prev) && (prev->delete_me))
541           prev = ELM_GENGRID_ITEM_FROM_INLIST(EINA_INLIST_GET(prev)->prev);
542         elm_gengrid_item_selected_set(prev, EINA_TRUE);
543         elm_gengrid_item_show(prev);
544         return EINA_TRUE;
545      }
546    else prev = elm_gengrid_item_prev_get(wd->last_selected_item);
547
548    if (!prev) return EINA_FALSE;
549
550    for (i = 1; i < wd->nmax; i++)
551      {
552         Elm_Gengrid_Item *tmp = elm_gengrid_item_prev_get(prev);
553         if (!tmp) return EINA_FALSE;
554         prev = tmp;
555      }
556
557    _deselect_all_items(wd);
558
559    elm_gengrid_item_selected_set(prev, EINA_TRUE);
560    elm_gengrid_item_show(prev);
561    return EINA_TRUE;
562 }
563
564 static Eina_Bool
565 _item_single_select_down(Widget_Data *wd)
566 {
567    unsigned int i;
568
569    Elm_Gengrid_Item *next;
570
571    if (!wd->selected)
572      {
573         next = ELM_GENGRID_ITEM_FROM_INLIST(wd->items);
574         while ((next) && (next->delete_me))
575           next = ELM_GENGRID_ITEM_FROM_INLIST(EINA_INLIST_GET(next)->next);
576         elm_gengrid_item_selected_set(next, EINA_TRUE);
577         elm_gengrid_item_show(next);
578         return EINA_TRUE;
579      }
580    else next = elm_gengrid_item_next_get(wd->last_selected_item);
581
582    if (!next) return EINA_FALSE;
583
584    for (i = 1; i < wd->nmax; i++)
585      {
586         Elm_Gengrid_Item *tmp = elm_gengrid_item_next_get(next);
587         if (!tmp) return EINA_FALSE;
588         next = tmp;
589      }
590
591    _deselect_all_items(wd);
592
593    elm_gengrid_item_selected_set(next, EINA_TRUE);
594    elm_gengrid_item_show(next);
595    return EINA_TRUE;
596 }
597
598 static Eina_Bool
599 _item_single_select_left(Widget_Data *wd)
600 {
601    Elm_Gengrid_Item *prev;
602    if (!wd->selected)
603      {
604         prev = ELM_GENGRID_ITEM_FROM_INLIST(wd->items->last);
605         while ((prev) && (prev->delete_me))
606           prev = ELM_GENGRID_ITEM_FROM_INLIST(EINA_INLIST_GET(prev)->prev);
607      }
608    else prev = elm_gengrid_item_prev_get(wd->last_selected_item);
609
610    if (!prev) return EINA_FALSE;
611
612    _deselect_all_items(wd);
613
614    elm_gengrid_item_selected_set(prev, EINA_TRUE);
615    elm_gengrid_item_show(prev);
616    return EINA_TRUE;
617 }
618
619 static Eina_Bool
620 _item_single_select_right(Widget_Data *wd)
621 {
622    Elm_Gengrid_Item *next;
623    if (!wd->selected)
624      {
625         next = ELM_GENGRID_ITEM_FROM_INLIST(wd->items);
626         while ((next) && (next->delete_me))
627           next = ELM_GENGRID_ITEM_FROM_INLIST(EINA_INLIST_GET(next)->next);
628      }
629    else next = elm_gengrid_item_next_get(wd->last_selected_item);
630
631    if (!next) return EINA_FALSE;
632
633    _deselect_all_items(wd);
634
635    elm_gengrid_item_selected_set(next, EINA_TRUE);
636    elm_gengrid_item_show(next);
637    return EINA_TRUE;
638 }
639
640 static void
641 _on_focus_hook(void *data   __UNUSED__,
642                Evas_Object *obj)
643 {
644    Widget_Data *wd = elm_widget_data_get(obj);
645    if (!wd) return;
646    if (elm_widget_focus_get(obj))
647      {
648         edje_object_signal_emit(wd->self, "elm,action,focus", "elm");
649         evas_object_focus_set(wd->self, EINA_TRUE);
650         if ((wd->selected) && (!wd->last_selected_item))
651           wd->last_selected_item = eina_list_data_get(wd->selected);
652      }
653    else
654      {
655         edje_object_signal_emit(wd->self, "elm,action,unfocus", "elm");
656         evas_object_focus_set(wd->self, EINA_FALSE);
657      }
658 }
659
660 static void
661 _mirrored_set(Evas_Object *obj, Eina_Bool rtl)
662 {
663    Widget_Data *wd = elm_widget_data_get(obj);
664    Elm_Gengrid_Item *item;
665    if (!wd) return;
666    elm_smart_scroller_mirrored_set(wd->scr, rtl);
667    if (!wd->items) return;
668    item = ELM_GENGRID_ITEM_FROM_INLIST(wd->items);
669
670    while (item)
671      {
672         edje_object_mirrored_set(item->base.view, rtl);
673         elm_gengrid_item_update(item);
674         item = ELM_GENGRID_ITEM_FROM_INLIST(EINA_INLIST_GET(item)->next);
675      }
676 }
677
678 static void
679 _theme_hook(Evas_Object *obj)
680 {
681    Widget_Data *wd = elm_widget_data_get(obj);
682    if (!wd) return;
683    _elm_widget_mirrored_reload(obj);
684    _mirrored_set(obj, elm_widget_mirrored_get(obj));
685    elm_smart_scroller_object_theme_set(obj, wd->scr, "gengrid", "base",
686                                        elm_widget_style_get(obj));
687 }
688
689 static void
690 _del_pre_hook(Evas_Object *obj)
691 {
692    Widget_Data *wd = elm_widget_data_get(obj);
693    if (!wd) return;
694    elm_gengrid_clear(obj);
695    evas_object_del(wd->pan_smart);
696    wd->pan_smart = NULL;
697 }
698
699 static void
700 _del_hook(Evas_Object *obj)
701 {
702    Widget_Data *wd = elm_widget_data_get(obj);
703    free(wd);
704 }
705
706 static void
707 _signal_emit_hook(Evas_Object *obj,
708                   const char  *emission,
709                   const char  *source)
710 {
711    Widget_Data *wd = elm_widget_data_get(obj);
712    if (!wd) return;
713    edje_object_signal_emit(elm_smart_scroller_edje_object_get(wd->scr),
714                            emission, source);
715 }
716
717 static void
718 _mouse_move(void        *data,
719             Evas *evas   __UNUSED__,
720             Evas_Object *obj,
721             void        *event_info)
722 {
723    Elm_Gengrid_Item *item = data;
724    Evas_Event_Mouse_Move *ev = event_info;
725    Evas_Coord minw = 0, minh = 0, x, y, dx, dy, adx, ady;
726
727    if (ev->event_flags & EVAS_EVENT_FLAG_ON_HOLD)
728      {
729         if (!item->wd->on_hold)
730           {
731              item->wd->on_hold = EINA_TRUE;
732              if (!item->wd->wasselected)
733                _item_unselect(item);
734           }
735      }
736    if ((item->dragging) && (item->down))
737      {
738         if (item->long_timer)
739           {
740              ecore_timer_del(item->long_timer);
741              item->long_timer = NULL;
742           }
743         evas_object_smart_callback_call(item->wd->self, "drag", item);
744         return;
745      }
746    if ((!item->down) || (item->wd->longpressed))
747      {
748         if (item->long_timer)
749           {
750              ecore_timer_del(item->long_timer);
751              item->long_timer = NULL;
752           }
753         return;
754      }
755    if (!item->display_only)
756      elm_coords_finger_size_adjust(1, &minw, 1, &minh);
757    evas_object_geometry_get(obj, &x, &y, NULL, NULL);
758    x = ev->cur.canvas.x - x;
759    y = ev->cur.canvas.y - y;
760    dx = x - item->dx;
761    adx = dx;
762    if (adx < 0) adx = -dx;
763    dy = y - item->dy;
764    ady = dy;
765    if (ady < 0) ady = -dy;
766    minw /= 2;
767    minh /= 2;
768    if ((adx > minw) || (ady > minh))
769      {
770         const char *left_drag, *right_drag;
771         if (!elm_widget_mirrored_get(item->wd->self))
772           {
773              left_drag = "drag,start,left";
774              right_drag = "drag,start,right";
775           }
776         else
777           {
778              left_drag = "drag,start,right";
779              right_drag = "drag,start,left";
780           }
781
782         item->dragging = 1;
783         if (item->long_timer)
784           {
785              ecore_timer_del(item->long_timer);
786              item->long_timer = NULL;
787           }
788         if (!item->wd->wasselected)
789           _item_unselect(item);
790         if (dy < 0)
791           {
792              if (ady > adx)
793                evas_object_smart_callback_call(item->wd->self, "drag,start,up",
794                                                item);
795              else
796                {
797                   if (dx < 0)
798                     evas_object_smart_callback_call(item->wd->self,
799                                                     left_drag, item);
800                }
801           }
802         else
803           {
804              if (ady > adx)
805                evas_object_smart_callback_call(item->wd->self,
806                                                "drag,start,down", item);
807              else
808                {
809                   if (dx < 0)
810                     evas_object_smart_callback_call(item->wd->self,
811                                                     left_drag, item);
812                   else
813                     evas_object_smart_callback_call(item->wd->self,
814                                                     right_drag, item);
815                }
816           }
817      }
818 }
819
820 static Eina_Bool
821 _long_press(void *data)
822 {
823    Elm_Gengrid_Item *item = data;
824
825    item->long_timer = NULL;
826    if ((item->disabled) || (item->dragging)) return ECORE_CALLBACK_CANCEL;
827    item->wd->longpressed = EINA_TRUE;
828    evas_object_smart_callback_call(item->wd->self, "longpressed", item);
829    return ECORE_CALLBACK_CANCEL;
830 }
831
832 static void
833 _mouse_down(void        *data,
834             Evas *evas   __UNUSED__,
835             Evas_Object *obj,
836             void        *event_info)
837 {
838    Elm_Gengrid_Item *item = data;
839    Evas_Event_Mouse_Down *ev = event_info;
840    Evas_Coord x, y;
841
842    if (ev->button != 1) return;
843    item->down = 1;
844    item->dragging = 0;
845    evas_object_geometry_get(obj, &x, &y, NULL, NULL);
846    item->dx = ev->canvas.x - x;
847    item->dy = ev->canvas.y - y;
848    item->wd->longpressed = EINA_FALSE;
849    if (ev->event_flags & EVAS_EVENT_FLAG_ON_HOLD) item->wd->on_hold = EINA_TRUE;
850    else item->wd->on_hold = EINA_FALSE;
851    item->wd->wasselected = item->selected;
852    _item_hilight(item);
853    if (ev->flags & EVAS_BUTTON_DOUBLE_CLICK)
854      evas_object_smart_callback_call(item->wd->self, "clicked", item);
855    if (item->long_timer) ecore_timer_del(item->long_timer);
856    if (item->realized)
857      item->long_timer = ecore_timer_add(_elm_config->longpress_timeout,
858                                         _long_press, item);
859    else
860      item->long_timer = NULL;
861 }
862
863 static void
864 _mouse_up(void            *data,
865           Evas *evas       __UNUSED__,
866           Evas_Object *obj __UNUSED__,
867           void            *event_info)
868 {
869    Elm_Gengrid_Item *item = data;
870    Evas_Event_Mouse_Up *ev = event_info;
871    Eina_Bool dragged = EINA_FALSE;
872
873    if (ev->button != 1) return;
874    item->down = EINA_FALSE;
875    if (ev->event_flags & EVAS_EVENT_FLAG_ON_HOLD) item->wd->on_hold = EINA_TRUE;
876    else item->wd->on_hold = EINA_FALSE;
877    if (item->long_timer)
878      {
879         ecore_timer_del(item->long_timer);
880         item->long_timer = NULL;
881      }
882    if (item->dragging)
883      {
884         item->dragging = EINA_FALSE;
885         evas_object_smart_callback_call(item->wd->self, "drag,stop", item);
886         dragged = EINA_TRUE;
887      }
888    if (item->wd->on_hold)
889      {
890         item->wd->longpressed = EINA_FALSE;
891         item->wd->on_hold = EINA_FALSE;
892         return;
893      }
894    if (item->wd->longpressed)
895      {
896         item->wd->longpressed = EINA_FALSE;
897         if (!item->wd->wasselected) _item_unselect(item);
898         item->wd->wasselected = EINA_FALSE;
899         return;
900      }
901    if (dragged)
902      {
903         if (item->want_unrealize) _item_unrealize(item);
904      }
905    if ((item->disabled) || (dragged)) return;
906    if (item->wd->multi)
907      {
908         if (!item->selected)
909           {
910              _item_hilight(item);
911              _item_select(item);
912           }
913         else _item_unselect(item);
914      }
915    else
916      {
917         if (!item->selected)
918           {
919              while (item->wd->selected)
920                _item_unselect(item->wd->selected->data);
921           }
922         else
923           {
924              const Eina_List *l, *l_next;
925              Elm_Gengrid_Item *item2;
926
927              EINA_LIST_FOREACH_SAFE(item->wd->selected, l, l_next, item2)
928                 if (item2 != item) _item_unselect(item2);
929           }
930         _item_hilight(item);
931         _item_select(item);
932      }
933 }
934
935 static void
936 _item_hilight(Elm_Gengrid_Item *item)
937 {
938    if ((item->wd->no_select) || (item->delete_me) || (item->hilighted)) return;
939    edje_object_signal_emit(item->base.view, "elm,state,selected", "elm");
940    item->hilighted = EINA_TRUE;
941 }
942
943 static void
944 _item_realize(Elm_Gengrid_Item *item)
945 {
946    char buf[1024];
947    char style[1024];
948
949    if ((item->realized) || (item->delete_me)) return;
950    item->base.view = edje_object_add(evas_object_evas_get(item->wd->self));
951    edje_object_scale_set(item->base.view, elm_widget_scale_get(item->wd->self) *
952                          _elm_config->scale);
953    edje_object_mirrored_set(item->base.view, elm_widget_mirrored_get(item->base.widget));
954    evas_object_smart_member_add(item->base.view, item->wd->pan_smart);
955    elm_widget_sub_object_add(item->wd->self, item->base.view);
956    snprintf(style, sizeof(style), "item/%s",
957             item->gic->item_style ? item->gic->item_style : "default");
958    _elm_theme_object_set(item->wd->self, item->base.view, "gengrid", style,
959                          elm_widget_style_get(item->wd->self));
960    item->spacer =
961       evas_object_rectangle_add(evas_object_evas_get(item->wd->self));
962    evas_object_color_set(item->spacer, 0, 0, 0, 0);
963    elm_widget_sub_object_add(item->wd->self, item->spacer);
964    evas_object_size_hint_min_set(item->spacer, 2 * _elm_config->scale, 1);
965    edje_object_part_swallow(item->base.view, "elm.swallow.pad", item->spacer);
966
967    if (item->gic->func.label_get)
968      {
969         const Eina_List *l;
970         const char *key;
971
972         item->labels =
973            elm_widget_stringlist_get(edje_object_data_get(item->base.view,
974                                                           "labels"));
975         EINA_LIST_FOREACH(item->labels, l, key)
976           {
977              char *s = item->gic->func.label_get
978                 ((void *)item->base.data, item->wd->self, l->data);
979              if (s)
980                {
981                   edje_object_part_text_set(item->base.view, l->data, s);
982                   free(s);
983                }
984           }
985      }
986
987    if (item->gic->func.icon_get)
988      {
989         const Eina_List *l;
990         const char *key;
991
992         item->icons =
993            elm_widget_stringlist_get(edje_object_data_get(item->base.view,
994                                                           "icons"));
995         EINA_LIST_FOREACH(item->icons, l, key)
996           {
997              Evas_Object *ic = item->gic->func.icon_get
998                 ((void *)item->base.data, item->wd->self, l->data);
999              if (ic)
1000                {
1001                   item->icon_objs = eina_list_append(item->icon_objs, ic);
1002                   edje_object_part_swallow(item->base.view, key, ic);
1003                   evas_object_show(ic);
1004                   elm_widget_sub_object_add(item->wd->self, ic);
1005                }
1006           }
1007      }
1008
1009    if (item->gic->func.state_get)
1010      {
1011         const Eina_List *l;
1012         const char *key;
1013
1014         item->states =
1015            elm_widget_stringlist_get(edje_object_data_get(item->base.view,
1016                                                           "states"));
1017         EINA_LIST_FOREACH(item->states, l, key)
1018           {
1019              Eina_Bool on = item->gic->func.state_get
1020                 ((void *)item->base.data, item->wd->self, l->data);
1021              if (on)
1022                {
1023                   snprintf(buf, sizeof(buf), "elm,state,%s,active", key);
1024                   edje_object_signal_emit(item->base.view, buf, "elm");
1025                }
1026           }
1027      }
1028
1029    if ((!item->wd->item_width) && (!item->wd->item_height))
1030      {
1031         edje_object_size_min_restricted_calc(item->base.view,
1032                                              &item->wd->item_width,
1033                                              &item->wd->item_height,
1034                                              item->wd->item_width,
1035                                              item->wd->item_height);
1036         elm_coords_finger_size_adjust(1, &item->wd->item_width,
1037                                       1, &item->wd->item_height);
1038      }
1039
1040    evas_object_event_callback_add(item->base.view, EVAS_CALLBACK_MOUSE_DOWN,
1041                                   _mouse_down, item);
1042    evas_object_event_callback_add(item->base.view, EVAS_CALLBACK_MOUSE_UP,
1043                                   _mouse_up, item);
1044    evas_object_event_callback_add(item->base.view, EVAS_CALLBACK_MOUSE_MOVE,
1045                                   _mouse_move, item);
1046
1047    if (item->selected)
1048      edje_object_signal_emit(item->base.view, "elm,state,selected", "elm");
1049    if (item->disabled)
1050      edje_object_signal_emit(item->base.view, "elm,state,disabled", "elm");
1051
1052    evas_object_show(item->base.view);
1053
1054    if (item->tooltip.content_cb)
1055      {
1056         elm_widget_item_tooltip_content_cb_set(item,
1057                                                item->tooltip.content_cb,
1058                                                item->tooltip.data, NULL);
1059         elm_widget_item_tooltip_style_set(item, item->tooltip.style);
1060      }
1061
1062    if (item->mouse_cursor)
1063      elm_widget_item_cursor_set(item, item->mouse_cursor);
1064
1065    item->realized = EINA_TRUE;
1066    item->want_unrealize = EINA_FALSE;
1067 }
1068
1069 static void
1070 _item_unrealize(Elm_Gengrid_Item *item)
1071 {
1072    Evas_Object *icon;
1073
1074    if (!item->realized) return;
1075    if (item->long_timer)
1076      {
1077         ecore_timer_del(item->long_timer);
1078         item->long_timer = NULL;
1079      }
1080    evas_object_del(item->base.view);
1081    item->base.view = NULL;
1082    evas_object_del(item->spacer);
1083    item->spacer = NULL;
1084    elm_widget_stringlist_free(item->labels);
1085    item->labels = NULL;
1086    elm_widget_stringlist_free(item->icons);
1087    item->icons = NULL;
1088    elm_widget_stringlist_free(item->states);
1089    item->states = NULL;
1090
1091    EINA_LIST_FREE(item->icon_objs, icon)
1092       evas_object_del(icon);
1093
1094    item->realized = EINA_FALSE;
1095    item->want_unrealize = EINA_FALSE;
1096 }
1097
1098 static void
1099 _item_place(Elm_Gengrid_Item *item,
1100             Evas_Coord        cx,
1101             Evas_Coord        cy)
1102 {
1103    Evas_Coord x, y, ox, oy, cvx, cvy, cvw, cvh;
1104    Evas_Coord tch, tcw, alignw = 0, alignh = 0, vw, vh;
1105    item->x = cx;
1106    item->y = cy;
1107    evas_object_geometry_get(item->wd->pan_smart, &ox, &oy, &vw, &vh);
1108
1109    /* Preload rows/columns at each side of the Gengrid */
1110    cvx = ox - PRELOAD * item->wd->item_width;
1111    cvy = oy - PRELOAD * item->wd->item_height;
1112    cvw = vw + 2 * PRELOAD * item->wd->item_width;
1113    cvh = vh + 2 * PRELOAD * item->wd->item_height;
1114
1115    alignh = 0;
1116    alignw = 0;
1117
1118    if (item->wd->horizontal)
1119      {
1120         int columns, items_visible = 0, items_row;
1121
1122         if (item->wd->item_height > 0)
1123           items_visible = vh / item->wd->item_height;
1124         if (items_visible < 1)
1125           items_visible = 1;
1126
1127         columns = item->wd->count / items_visible;
1128         if (item->wd->count % items_visible)
1129           columns++;
1130
1131         tcw = item->wd->item_width * columns;
1132         alignw = (vw - tcw) * item->wd->align_x;
1133
1134         items_row = items_visible;
1135         if (items_row > item->wd->count)
1136           items_row = item->wd->count;
1137         tch = items_row * item->wd->item_height;
1138         alignh = (vh - tch) * item->wd->align_y;
1139      }
1140    else
1141      {
1142         int rows, items_visible = 0, items_col;
1143
1144         if (item->wd->item_width > 0)
1145           items_visible = vw / item->wd->item_width;
1146         if (items_visible < 1)
1147           items_visible = 1;
1148
1149         rows = item->wd->count / items_visible;
1150         if (item->wd->count % items_visible)
1151           rows++;
1152
1153         tch = item->wd->item_height * rows;
1154         alignh = (vh - tch) * item->wd->align_y;
1155
1156         items_col = items_visible;
1157         if (items_col > item->wd->count)
1158           items_col = item->wd->count;
1159         tcw = items_col * item->wd->item_width;
1160         alignw = (vw - tcw) * item->wd->align_x;
1161      }
1162
1163    x = cx * item->wd->item_width - item->wd->pan_x + ox + alignw;
1164    if (elm_widget_mirrored_get(item->wd->self))
1165      {  /* Switch items side and componsate for pan_x when in RTL mode */
1166         Evas_Coord ww;
1167         evas_object_geometry_get(item->wd->self, NULL, NULL, &ww, NULL);
1168         x = ww - x - item->wd->item_width - item->wd->pan_x - item->wd->pan_x;
1169      }
1170
1171    y = cy * item->wd->item_height - item->wd->pan_y + oy + alignh;
1172
1173    Eina_Bool was_realized = item->realized;
1174    if (ELM_RECTS_INTERSECT(x, y, item->wd->item_width, item->wd->item_height,
1175                            cvx, cvy, cvw, cvh))
1176      {
1177         _item_realize(item);
1178         if (!was_realized)
1179           evas_object_smart_callback_call(item->wd->self, "realized", item);
1180         evas_object_move(item->base.view, x, y);
1181         evas_object_resize(item->base.view, item->wd->item_width,
1182                            item->wd->item_height);
1183      }
1184    else
1185      {
1186         _item_unrealize(item);
1187         if (was_realized)
1188           evas_object_smart_callback_call(item->wd->self, "unrealized", item);
1189      }
1190 }
1191
1192 static Elm_Gengrid_Item *
1193 _item_create(Widget_Data                  *wd,
1194              const Elm_Gengrid_Item_Class *gic,
1195              const void                   *data,
1196              Evas_Smart_Cb                 func,
1197              const void                   *func_data)
1198 {
1199    Elm_Gengrid_Item *item;
1200
1201    item = elm_widget_item_new(wd->self, Elm_Gengrid_Item);
1202    if (!item) return NULL;
1203    wd->count++;
1204    item->wd = wd;
1205    item->gic = gic;
1206    item->base.data = data;
1207    item->func.func = func;
1208    item->func.data = func_data;
1209    item->mouse_cursor = NULL;
1210    return item;
1211 }
1212
1213 static void
1214 _item_del(Elm_Gengrid_Item *item)
1215 {
1216    elm_widget_item_pre_notify_del(item);
1217    if (item->selected)
1218      item->wd->selected = eina_list_remove(item->wd->selected, item);
1219    if (item->realized) _item_unrealize(item);
1220    if ((!item->delete_me) && (item->gic->func.del))
1221      item->gic->func.del((void *)item->base.data, item->wd->self);
1222    item->delete_me = EINA_TRUE;
1223    item->wd->items = eina_inlist_remove(item->wd->items, EINA_INLIST_GET(item));
1224    if (item->long_timer) ecore_timer_del(item->long_timer);
1225    if (item->tooltip.del_cb)
1226      item->tooltip.del_cb((void *)item->tooltip.data, item->base.widget, item);
1227    item->wd->walking -= item->walking;
1228    item->wd->count--;
1229    if (item->wd->calc_job) ecore_job_del(item->wd->calc_job);
1230    item->wd->calc_job = ecore_job_add(_calc_job, item->wd);
1231    elm_widget_item_del(item);
1232 }
1233
1234 static void
1235 _item_select(Elm_Gengrid_Item *item)
1236 {
1237    if ((item->wd->no_select) || (item->delete_me)) return;
1238    if (item->selected)
1239      {
1240         if (item->wd->always_select) goto call;
1241         return;
1242      }
1243    item->selected = EINA_TRUE;
1244    item->wd->selected = eina_list_append(item->wd->selected, item);
1245 call:
1246    item->walking++;
1247    item->wd->walking++;
1248    if (item->func.func)
1249      item->func.func((void *)item->func.data, item->wd->self, item);
1250    if (!item->delete_me)
1251      evas_object_smart_callback_call(item->wd->self, "selected", item);
1252    item->walking--;
1253    item->wd->walking--;
1254    if ((item->wd->clear_me) && (!item->wd->walking))
1255      elm_gengrid_clear(item->base.widget);
1256    else
1257      {
1258         if ((!item->walking) && (item->delete_me))
1259           if (!item->relcount) _item_del(item);
1260      }
1261    item->wd->last_selected_item = item;
1262 }
1263
1264 static void
1265 _item_unselect(Elm_Gengrid_Item *item)
1266 {
1267    if ((item->delete_me) || (!item->hilighted)) return;
1268    edje_object_signal_emit(item->base.view, "elm,state,unselected", "elm");
1269    item->hilighted = EINA_FALSE;
1270    if (item->selected)
1271      {
1272         item->selected = EINA_FALSE;
1273         item->wd->selected = eina_list_remove(item->wd->selected, item);
1274         evas_object_smart_callback_call(item->wd->self, "unselected", item);
1275      }
1276 }
1277
1278 static void
1279 _calc_job(void *data)
1280 {
1281    Widget_Data *wd = data;
1282    Evas_Coord minw = 0, minh = 0, nmax = 0, cvw, cvh;
1283    int count;
1284
1285    evas_object_geometry_get(wd->pan_smart, NULL, NULL, &cvw, &cvh);
1286    if ((cvw != 0) || (cvh != 0))
1287      {
1288         if ((wd->horizontal) && (wd->item_height > 0))
1289           nmax = cvh / wd->item_height;
1290         else if (wd->item_width > 0)
1291           nmax = cvw / wd->item_width;
1292
1293         if (nmax < 1)
1294           nmax = 1;
1295
1296         count = wd->count;
1297         if (wd->horizontal)
1298           {
1299              minw = ceil(count / (float)nmax) * wd->item_width;
1300              minh = nmax * wd->item_height;
1301           }
1302         else
1303           {
1304              minw = nmax * wd->item_width;
1305              minh = ceil(count / (float)nmax) * wd->item_height;
1306           }
1307
1308         if ((minw != wd->minw) || (minh != wd->minh))
1309           {
1310              wd->minh = minh;
1311              wd->minw = minw;
1312              evas_object_smart_callback_call(wd->pan_smart, "changed", NULL);
1313           }
1314
1315         wd->nmax = nmax;
1316         wd->calc_job = NULL;
1317         evas_object_smart_changed(wd->pan_smart);
1318      }
1319 }
1320
1321 static void
1322 _pan_add(Evas_Object *obj)
1323 {
1324    Pan *sd;
1325    Evas_Object_Smart_Clipped_Data *cd;
1326
1327    _pan_sc.add(obj);
1328    cd = evas_object_smart_data_get(obj);
1329    sd = ELM_NEW(Pan);
1330    if (!sd) return;
1331    sd->__clipped_data = *cd;
1332    free(cd);
1333    evas_object_smart_data_set(obj, sd);
1334 }
1335
1336 static void
1337 _pan_del(Evas_Object *obj)
1338 {
1339    Pan *sd = evas_object_smart_data_get(obj);
1340
1341    if (!sd) return;
1342    _pan_sc.del(obj);
1343 }
1344
1345 static void
1346 _pan_set(Evas_Object *obj,
1347          Evas_Coord   x,
1348          Evas_Coord   y)
1349 {
1350    Pan *sd = evas_object_smart_data_get(obj);
1351    if ((x == sd->wd->pan_x) && (y == sd->wd->pan_y)) return;
1352    sd->wd->pan_x = x;
1353    sd->wd->pan_y = y;
1354    evas_object_smart_changed(obj);
1355 }
1356
1357 static void
1358 _pan_get(Evas_Object *obj,
1359          Evas_Coord  *x,
1360          Evas_Coord  *y)
1361 {
1362    Pan *sd = evas_object_smart_data_get(obj);
1363    if (x) *x = sd->wd->pan_x;
1364    if (y) *y = sd->wd->pan_y;
1365 }
1366
1367 static void
1368 _pan_child_size_get(Evas_Object *obj,
1369                     Evas_Coord  *w,
1370                     Evas_Coord  *h)
1371 {
1372    Pan *sd = evas_object_smart_data_get(obj);
1373    if (w) *w = sd->wd->minw;
1374    if (h) *h = sd->wd->minh;
1375 }
1376
1377 static void
1378 _pan_max_get(Evas_Object *obj,
1379              Evas_Coord  *x,
1380              Evas_Coord  *y)
1381 {
1382    Pan *sd = evas_object_smart_data_get(obj);
1383    Evas_Coord ow, oh;
1384
1385    if (!sd) return;
1386    evas_object_geometry_get(obj, NULL, NULL, &ow, &oh);
1387    if (x)
1388      *x = (ow < sd->wd->minw) ? sd->wd->minw - ow : 0;
1389    if (y)
1390      *y = (oh < sd->wd->minh) ? sd->wd->minh - oh : 0;
1391 }
1392
1393 static void
1394 _pan_min_get(Evas_Object *obj,
1395              Evas_Coord  *x,
1396              Evas_Coord  *y)
1397 {
1398    Pan *sd = evas_object_smart_data_get(obj);
1399    Evas_Coord mx, my;
1400
1401    if (!sd) return;
1402    _pan_max_get(obj, &mx, &my);
1403    if (x)
1404      *x = -mx * sd->wd->align_x;
1405    if (y)
1406      *y = -my * sd->wd->align_y;
1407 }
1408
1409 static void
1410 _pan_resize(Evas_Object *obj,
1411             Evas_Coord   w,
1412             Evas_Coord   h)
1413 {
1414    Pan *sd = evas_object_smart_data_get(obj);
1415    Evas_Coord ow, oh;
1416
1417    evas_object_geometry_get(obj, NULL, NULL, &ow, &oh);
1418    if ((ow == w) && (oh == h)) return;
1419    if (sd->wd->calc_job) ecore_job_del(sd->wd->calc_job);
1420    sd->wd->calc_job = ecore_job_add(_calc_job, sd->wd);
1421 }
1422
1423 static void
1424 _pan_calculate(Evas_Object *obj)
1425 {
1426    Pan *sd = evas_object_smart_data_get(obj);
1427    Evas_Coord cx = 0, cy = 0;
1428    Elm_Gengrid_Item *item;
1429
1430    if (!sd) return;
1431    if (!sd->wd->nmax) return;
1432
1433    EINA_INLIST_FOREACH(sd->wd->items, item)
1434      {
1435         _item_place(item, cx, cy);
1436         if (sd->wd->horizontal)
1437           {
1438              cy = (cy + 1) % sd->wd->nmax;
1439              if (!cy) cx++;
1440           }
1441         else
1442           {
1443              cx = (cx + 1) % sd->wd->nmax;
1444              if (!cx) cy++;
1445           }
1446      }
1447    evas_object_smart_callback_call(sd->wd->self, "changed", NULL);
1448 }
1449
1450 static void
1451 _pan_move(Evas_Object *obj,
1452           Evas_Coord x __UNUSED__,
1453           Evas_Coord y __UNUSED__)
1454 {
1455    Pan *sd = evas_object_smart_data_get(obj);
1456    if (!sd) return;
1457    if (sd->wd->calc_job) ecore_job_del(sd->wd->calc_job);
1458    sd->wd->calc_job = ecore_job_add(_calc_job, sd->wd);
1459 }
1460
1461 static void
1462 _hold_on(void *data       __UNUSED__,
1463          Evas_Object     *obj,
1464          void *event_info __UNUSED__)
1465 {
1466    Widget_Data *wd = elm_widget_data_get(obj);
1467    if (!wd) return;
1468    elm_smart_scroller_hold_set(wd->scr, 1);
1469 }
1470
1471 static void
1472 _hold_off(void *data       __UNUSED__,
1473           Evas_Object     *obj,
1474           void *event_info __UNUSED__)
1475 {
1476    Widget_Data *wd = elm_widget_data_get(obj);
1477    if (!wd) return;
1478    elm_smart_scroller_hold_set(wd->scr, 0);
1479 }
1480
1481 static void
1482 _freeze_on(void *data       __UNUSED__,
1483            Evas_Object     *obj,
1484            void *event_info __UNUSED__)
1485 {
1486    Widget_Data *wd = elm_widget_data_get(obj);
1487    if (!wd) return;
1488    elm_smart_scroller_freeze_set(wd->scr, 1);
1489 }
1490
1491 static void
1492 _freeze_off(void *data       __UNUSED__,
1493             Evas_Object     *obj,
1494             void *event_info __UNUSED__)
1495 {
1496    Widget_Data *wd = elm_widget_data_get(obj);
1497    if (!wd) return;
1498    elm_smart_scroller_freeze_set(wd->scr, 0);
1499 }
1500
1501 static void
1502 _scr_drag_start(void            *data,
1503                 Evas_Object *obj __UNUSED__,
1504                 void *event_info __UNUSED__)
1505 {
1506    evas_object_smart_callback_call(data, "scroll,drag,start", NULL);
1507 }
1508
1509 static void
1510 _scr_drag_stop(void            *data,
1511                Evas_Object *obj __UNUSED__,
1512                void *event_info __UNUSED__)
1513 {
1514    evas_object_smart_callback_call(data, "scroll,drag,stop", NULL);
1515 }
1516
1517 static void
1518 _scr_scroll(void            *data,
1519             Evas_Object *obj __UNUSED__,
1520             void *event_info __UNUSED__)
1521 {
1522    evas_object_smart_callback_call(data, "scroll", NULL);
1523 }
1524
1525 /**
1526  * Add a new Gengrid object.
1527  *
1528  * @param parent The parent object.
1529  * @return  The new object or NULL if it cannot be created.
1530  *
1531  * @see elm_gengrid_item_size_set()
1532  * @see elm_gengrid_horizontal_set()
1533  * @see elm_gengrid_item_append()
1534  * @see elm_gengrid_item_del()
1535  * @see elm_gengrid_clear()
1536  *
1537  * @ingroup Gengrid
1538  */
1539 EAPI Evas_Object *
1540 elm_gengrid_add(Evas_Object *parent)
1541 {
1542    Evas_Object *obj;
1543    Evas *e;
1544    Widget_Data *wd;
1545    static Evas_Smart *smart = NULL;
1546    Eina_Bool bounce = _elm_config->thumbscroll_bounce_enable;
1547
1548    ELM_WIDGET_STANDARD_SETUP(wd, Widget_Data, parent, e, obj, NULL);
1549
1550    ELM_SET_WIDTYPE(widtype, "gengrid");
1551    elm_widget_type_set(obj, "gengrid");
1552    elm_widget_sub_object_add(parent, obj);
1553    elm_widget_on_focus_hook_set(obj, _on_focus_hook, NULL);
1554    elm_widget_data_set(obj, wd);
1555    elm_widget_del_hook_set(obj, _del_hook);
1556    elm_widget_del_pre_hook_set(obj, _del_pre_hook);
1557    elm_widget_theme_hook_set(obj, _theme_hook);
1558    elm_widget_signal_emit_hook_set(obj, _signal_emit_hook);
1559    elm_widget_can_focus_set(obj, EINA_TRUE);
1560    elm_widget_event_hook_set(obj, _event_hook);
1561
1562    wd->scr = elm_smart_scroller_add(e);
1563    elm_smart_scroller_widget_set(wd->scr, obj);
1564    elm_smart_scroller_object_theme_set(obj, wd->scr, "gengrid", "base",
1565                                        "default");
1566    elm_widget_resize_object_set(obj, wd->scr);
1567
1568    evas_object_smart_callback_add(wd->scr, "drag,start", _scr_drag_start, obj);
1569    evas_object_smart_callback_add(wd->scr, "drag,stop", _scr_drag_stop, obj);
1570    evas_object_smart_callback_add(wd->scr, "scroll", _scr_scroll, obj);
1571
1572    elm_smart_scroller_bounce_allow_set(wd->scr, bounce, bounce);
1573
1574    wd->self = obj;
1575    wd->align_x = 0.5;
1576    wd->align_y = 0.5;
1577    wd->no_select = EINA_FALSE;
1578
1579    evas_object_smart_callback_add(obj, "scroll-hold-on", _hold_on, obj);
1580    evas_object_smart_callback_add(obj, "scroll-hold-off", _hold_off, obj);
1581    evas_object_smart_callback_add(obj, "scroll-freeze-on", _freeze_on, obj);
1582    evas_object_smart_callback_add(obj, "scroll-freeze-off", _freeze_off, obj);
1583
1584    if (!smart)
1585      {
1586         static Evas_Smart_Class sc;
1587
1588         evas_object_smart_clipped_smart_set(&_pan_sc);
1589         sc = _pan_sc;
1590         sc.name = "elm_gengrid_pan";
1591         sc.version = EVAS_SMART_CLASS_VERSION;
1592         sc.add = _pan_add;
1593         sc.del = _pan_del;
1594         sc.resize = _pan_resize;
1595         sc.move = _pan_move;
1596         sc.calculate = _pan_calculate;
1597         smart = evas_smart_class_new(&sc);
1598      }
1599    if (smart)
1600      {
1601         wd->pan_smart = evas_object_smart_add(e, smart);
1602         wd->pan = evas_object_smart_data_get(wd->pan_smart);
1603         wd->pan->wd = wd;
1604      }
1605
1606    elm_smart_scroller_extern_pan_set(wd->scr, wd->pan_smart,
1607                                      _pan_set, _pan_get, _pan_max_get,
1608                                      _pan_min_get, _pan_child_size_get);
1609
1610    _mirrored_set(obj, elm_widget_mirrored_get(obj));
1611    return obj;
1612 }
1613
1614 /**
1615  * Set the size for the item of the Gengrid.
1616  *
1617  * @param obj The Gengrid object.
1618  * @param w The item's width.
1619  * @param h The item's height;
1620  *
1621  * @see elm_gengrid_item_size_get()
1622  *
1623  * @ingroup Gengrid
1624  */
1625 EAPI void
1626 elm_gengrid_item_size_set(Evas_Object *obj,
1627                           Evas_Coord   w,
1628                           Evas_Coord   h)
1629 {
1630    ELM_CHECK_WIDTYPE(obj, widtype);
1631    Widget_Data *wd = elm_widget_data_get(obj);
1632    if (!wd) return;
1633    if ((wd->item_width == w) && (wd->item_height == h)) return;
1634    wd->item_width = w;
1635    wd->item_height = h;
1636    if (wd->calc_job) ecore_job_del(wd->calc_job);
1637    wd->calc_job = ecore_job_add(_calc_job, wd);
1638 }
1639
1640 /**
1641  * Get the size of the item of the Gengrid.
1642  *
1643  * @param obj The Gengrid object.
1644  * @param w Pointer to the item's width.
1645  * @param h Pointer to the item's height.
1646  *
1647  * @see elm_gengrid_item_size_get()
1648  *
1649  * @ingroup Gengrid
1650  */
1651 EAPI void
1652 elm_gengrid_item_size_get(const Evas_Object *obj,
1653                           Evas_Coord        *w,
1654                           Evas_Coord        *h)
1655 {
1656    ELM_CHECK_WIDTYPE(obj, widtype);
1657    Widget_Data *wd = elm_widget_data_get(obj);
1658    if (!wd) return;
1659    if (w) *w = wd->item_width;
1660    if (h) *h = wd->item_height;
1661 }
1662
1663 /**
1664  * Set item's alignment within the scroller.
1665  *
1666  * @param obj The Gengrid object.
1667  * @param align_x The x alignment (0 <= x <= 1).
1668  * @param align_y The y alignment (0 <= y <= 1).
1669  *
1670  * @see elm_gengrid_align_get()
1671  *
1672  * @ingroup Gengrid
1673  */
1674 EAPI void
1675 elm_gengrid_align_set(Evas_Object *obj,
1676                       double       align_x,
1677                       double       align_y)
1678 {
1679    ELM_CHECK_WIDTYPE(obj, widtype);
1680    Widget_Data *wd = elm_widget_data_get(obj);
1681
1682    if (align_x > 1.0)
1683      align_x = 1.0;
1684    else if (align_x < 0.0)
1685      align_x = 0.0;
1686    wd->align_x = align_x;
1687
1688    if (align_y > 1.0)
1689      align_y = 1.0;
1690    else if (align_y < 0.0)
1691      align_y = 0.0;
1692    wd->align_y = align_y;
1693 }
1694
1695 /**
1696  * Get the alignenment set for the Gengrid object.
1697  *
1698  * @param obj The Gengrid object.
1699  * @param align_x Pointer to x alignenment.
1700  * @param align_y Pointer to y alignenment.
1701  *
1702  * @see elm_gengrid_align_set()
1703  *
1704  * @ingroup Gengrid
1705  */
1706 EAPI void
1707 elm_gengrid_align_get(const Evas_Object *obj,
1708                       double            *align_x,
1709                       double            *align_y)
1710 {
1711    ELM_CHECK_WIDTYPE(obj, widtype);
1712    Widget_Data *wd = elm_widget_data_get(obj);
1713    if (align_x) *align_x = wd->align_x;
1714    if (align_y) *align_y = wd->align_y;
1715 }
1716
1717 /**
1718  * Add item to the end of the Gengrid.
1719  *
1720  * @param obj The Gengrid object.
1721  * @param gic The item class for the item.
1722  * @param data The item data.
1723  * @param func Convenience function called when item is selected.
1724  * @param func_data Data passed to @p func above.
1725  * @return A handle to the item added or NULL if not possible.
1726  *
1727  * @see elm_gengrid_item_prepend()
1728  * @see elm_gengrid_item_insert_before()
1729  * @see elm_gengrid_item_insert_after()
1730  * @see elm_gengrid_item_del()
1731  *
1732  * @ingroup Gengrid
1733  */
1734 EAPI Elm_Gengrid_Item *
1735 elm_gengrid_item_append(Evas_Object                  *obj,
1736                         const Elm_Gengrid_Item_Class *gic,
1737                         const void                   *data,
1738                         Evas_Smart_Cb                 func,
1739                         const void                   *func_data)
1740 {
1741    Elm_Gengrid_Item *item;
1742    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
1743    Widget_Data *wd = elm_widget_data_get(obj);
1744    if (!wd) return NULL;
1745
1746    item = _item_create(wd, gic, data, func, func_data);
1747    if (!item) return NULL;
1748    wd->items = eina_inlist_append(wd->items, EINA_INLIST_GET(item));
1749
1750    if (wd->calc_job) ecore_job_del(wd->calc_job);
1751    wd->calc_job = ecore_job_add(_calc_job, wd);
1752
1753    return item;
1754 }
1755
1756 /**
1757  * Add item at start of the Gengrid.
1758  *
1759  * This adds an item to the beginning of the grid.
1760  *
1761  * @param obj The Gengrid object.
1762  * @param gic The item class for the item.
1763  * @param data The item data.
1764  * @param func Convenience function called when item is selected.
1765  * @param func_data Data passed to @p func above.
1766  * @return A handle to the item added or NULL if not possible.
1767  *
1768  * @see elm_gengrid_item_append()
1769  * @see elm_gengrid_item_insert_before()
1770  * @see elm_gengrid_item_insert_after()
1771  * @see elm_gengrid_item_del()
1772  *
1773  * @ingroup Gengrid
1774  */
1775 EAPI Elm_Gengrid_Item *
1776 elm_gengrid_item_prepend(Evas_Object                  *obj,
1777                          const Elm_Gengrid_Item_Class *gic,
1778                          const void                   *data,
1779                          Evas_Smart_Cb                 func,
1780                          const void                   *func_data)
1781 {
1782    Elm_Gengrid_Item *item;
1783    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
1784    Widget_Data *wd = elm_widget_data_get(obj);
1785    if (!wd) return NULL;
1786
1787    item = _item_create(wd, gic, data, func, func_data);
1788    if (!item) return NULL;
1789    wd->items = eina_inlist_prepend(wd->items, EINA_INLIST_GET(item));
1790
1791    if (wd->calc_job) ecore_job_del(wd->calc_job);
1792    wd->calc_job = ecore_job_add(_calc_job, wd);
1793
1794    return item;
1795 }
1796
1797 /**
1798  * Insert and item before another in the Gengrid.
1799  *
1800  * This inserts an item before another in the grid.
1801  *
1802  * @param obj The Gengrid object.
1803  * @param gic The item class for the item.
1804  * @param data The item data.
1805  * @param relative The item to which insert before.
1806  * @param func Convenience function called when item is selected.
1807  * @param func_data Data passed to @p func above.
1808  * @return A handle to the item added or NULL if not possible.
1809  *
1810  * @see elm_gengrid_item_append()
1811  * @see elm_gengrid_item_prepend()
1812  * @see elm_gengrid_item_insert_after()
1813  * @see elm_gengrid_item_del()
1814  *
1815  * @ingroup Gengrid
1816  */
1817 EAPI Elm_Gengrid_Item *
1818 elm_gengrid_item_insert_before(Evas_Object                  *obj,
1819                                const Elm_Gengrid_Item_Class *gic,
1820                                const void                   *data,
1821                                Elm_Gengrid_Item             *relative,
1822                                Evas_Smart_Cb                 func,
1823                                const void                   *func_data)
1824 {
1825    Elm_Gengrid_Item *item;
1826    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
1827    EINA_SAFETY_ON_NULL_RETURN_VAL(relative, NULL);
1828    Widget_Data *wd = elm_widget_data_get(obj);
1829    if (!wd) return NULL;
1830
1831    item = _item_create(wd, gic, data, func, func_data);
1832    if (!item) return NULL;
1833    wd->items = eina_inlist_prepend_relative
1834       (wd->items, EINA_INLIST_GET(item), EINA_INLIST_GET(relative));
1835
1836    if (wd->calc_job) ecore_job_del(wd->calc_job);
1837    wd->calc_job = ecore_job_add(_calc_job, wd);
1838
1839    return item;
1840 }
1841
1842 /**
1843  * Insert and item after another in the Gengrid.
1844  *
1845  * This inserts an item after another in the grid.
1846  *
1847  * @param obj The Gengrid object.
1848  * @param gic The item class for the item.
1849  * @param data The item data.
1850  * @param relative The item to which insert after.
1851  * @param func Convenience function called when item is selected.
1852  * @param func_data Data passed to @p func above.
1853  * @return A handle to the item added or NULL if not possible.
1854  *
1855  * @see elm_gengrid_item_append()
1856  * @see elm_gengrid_item_prepend()
1857  * @see elm_gengrid_item_insert_before()
1858  * @see elm_gengrid_item_del()
1859  *
1860  * @ingroup Gengrid
1861  */
1862 EAPI Elm_Gengrid_Item *
1863 elm_gengrid_item_insert_after(Evas_Object                  *obj,
1864                               const Elm_Gengrid_Item_Class *gic,
1865                               const void                   *data,
1866                               Elm_Gengrid_Item             *relative,
1867                               Evas_Smart_Cb                 func,
1868                               const void                   *func_data)
1869 {
1870    Elm_Gengrid_Item *item;
1871    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
1872    EINA_SAFETY_ON_NULL_RETURN_VAL(relative, NULL);
1873    Widget_Data *wd = elm_widget_data_get(obj);
1874    if (!wd) return NULL;
1875
1876    item = _item_create(wd, gic, data, func, func_data);
1877    if (!item) return NULL;
1878    wd->items = eina_inlist_append_relative
1879       (wd->items, EINA_INLIST_GET(item), EINA_INLIST_GET(relative));
1880
1881    if (wd->calc_job) ecore_job_del(wd->calc_job);
1882    wd->calc_job = ecore_job_add(_calc_job, wd);
1883
1884    return item;
1885 }
1886
1887 /**
1888  * Remove a item from the Gengrid.
1889  *
1890  * @param item The item to be removed.
1891  * @return @c EINA_TRUE on success or @c EINA_FALSE otherwise.
1892  *
1893  * @see elm_gengrid_clear() to remove all items of the Gengrid.
1894  *
1895  * @ingroup Gengrid
1896  */
1897 EAPI void
1898 elm_gengrid_item_del(Elm_Gengrid_Item *item)
1899 {
1900    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
1901    if ((item->relcount > 0) || (item->walking > 0))
1902      {
1903         item->delete_me = EINA_TRUE;
1904         elm_widget_item_pre_notify_del(item);
1905         if (item->selected)
1906           item->wd->selected = eina_list_remove(item->wd->selected, item);
1907         if (item->gic->func.del)
1908           item->gic->func.del((void *)item->base.data, item->wd->self);
1909         return;
1910      }
1911
1912    _item_del(item);
1913 }
1914
1915 /**
1916  * Set for what direction the Gengrid will expand.
1917  *
1918  * @param obj The Gengrid object.
1919  * @param setting If @c EINA_TRUE the Gengrid will expand horizontally
1920  * or vertically if @c EINA_FALSE.
1921  *
1922  * @ingroup Gengrid
1923  */
1924 EAPI void
1925 elm_gengrid_horizontal_set(Evas_Object *obj,
1926                            Eina_Bool    setting)
1927 {
1928    ELM_CHECK_WIDTYPE(obj, widtype);
1929    Widget_Data *wd = elm_widget_data_get(obj);
1930    if (!wd) return;
1931    if (setting == wd->horizontal) return;
1932    wd->horizontal = setting;
1933
1934    /* Update the items to conform to the new layout */
1935    if (wd->calc_job) ecore_job_del(wd->calc_job);
1936    wd->calc_job = ecore_job_add(_calc_job, wd);
1937 }
1938
1939 /**
1940  * Clear the Gengrid
1941  *
1942  * This clears all items in the Gengrid, leaving it empty.
1943  *
1944  * @param obj The Gengrid object.
1945  *
1946  * @see elm_gengrid_item_del() to remove just one item.
1947  *
1948  * @ingroup Gengrid
1949  */
1950 EAPI void
1951 elm_gengrid_clear(Evas_Object *obj)
1952 {
1953    ELM_CHECK_WIDTYPE(obj, widtype);
1954    Widget_Data *wd = elm_widget_data_get(obj);
1955    if (!wd) return;
1956
1957    if (wd->calc_job)
1958      {
1959         ecore_job_del(wd->calc_job);
1960         wd->calc_job = NULL;
1961      }
1962
1963    if (wd->walking > 0)
1964      {
1965         Elm_Gengrid_Item *item;
1966         wd->clear_me = 1;
1967         EINA_INLIST_FOREACH(wd->items, item)
1968            item->delete_me = 1;
1969         return;
1970      }
1971    wd->clear_me = 0;
1972    while (wd->items)
1973      {
1974         Elm_Gengrid_Item *item = ELM_GENGRID_ITEM_FROM_INLIST(wd->items);
1975
1976         wd->items = eina_inlist_remove(wd->items, wd->items);
1977         elm_widget_item_pre_notify_del(item);
1978         if (item->realized) _item_unrealize(item);
1979         if (item->gic->func.del)
1980           item->gic->func.del((void *)item->base.data, wd->self);
1981         if (item->long_timer) ecore_timer_del(item->long_timer);
1982         elm_widget_item_del(item);
1983      }
1984
1985    if (wd->selected)
1986      {
1987         eina_list_free(wd->selected);
1988         wd->selected = NULL;
1989      }
1990
1991    wd->pan_x = 0;
1992    wd->pan_y = 0;
1993    wd->minw = 0;
1994    wd->minh = 0;
1995    wd->count = 0;
1996    evas_object_size_hint_min_set(wd->pan_smart, wd->minw, wd->minh);
1997    evas_object_smart_callback_call(wd->pan_smart, "changed", NULL);
1998 }
1999
2000 /**
2001  * Get the real evas object of the Gengrid item
2002  *
2003  * This returns the actual evas object used for the specified Gengrid
2004  * item.  This may be NULL as it may not be created, and may be
2005  * deleted at any time by Gengrid. Do not modify this object (move,
2006  * resize, show, hide etc.) as Gengrid is controlling it. This
2007  * function is for querying, emitting custom signals or hooking lower
2008  * level callbacks for events. Do not delete this object under any
2009  * circumstances.
2010  *
2011  * @param item The Gengrid item.
2012  * @return the evas object associated to this item.
2013  *
2014  * @see elm_gengrid_item_data_get()
2015  *
2016  * @ingroup Gengrid
2017  */
2018 EAPI const Evas_Object *
2019 elm_gengrid_item_object_get(const Elm_Gengrid_Item *item)
2020 {
2021    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
2022    return item->base.view;
2023 }
2024
2025 /**
2026  * Update the contents of an item
2027  *
2028  * This updates an item by calling all the item class functions again
2029  * to get the icons, labels and states. Use this when the original
2030  * item data has changed and the changes are desired to be reflected.
2031  *
2032  * @param item The item
2033  *
2034  * @ingroup Gengrid
2035  */
2036 EAPI void
2037 elm_gengrid_item_update(Elm_Gengrid_Item *item)
2038 {
2039    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2040    if (!item->realized) return;
2041    if (item->want_unrealize) return;
2042    _item_unrealize(item);
2043    _item_realize(item);
2044    _item_place(item, item->x, item->y);
2045 }
2046
2047 /**
2048  * Returns the data associated to a item
2049  *
2050  * This returns the data value passed on the elm_gengrid_item_append()
2051  * and related item addition calls.
2052  *
2053  * @param item The Gengrid item.
2054  * @return the data associated to this item.
2055  *
2056  * @see elm_gengrid_item_append()
2057  * @see elm_gengrid_item_object_get()
2058  *
2059  * @ingroup Gengrid
2060  */
2061 EAPI void *
2062 elm_gengrid_item_data_get(const Elm_Gengrid_Item *item)
2063 {
2064    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
2065    return elm_widget_item_data_get(item);
2066 }
2067
2068 /**
2069  * Set the data item from the gengrid item
2070  *
2071  * This set the data value passed on the elm_gengrid_item_append() and
2072  * related item addition calls. This function will also call
2073  * elm_gengrid_item_update() so the item will be updated to reflect
2074  * the new data.
2075  *
2076  * @param item The item
2077  * @param data The new data pointer to set
2078  *
2079  * @ingroup Gengrid
2080  */
2081 EAPI void
2082 elm_gengrid_item_data_set(Elm_Gengrid_Item *item,
2083                           const void       *data)
2084 {
2085    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2086    elm_widget_item_data_set(item, data);
2087    elm_gengrid_item_update(item);
2088 }
2089
2090 /**
2091  * Get the item's coordinates.
2092  *
2093  * This returns the logical position of the item whithin the Gengrid.
2094  *
2095  * @param item The Gengrid item.
2096  * @param x The x-axis coordinate pointer.
2097  * @param y The y-axis coordinate pointer.
2098  *
2099  * @ingroup Gengrid
2100  */
2101 EAPI void
2102 elm_gengrid_item_pos_get(const Elm_Gengrid_Item *item,
2103                          unsigned int           *x,
2104                          unsigned int           *y)
2105 {
2106    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2107    if (x) *x = item->x;
2108    if (y) *y = item->y;
2109 }
2110
2111 /**
2112  * Enable or disable multi-select in the Gengrid.
2113  *
2114  * This enables (EINA_TRUE) or disables (EINA_FALSE) multi-select in
2115  * the Gengrid.  This allows more than 1 item to be selected.
2116  *
2117  * @param obj The Gengrid object.
2118  * @param multi Multi-select enabled/disabled
2119  *
2120  * @ingroup Gengrid
2121  */
2122 EAPI void
2123 elm_gengrid_multi_select_set(Evas_Object *obj,
2124                              Eina_Bool    multi)
2125 {
2126    ELM_CHECK_WIDTYPE(obj, widtype);
2127    Widget_Data *wd = elm_widget_data_get(obj);
2128    if (!wd) return;
2129    wd->multi = multi;
2130 }
2131
2132 /**
2133  * Get if multi-select in Gengrid is enabled or disabled
2134  *
2135  * @param obj The Gengrid object
2136  * @return Multi-select enable/disable
2137  * (EINA_TRUE = enabled / EINA_FALSE = disabled)
2138  *
2139  * @ingroup Gengrid
2140  */
2141 EAPI Eina_Bool
2142 elm_gengrid_multi_select_get(const Evas_Object *obj)
2143 {
2144    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
2145    Widget_Data *wd = elm_widget_data_get(obj);
2146    if (!wd) return EINA_FALSE;
2147    return wd->multi;
2148 }
2149
2150 /**
2151  * Get the selected item in the Gengrid
2152  *
2153  * This gets the selected item in the Gengrid (if multi-select is
2154  * enabled only the first item in the list is selected - which is not
2155  * very useful, so see elm_gengrid_selected_items_get() for when
2156  * multi-select is used).
2157  *
2158  * If no item is selected, NULL is returned.
2159  *
2160  * @param obj The Gengrid object.
2161  * @return The selected item, or NULL if none.
2162  *
2163  * @ingroup Gengrid
2164  */
2165 EAPI Elm_Gengrid_Item *
2166 elm_gengrid_selected_item_get(const Evas_Object *obj)
2167 {
2168    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
2169    Widget_Data *wd = elm_widget_data_get(obj);
2170    if (!wd) return NULL;
2171    if (wd->selected) return wd->selected->data;
2172    return NULL;
2173 }
2174
2175 /**
2176  * Get a list of selected items in the Gengrid.
2177  *
2178  * This returns a list of the selected items. This list pointer is
2179  * only valid so long as no items are selected or unselected (or
2180  * unselected implictly by deletion). The list contains
2181  * Elm_Gengrid_Item pointers.
2182  *
2183  * @param obj The Gengrid object.
2184  * @return The list of selected items, or NULL if none are selected.
2185  *
2186  * @ingroup Gengrid
2187  */
2188 EAPI const Eina_List *
2189 elm_gengrid_selected_items_get(const Evas_Object *obj)
2190 {
2191    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
2192    Widget_Data *wd = elm_widget_data_get(obj);
2193    if (!wd) return NULL;
2194    return wd->selected;
2195 }
2196
2197 /**
2198  * Set the selected state of a item.
2199  *
2200  * This sets the selected state of a item. If multi-select is not
2201  * enabled and selected is EINA_TRUE, previously selected items are
2202  * unselected.
2203  *
2204  * @param item The item
2205  * @param selected The selected state.
2206  *
2207  * @ingroup Gengrid
2208  */
2209 EAPI void
2210 elm_gengrid_item_selected_set(Elm_Gengrid_Item *item,
2211                               Eina_Bool         selected)
2212 {
2213    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2214    Widget_Data *wd = item->wd;
2215    if (!wd) return;
2216    if (item->delete_me) return;
2217    selected = !!selected;
2218    if (item->selected == selected) return;
2219
2220    if (selected)
2221      {
2222         if (!wd->multi)
2223           {
2224              while (wd->selected)
2225                _item_unselect(wd->selected->data);
2226           }
2227         _item_hilight(item);
2228         _item_select(item);
2229      }
2230    else
2231      _item_unselect(item);
2232 }
2233
2234 /**
2235  * Get the selected state of a item.
2236  *
2237  * This gets the selected state of a item (1 selected, 0 not selected).
2238  *
2239  * @param item The item
2240  * @return The selected state
2241  *
2242  * @ingroup Gengrid
2243  */
2244 EAPI Eina_Bool
2245 elm_gengrid_item_selected_get(const Elm_Gengrid_Item *item)
2246 {
2247    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, EINA_FALSE);
2248    return item->selected;
2249 }
2250
2251 /**
2252  * Sets the disabled state of a item.
2253  *
2254  * A disabled item cannot be selected or unselected. It will also
2255  * change appearance to disabled. This sets the disabled state (1
2256  * disabled, 0 not disabled).
2257  *
2258  * @param item The item
2259  * @param disabled The disabled state
2260  *
2261  * @ingroup Gengrid
2262  */
2263 EAPI void
2264 elm_gengrid_item_disabled_set(Elm_Gengrid_Item *item,
2265                               Eina_Bool         disabled)
2266 {
2267    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2268    if (item->disabled == disabled) return;
2269    if (item->delete_me) return;
2270    item->disabled = disabled;
2271    if (item->realized)
2272      {
2273         if (item->disabled)
2274           edje_object_signal_emit(item->base.view, "elm,state,disabled", "elm");
2275         else
2276           edje_object_signal_emit(item->base.view, "elm,state,enabled", "elm");
2277      }
2278 }
2279
2280 /**
2281  * Get the disabled state of a item.
2282  *
2283  * This gets the disabled state of the given item.
2284  *
2285  * @param item The item
2286  * @return The disabled state
2287  *
2288  * @ingroup Gengrid
2289  */
2290 EAPI Eina_Bool
2291 elm_gengrid_item_disabled_get(const Elm_Gengrid_Item *item)
2292 {
2293    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, EINA_FALSE);
2294    if (item->delete_me) return EINA_FALSE;
2295    return item->disabled;
2296 }
2297
2298 static Evas_Object *
2299 _elm_gengrid_item_label_create(void        *data,
2300                                Evas_Object *obj,
2301                                void *item   __UNUSED__)
2302 {
2303    Evas_Object *label = elm_label_add(obj);
2304    if (!label)
2305      return NULL;
2306    elm_object_style_set(label, "tooltip");
2307    elm_label_label_set(label, data);
2308    return label;
2309 }
2310
2311 static void
2312 _elm_gengrid_item_label_del_cb(void            *data,
2313                                Evas_Object *obj __UNUSED__,
2314                                void *event_info __UNUSED__)
2315 {
2316    eina_stringshare_del(data);
2317 }
2318
2319 /**
2320  * Set the text to be shown in the gengrid item.
2321  *
2322  * @param item Target item
2323  * @param text The text to set in the content
2324  *
2325  * Setup the text as tooltip to object. The item can have only one
2326  * tooltip, so any previous tooltip data is removed.
2327  *
2328  * @ingroup Gengrid
2329  */
2330 EAPI void
2331 elm_gengrid_item_tooltip_text_set(Elm_Gengrid_Item *item,
2332                                   const char       *text)
2333 {
2334    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2335    text = eina_stringshare_add(text);
2336    elm_gengrid_item_tooltip_content_cb_set(item, _elm_gengrid_item_label_create,
2337                                            text,
2338                                            _elm_gengrid_item_label_del_cb);
2339 }
2340
2341 /**
2342  * Set the content to be shown in the tooltip item
2343  *
2344  * Setup the tooltip to item. The item can have only one tooltip, so
2345  * any previous tooltip data is removed. @p func(with @p data) will be
2346  * called every time that need show the tooltip and it should return a
2347  * valid Evas_Object. This object is then managed fully by tooltip
2348  * system and is deleted when the tooltip is gone.
2349  *
2350  * @param item the gengrid item being attached a tooltip.
2351  * @param func the function used to create the tooltip contents.
2352  * @param data what to provide to @a func as callback data/context.
2353  * @param del_cb called when data is not needed anymore, either when
2354  *        another callback replaces @func, the tooltip is unset with
2355  *        elm_gengrid_item_tooltip_unset() or the owner @a item
2356  *        dies. This callback receives as the first parameter the
2357  *        given @a data, and @c event_info is the item.
2358  *
2359  * @ingroup Gengrid
2360  */
2361 EAPI void
2362 elm_gengrid_item_tooltip_content_cb_set(Elm_Gengrid_Item           *item,
2363                                         Elm_Tooltip_Item_Content_Cb func,
2364                                         const void                 *data,
2365                                         Evas_Smart_Cb               del_cb)
2366 {
2367    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_GOTO(item, error);
2368
2369    if ((item->tooltip.content_cb == func) && (item->tooltip.data == data))
2370      return;
2371
2372    if (item->tooltip.del_cb)
2373      item->tooltip.del_cb((void *)item->tooltip.data,
2374                           item->base.widget, item);
2375    item->tooltip.content_cb = func;
2376    item->tooltip.data = data;
2377    item->tooltip.del_cb = del_cb;
2378    if (item->base.view)
2379      {
2380         elm_widget_item_tooltip_content_cb_set(item,
2381                                                item->tooltip.content_cb,
2382                                                item->tooltip.data, NULL);
2383         elm_widget_item_tooltip_style_set(item, item->tooltip.style);
2384      }
2385
2386    return;
2387
2388 error:
2389    if (del_cb) del_cb((void *)data, NULL, NULL);
2390 }
2391
2392 /**
2393  * Unset tooltip from item
2394  *
2395  * @param item gengrid item to remove previously set tooltip.
2396  *
2397  * Remove tooltip from item. The callback provided as del_cb to
2398  * elm_gengrid_item_tooltip_content_cb_set() will be called to notify
2399  * it is not used anymore.
2400  *
2401  * @see elm_gengrid_item_tooltip_content_cb_set()
2402  *
2403  * @ingroup Gengrid
2404  */
2405 EAPI void
2406 elm_gengrid_item_tooltip_unset(Elm_Gengrid_Item *item)
2407 {
2408    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2409    if ((item->base.view) && (item->tooltip.content_cb))
2410      elm_widget_item_tooltip_unset(item);
2411
2412    if (item->tooltip.del_cb)
2413      item->tooltip.del_cb((void *)item->tooltip.data, item->base.widget, item);
2414    item->tooltip.del_cb = NULL;
2415    item->tooltip.content_cb = NULL;
2416    item->tooltip.data = NULL;
2417    if (item->tooltip.style)
2418      elm_gengrid_item_tooltip_style_set(item, NULL);
2419 }
2420
2421 /**
2422  * Sets a different style for this item tooltip.
2423  *
2424  * @note before you set a style you should define a tooltip with
2425  *       elm_gengrid_item_tooltip_content_cb_set() or
2426  *       elm_gengrid_item_tooltip_text_set()
2427  *
2428  * @param item gengrid item with tooltip already set.
2429  * @param style the theme style to use (default, transparent, ...)
2430  *
2431  * @ingroup Gengrid
2432  */
2433 EAPI void
2434 elm_gengrid_item_tooltip_style_set(Elm_Gengrid_Item *item,
2435                                    const char       *style)
2436 {
2437    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2438    eina_stringshare_replace(&item->tooltip.style, style);
2439    if (item->base.view) elm_widget_item_tooltip_style_set(item, style);
2440 }
2441
2442 /**
2443  * Get the style for this item tooltip.
2444  *
2445  * @param item gengrid item with tooltip already set.
2446  * @return style the theme style in use, defaults to "default". If the
2447  *         object does not have a tooltip set, then NULL is returned.
2448  *
2449  * @ingroup Gengrid
2450  */
2451 EAPI const char *
2452 elm_gengrid_item_tooltip_style_get(const Elm_Gengrid_Item *item)
2453 {
2454    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
2455    return item->tooltip.style;
2456 }
2457
2458 /**
2459  * Set the cursor to be shown when mouse is over the gengrid item
2460  *
2461  * @param item Target item
2462  * @param cursor the cursor name to be used.
2463  *
2464  * @see elm_object_cursor_set()
2465  * @ingroup Gengrid
2466  */
2467 EAPI void
2468 elm_gengrid_item_cursor_set(Elm_Gengrid_Item *item,
2469                             const char       *cursor)
2470 {
2471    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2472    eina_stringshare_replace(&item->mouse_cursor, cursor);
2473    if (item->base.view) elm_widget_item_cursor_set(item, cursor);
2474 }
2475
2476 /**
2477  * Get the cursor to be shown when mouse is over the gengrid item
2478  *
2479  * @param item gengrid item with cursor already set.
2480  * @return the cursor name.
2481  *
2482  * @ingroup Gengrid
2483  */
2484 EAPI const char *
2485 elm_gengrid_item_cursor_get(const Elm_Gengrid_Item *item)
2486 {
2487    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
2488    return elm_widget_item_cursor_get(item);
2489 }
2490
2491 /**
2492  * Unset the cursor to be shown when mouse is over the gengrid item
2493  *
2494  * @param item Target item
2495  *
2496  * @see elm_object_cursor_unset()
2497  * @ingroup Gengrid
2498  */
2499 EAPI void
2500 elm_gengrid_item_cursor_unset(Elm_Gengrid_Item *item)
2501 {
2502    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2503    if (!item->mouse_cursor)
2504      return;
2505
2506    if (item->base.view)
2507      elm_widget_item_cursor_unset(item);
2508
2509    eina_stringshare_del(item->mouse_cursor);
2510    item->mouse_cursor = NULL;
2511 }
2512
2513 /**
2514  * Sets a different style for this item cursor.
2515  *
2516  * @note before you set a style you should define a cursor with
2517  *       elm_gengrid_item_cursor_set()
2518  *
2519  * @param item gengrid item with cursor already set.
2520  * @param style the theme style to use (default, transparent, ...)
2521  *
2522  * @ingroup Gengrid
2523  */
2524 EAPI void
2525 elm_gengrid_item_cursor_style_set(Elm_Gengrid_Item *item,
2526                                   const char       *style)
2527 {
2528    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2529    elm_widget_item_cursor_style_set(item, style);
2530 }
2531
2532 /**
2533  * Get the style for this item cursor.
2534  *
2535  * @param item gengrid item with cursor already set.
2536  * @return style the theme style in use, defaults to "default". If the
2537  *         object does not have a cursor set, then NULL is returned.
2538  *
2539  * @ingroup Gengrid
2540  */
2541 EAPI const char *
2542 elm_gengrid_item_cursor_style_get(const Elm_Gengrid_Item *item)
2543 {
2544    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
2545    return elm_widget_item_cursor_style_get(item);
2546 }
2547
2548 /**
2549  * Set if the cursor set should be searched on the theme or should use
2550  * the provided by the engine, only.
2551  *
2552  * @note before you set if should look on theme you should define a
2553  * cursor with elm_object_cursor_set(). By default it will only look
2554  * for cursors provided by the engine.
2555  *
2556  * @param item widget item with cursor already set.
2557  * @param engine_only boolean to define it cursors should be looked
2558  * only between the provided by the engine or searched on widget's
2559  * theme as well.
2560  *
2561  * @ingroup Gengrid
2562  */
2563 EAPI void
2564 elm_gengrid_item_cursor_engine_only_set(Elm_Gengrid_Item *item,
2565                                         Eina_Bool         engine_only)
2566 {
2567    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2568    elm_widget_item_cursor_engine_only_set(item, engine_only);
2569 }
2570
2571 /**
2572  * Get the cursor engine only usage for this item cursor.
2573  *
2574  * @param item widget item with cursor already set.
2575  * @return engine_only boolean to define it cursors should be looked
2576  * only between the provided by the engine or searched on widget's
2577  * theme as well. If the object does not have a cursor set, then
2578  * EINA_FALSE is returned.
2579  *
2580  * @ingroup Gengrid
2581  */
2582 EAPI Eina_Bool
2583 elm_gengrid_item_cursor_engine_only_get(const Elm_Gengrid_Item *item)
2584 {
2585    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, EINA_FALSE);
2586    return elm_widget_item_cursor_engine_only_get(item);
2587 }
2588
2589 /**
2590  * Set the always select mode.
2591  *
2592  * Cells will only call their selection func and callback when first
2593  * becoming selected. Any further clicks will do nothing, unless you
2594  * enable always select with
2595  * elm_gengrid_always_select_mode_set(). This means even if selected,
2596  * every click will make the selected callbacks be called.
2597  *
2598  * @param obj The Gengrid object
2599  * @param always_select The always select mode (EINA_TRUE = on,
2600  * EINA_FALSE = off)
2601  *
2602  * @ingroup Gengrid
2603  */
2604 EAPI void
2605 elm_gengrid_always_select_mode_set(Evas_Object *obj,
2606                                    Eina_Bool    always_select)
2607 {
2608    ELM_CHECK_WIDTYPE(obj, widtype);
2609    Widget_Data *wd = elm_widget_data_get(obj);
2610    if (!wd) return;
2611    wd->always_select = always_select;
2612 }
2613
2614 /**
2615  * Get the always select mode.
2616  *
2617  * @param obj The Gengrid object.
2618  * @return The always select mode (EINA_TRUE = on, EINA_FALSE = off)
2619  *
2620  * @ingroup Gengrid
2621  */
2622 EAPI Eina_Bool
2623 elm_gengrid_always_select_mode_get(const Evas_Object *obj)
2624 {
2625    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
2626    Widget_Data *wd = elm_widget_data_get(obj);
2627    if (!wd) return EINA_FALSE;
2628    return wd->always_select;
2629 }
2630
2631 /**
2632  * Set no select mode.
2633  *
2634  * This will turn off the ability to select items entirely and they
2635  * will neither appear selected nor call selected callback functions.
2636  *
2637  * @param obj The Gengrid object
2638  * @param no_select The no select mode (EINA_TRUE = on, EINA_FALSE = off)
2639  *
2640  * @ingroup Gengrid
2641  */
2642 EAPI void
2643 elm_gengrid_no_select_mode_set(Evas_Object *obj,
2644                                Eina_Bool    no_select)
2645 {
2646    ELM_CHECK_WIDTYPE(obj, widtype);
2647    Widget_Data *wd = elm_widget_data_get(obj);
2648    if (!wd) return;
2649    wd->no_select = no_select;
2650 }
2651
2652 /**
2653  * Gets no select mode.
2654  *
2655  * @param obj The Gengrid object
2656  * @return The no select mode (EINA_TRUE = on, EINA_FALSE = off)
2657  *
2658  * @ingroup Gengrid
2659  */
2660 EAPI Eina_Bool
2661 elm_gengrid_no_select_mode_get(const Evas_Object *obj)
2662 {
2663    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
2664    Widget_Data *wd = elm_widget_data_get(obj);
2665    if (!wd) return EINA_FALSE;
2666    return wd->no_select;
2667 }
2668
2669 /**
2670  * Set bounce mode.
2671  *
2672  * This will enable or disable the scroller bounce mode for the
2673  * Gengrid. See elm_scroller_bounce_set() for details.
2674  *
2675  * @param obj The Gengrid object
2676  * @param h_bounce Allow bounce horizontally
2677  * @param v_bounce Allow bounce vertically
2678  *
2679  * @ingroup Gengrid
2680  */
2681 EAPI void
2682 elm_gengrid_bounce_set(Evas_Object *obj,
2683                        Eina_Bool    h_bounce,
2684                        Eina_Bool    v_bounce)
2685 {
2686    ELM_CHECK_WIDTYPE(obj, widtype);
2687    Widget_Data *wd = elm_widget_data_get(obj);
2688    if (!wd) return;
2689    elm_smart_scroller_bounce_allow_set(wd->scr, h_bounce, v_bounce);
2690 }
2691
2692 /**
2693  * Get the bounce mode
2694  *
2695  * @param obj The Gengrid object
2696  * @param h_bounce Allow bounce horizontally
2697  * @param v_bounce Allow bounce vertically
2698  *
2699  * @ingroup Gengrid
2700  */
2701 EAPI void
2702 elm_gengrid_bounce_get(const Evas_Object *obj,
2703                        Eina_Bool         *h_bounce,
2704                        Eina_Bool         *v_bounce)
2705 {
2706    ELM_CHECK_WIDTYPE(obj, widtype);
2707    Widget_Data *wd = elm_widget_data_get(obj);
2708    if (!wd) return;
2709    elm_smart_scroller_bounce_allow_get(wd->scr, h_bounce, v_bounce);
2710 }
2711
2712 /**
2713  * Get all items in the Gengrid.
2714  *
2715  * This returns a list of the Gengrid items. The list contains
2716  * Elm_Gengrid_Item pointers.
2717  *
2718  * @param obj The Gengrid object.
2719  * @return The list of items, or NULL if none.
2720  *
2721  * @ingroup Gengrid
2722  */
2723
2724 /**
2725  * Set gengrid scroll page size relative to viewport size.
2726  *
2727  * The gengrid scroller is capable of limiting scrolling by the user
2728  * to "pages" That is to jump by and only show a "whole page" at a
2729  * time as if the continuous area of the scroller content is split
2730  * into page sized pieces.  This sets the size of a page relative to
2731  * the viewport of the scroller. 1.0 is "1 viewport" is size
2732  * (horizontally or vertically). 0.0 turns it off in that axis. This
2733  * is mutually exclusive with page size (see
2734  * elm_gengrid_page_size_set() for more information). Likewise 0.5 is
2735  * "half a viewport". Sane usable valus are normally between 0.0 and
2736  * 1.0 including 1.0. If you only want 1 axis to be page "limited",
2737  * use 0.0 for the other axis.
2738  *
2739  * @param obj The gengrid object
2740  * @param h_pagerel The horizontal page relative size
2741  * @param v_pagerel The vertical page relative size
2742  *
2743  * @ingroup Gengrid
2744  */
2745 EAPI void
2746 elm_gengrid_page_relative_set(Evas_Object *obj,
2747                               double       h_pagerel,
2748                               double       v_pagerel)
2749 {
2750    Evas_Coord pagesize_h;
2751    Evas_Coord pagesize_v;
2752
2753    ELM_CHECK_WIDTYPE(obj, widtype);
2754    Widget_Data *wd = elm_widget_data_get(obj);
2755    if (!wd) return;
2756
2757    elm_smart_scroller_paging_get(wd->scr, NULL, NULL, &pagesize_h, &pagesize_v);
2758    elm_smart_scroller_paging_set(wd->scr, h_pagerel, v_pagerel, pagesize_h,
2759                                  pagesize_v);
2760 }
2761
2762 /**
2763  * Set gengrid scroll page size.
2764  *
2765  * See also elm_gengrid_page_relative_set(). This, instead of a page
2766  * size being relative to the viewport, sets it to an absolute fixed
2767  * value, with 0 turning it off for that axis.
2768  *
2769  * @param obj The gengrid object
2770  * @param h_pagesize The horizontal page size
2771  * @param v_pagesize The vertical page size
2772  *
2773  * @ingroup Gengrid
2774  */
2775 EAPI void
2776 elm_gengrid_page_size_set(Evas_Object *obj,
2777                           Evas_Coord   h_pagesize,
2778                           Evas_Coord   v_pagesize)
2779 {
2780    double pagerel_h;
2781    double pagerel_v;
2782
2783    ELM_CHECK_WIDTYPE(obj, widtype);
2784    Widget_Data *wd = elm_widget_data_get(obj);
2785    if (!wd) return;
2786    elm_smart_scroller_paging_get(wd->scr, &pagerel_h, &pagerel_v, NULL, NULL);
2787    elm_smart_scroller_paging_set(wd->scr, pagerel_h, pagerel_v, h_pagesize,
2788                                  v_pagesize);
2789 }
2790
2791 /**
2792  * Get the first item in the gengrid
2793  *
2794  * This returns the first item in the list.
2795  *
2796  * @param obj The gengrid object
2797  * @return The first item, or NULL if none
2798  *
2799  * @ingroup Gengrid
2800  */
2801 EAPI Elm_Gengrid_Item *
2802 elm_gengrid_first_item_get(const Evas_Object *obj)
2803 {
2804    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
2805    Widget_Data *wd = elm_widget_data_get(obj);
2806    if (!wd) return NULL;
2807    if (!wd->items) return NULL;
2808    Elm_Gengrid_Item *item = ELM_GENGRID_ITEM_FROM_INLIST(wd->items);
2809    while ((item) && (item->delete_me))
2810      item = ELM_GENGRID_ITEM_FROM_INLIST(EINA_INLIST_GET(item)->next);
2811    return item;
2812 }
2813
2814 /**
2815  * Get the last item in the gengrid
2816  *
2817  * This returns the last item in the list.
2818  *
2819  * @return The last item, or NULL if none
2820  *
2821  * @ingroup Gengrid
2822  */
2823 EAPI Elm_Gengrid_Item *
2824 elm_gengrid_last_item_get(const Evas_Object *obj)
2825 {
2826    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
2827    Widget_Data *wd = elm_widget_data_get(obj);
2828    if (!wd) return NULL;
2829    if (!wd->items) return NULL;
2830    Elm_Gengrid_Item *item = ELM_GENGRID_ITEM_FROM_INLIST(wd->items->last);
2831    while ((item) && (item->delete_me))
2832      item = ELM_GENGRID_ITEM_FROM_INLIST(EINA_INLIST_GET(item)->prev);
2833    return item;
2834 }
2835
2836 /**
2837  * Get the next item in the gengrid
2838  *
2839  * This returns the item after the item @p item.
2840  *
2841  * @param item The item
2842  * @return The item after @p item, or NULL if none
2843  *
2844  * @ingroup Gengrid
2845  */
2846 EAPI Elm_Gengrid_Item *
2847 elm_gengrid_item_next_get(const Elm_Gengrid_Item *item)
2848 {
2849    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
2850    while (item)
2851      {
2852         item = ELM_GENGRID_ITEM_FROM_INLIST(EINA_INLIST_GET(item)->next);
2853         if ((item) && (!item->delete_me)) break;
2854      }
2855    return (Elm_Gengrid_Item *)item;
2856 }
2857
2858 /**
2859  * Get the previous item in the gengrid
2860  *
2861  * This returns the item before the item @p item.
2862  *
2863  * @param item The item
2864  * @return The item before @p item, or NULL if none
2865  *
2866  * @ingroup Gengrid
2867  */
2868 EAPI Elm_Gengrid_Item *
2869 elm_gengrid_item_prev_get(const Elm_Gengrid_Item *item)
2870 {
2871    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
2872    while (item)
2873      {
2874         item = ELM_GENGRID_ITEM_FROM_INLIST(EINA_INLIST_GET(item)->prev);
2875         if ((item) && (!item->delete_me)) break;
2876      }
2877    return (Elm_Gengrid_Item *)item;
2878 }
2879
2880 /**
2881  * Get the gengrid object from an item
2882  *
2883  * This returns the gengrid object itself that an item belongs to.
2884  *
2885  * @param item The item
2886  * @return The gengrid object
2887  *
2888  * @ingroup Gengrid
2889  */
2890 EAPI Evas_Object *
2891 elm_gengrid_item_gengrid_get(const Elm_Gengrid_Item *item)
2892 {
2893    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
2894    return item->base.widget;
2895 }
2896
2897 /**
2898  * Show the given item
2899  *
2900  * This causes gengrid to jump to the given item @p item and show it
2901  * (by scrolling), if it is not fully visible.
2902  *
2903  * @param item The item
2904  *
2905  * @ingroup Gengrid
2906  */
2907 EAPI void
2908 elm_gengrid_item_show(Elm_Gengrid_Item *item)
2909 {
2910    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2911    Widget_Data *wd = elm_widget_data_get(item->wd->self);
2912    Evas_Coord minx = 0, miny = 0;
2913
2914    if (!wd) return;
2915    if ((!item) || (item->delete_me)) return;
2916    _pan_min_get(wd->pan_smart, &minx, &miny);
2917
2918    elm_smart_scroller_child_region_show(item->wd->scr,
2919                                         item->x * wd->item_width + minx,
2920                                         item->y * wd->item_height + miny,
2921                                         item->wd->item_width,
2922                                         item->wd->item_height);
2923 }
2924
2925 /**
2926  * Bring in the given item
2927  *
2928  * This causes gengrig to jump to the given item @p item and show it
2929  * (by scrolling), if it is not fully visible. This may use animation
2930  * to do so and take a period of time
2931  *
2932  * @param item The item
2933  *
2934  * @ingroup Gengrid
2935  */
2936 EAPI void
2937 elm_gengrid_item_bring_in(Elm_Gengrid_Item *item)
2938 {
2939    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
2940    if (item->delete_me) return;
2941
2942    Evas_Coord minx = 0, miny = 0;
2943    Widget_Data *wd = elm_widget_data_get(item->wd->self);
2944    if (!wd) return;
2945    _pan_min_get(wd->pan_smart, &minx, &miny);
2946
2947    elm_smart_scroller_region_bring_in(item->wd->scr,
2948                                       item->x * wd->item_width + minx,
2949                                       item->y * wd->item_height + miny,
2950                                       item->wd->item_width,
2951                                       item->wd->item_height);
2952 }