2 * vim:ts=8:sw=3:sts=8:noexpandtab:cino=>5n-3f0^-2{2
4 #include <Elementary.h>
8 * @defgroup Index Index
11 * An index object is a type of list that categorizes items in it
15 #define MIN_GRP_SIZE 2 //for symmetry it is 2, otherwise it can be 1 and zero have no meaning.
16 #define MIN_PIXEL_VALUE 1 //Min pixel value is highly dependent on touch sensitivity support.
17 #define MIN_OBJ_HEIGHT 24 //should be taken from .edc file.
18 typedef struct _Widget_Data Widget_Data;
20 typedef struct _PlacementPart PlacementPart;
25 Evas_Object *event[2];
26 Evas_Object *bx[2]; // 2 - for now all that's supported
27 Eina_List *items; // 1 list. yes N levels, but only 2 for now and # of items will be small
31 Eina_Bool level_active[2];
32 Eina_Bool horizontal : 1;
35 int max_supp_items_count;
36 int tot_items_count[2];
37 Evas_Coord pwidth, pheight;
38 int min_obj_height, max_grp_size;
41 const char *special_char;
42 int min_1st_level_obj_height;
45 struct _Elm_Index_Item
52 Eina_Bool selected : 1;
54 const char *vis_letter;
63 static const char *widtype = NULL;
65 static void _del_hook(Evas_Object *obj);
66 static void _theme_hook(Evas_Object *obj);
67 static void _sizing_eval(Evas_Object *obj);
68 static void _index_box_auto_fill(Evas_Object *obj, Evas_Object *box, int level);
69 static void _index_box_clear(Evas_Object *obj, Evas_Object *box, int level);
70 static void _item_free(Elm_Index_Item *it);
71 static void _index_process(Evas_Object *obj);
74 _del_hook(Evas_Object *obj)
76 Widget_Data *wd = elm_widget_data_get(obj);
78 Eina_List *l, *clear = NULL;
80 _index_box_clear(obj, wd->bx[wd->level], wd->level);
81 _index_box_clear(obj, wd->bx[0], 0);
82 EINA_LIST_FOREACH(wd->items, l, it) clear = eina_list_append(clear, it);
83 EINA_LIST_FREE(clear, it) _item_free(it);
84 if (wd->delay) ecore_timer_del(wd->delay);
89 _layout(Evas_Object *o, Evas_Object_Box_Data *priv, void *data)
91 Widget_Data *wd = data;
93 _els_box_layout(o, priv, wd->horizontal, 0); /* making box layout non homogenous */
97 _theme_hook(Evas_Object *obj)
99 Widget_Data *wd = elm_widget_data_get(obj);
101 _index_box_clear(obj, wd->bx[0], 0);
102 _index_box_clear(obj, wd->bx[1], 1);
104 _elm_theme_object_set(obj, wd->base, "index", "base/horizontal", elm_widget_style_get(obj));
106 _elm_theme_object_set(obj, wd->base, "index", "base/vertical", elm_widget_style_get(obj));
107 edje_object_part_swallow(wd->base, "elm.swallow.event.0", wd->event[0]);
108 edje_object_part_swallow(wd->base, "elm.swallow.index.0", wd->bx[0]);
109 if (edje_object_part_exists(wd->base, "elm.swallow.index.1"))
113 wd->bx[1] = evas_object_box_add(evas_object_evas_get(wd->base));
114 evas_object_box_layout_set(wd->bx[1], _layout, wd, NULL);
115 elm_widget_sub_object_add(obj, wd->bx[1]);
117 edje_object_part_swallow(wd->base, "elm.swallow.index.1", wd->bx[1]);
118 evas_object_show(wd->bx[1]);
122 evas_object_del(wd->bx[1]);
125 if (edje_object_part_exists(wd->base, "elm.swallow.event.1"))
129 Evas_Coord minw = 0, minh = 0;
131 wd->event[1] = evas_object_rectangle_add(evas_object_evas_get(wd->base));
132 evas_object_color_set(wd->event[1], 0, 0, 0, 0);
133 evas_object_size_hint_min_set(wd->event[1], minw, minh);
135 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
136 elm_widget_sub_object_add(obj, wd->event[1]);
138 edje_object_part_swallow(wd->base, "elm.swallow.event.1", wd->event[1]);
140 else if (wd->event[1])
142 evas_object_del(wd->event[1]);
145 edje_object_message_signal_process(wd->base);
146 edje_object_scale_set(wd->base, elm_widget_scale_get(obj) * _elm_config->scale);
148 _index_box_auto_fill(obj, wd->bx[0], 0);
151 _index_box_auto_fill(obj, wd->bx[1], 1);
155 _sizing_eval(Evas_Object *obj)
157 Widget_Data *wd = elm_widget_data_get(obj);
158 Evas_Coord minw = -1, minh = -1, maxw = -1, maxh = -1;
160 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
161 edje_object_size_min_restricted_calc(wd->base, &minw, &minh, minw, minh);
162 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
163 evas_object_size_hint_min_set(obj, minw, minh);
164 evas_object_size_hint_max_set(obj, maxw, maxh);
167 static Elm_Index_Item *
168 _item_new(Evas_Object *obj, const char *letter, const void *item)
170 Widget_Data *wd = elm_widget_data_get(obj);
172 if (!wd) return NULL;
173 it = calloc(1, sizeof(Elm_Index_Item));
174 if (!it) return NULL;
177 it->level = wd->level;
179 it->size = wd->min_obj_height;
181 it->size = wd->min_1st_level_obj_height;
184 it->letter = eina_stringshare_add(letter);
185 it->vis_letter = eina_stringshare_add(letter);
192 static Elm_Index_Item *
193 _item_find(Evas_Object *obj, const void *item)
195 Widget_Data *wd = elm_widget_data_get(obj);
198 if (!wd) return NULL;
199 EINA_LIST_FOREACH(wd->items, l, it)
200 if (it->data == item) return it;
205 _item_free(Elm_Index_Item *it)
207 Widget_Data *wd = elm_widget_data_get(it->obj);
209 wd->items = eina_list_remove(wd->items, it);
210 if (it->base) evas_object_del(it->base);
211 eina_stringshare_del(it->letter);
212 eina_stringshare_del(it->vis_letter);
216 // FIXME: always have index filled
218 _index_box_auto_fill(Evas_Object *obj, Evas_Object *box, int level)
220 Widget_Data *wd = elm_widget_data_get(obj);
223 Evas_Coord mw, mh, w, h;
226 if (wd->level_active[level]) return;
227 evas_object_geometry_get(box, NULL, NULL, &w, &h);
228 EINA_LIST_FOREACH(wd->items, l, it)
231 const char *stacking;
233 if (it->level != level) continue;
234 if(i > wd->max_supp_items_count) break;
236 o = edje_object_add(evas_object_evas_get(obj));
239 _elm_theme_object_set(obj, o, "index", "item_odd/vertical", "default");
241 _elm_theme_object_set(obj, o, "index", "item/vertical", "default");
243 edje_object_size_min_restricted_calc(o, &mw, &mh, 0, 0);
244 evas_object_size_hint_weight_set(o, 1.0, 1.0);
245 evas_object_size_hint_align_set(o, -1.0, -1.0);
246 edje_object_part_text_set(o, "elm.text", it->vis_letter);
247 evas_object_resize(o, mw, it->size);
248 evas_object_size_hint_min_set(o, mw, it->size);
249 evas_object_size_hint_max_set(o, mw, it->size);
250 elm_widget_sub_object_add(obj, o);
251 evas_object_box_append(box, o);
252 stacking = edje_object_data_get(o, "stacking");
255 if (!strcmp(stacking, "below")) evas_object_lower(o);
256 else if (!strcmp(stacking, "above")) evas_object_raise(o);
261 wd->tot_items_count[1] = i;
262 evas_object_smart_calculate(box); // force a calc so we know the size
263 evas_object_size_hint_min_get(box, &mw, &mh);
266 _index_box_clear(obj, box, level);
269 // FIXME: only i objects fit! try again. overflows right now
273 evas_object_smart_calculate(box);
274 wd->level_active[level] = 1;
278 _index_box_clear(Evas_Object *obj, Evas_Object *box __UNUSED__, int level)
280 Widget_Data *wd = elm_widget_data_get(obj);
284 if (!wd->level_active[level]) return;
285 EINA_LIST_FOREACH(wd->items, l, it)
287 if (!it->base) continue;
288 if (it->level != level) continue;
289 evas_object_del(it->base);
292 wd->level_active[level] = 0;
296 _delay_change(void *data)
298 Widget_Data *wd = elm_widget_data_get(data);
302 d = (void *)elm_index_item_selected_get(data, wd->level);
303 if (d) evas_object_smart_callback_call(data, "delay,changed", d);
308 _sel_eval(Evas_Object *obj, Evas_Coord evx, Evas_Coord evy)
310 Widget_Data *wd = elm_widget_data_get(obj);
311 Elm_Index_Item *it, *it_closest, *it_last;
313 Evas_Coord x, y, w, h, bx, by, bw, bh, xx, yy;
319 Eina_Bool change = EINA_FALSE;
320 char *label = NULL, *last = NULL;
323 for (i = 0; i <= wd->level; i++)
328 evas_object_geometry_get(wd->bx[i], &bx, &by, &bw, &bh);
329 dmin = (double)(wd->min_1st_level_obj_height*wd->tot_items_count[1])/(2*(double)bh);
330 dmax = 1.0-dmin-0.08;
331 EINA_LIST_FOREACH(wd->items, l, it)
333 if (!((it->level == i) && (it->base))) continue;
339 evas_object_geometry_get(it->base, &x, &y, &w, &h);
344 x = (x * x) + (y * y);
345 if ((x < dist) || (!it_closest))
348 cdv = (double)(xx - bx) / (double)bw;
350 cdv = (double)(yy - by) / (double)bh;
355 if ((i == 0) && (wd->level == 0))
357 if(cdv > dmax || cdv < dmin)
367 edje_object_part_drag_value_set(wd->base, "elm.dragable.index.1", cdv, cdvv);
371 edje_object_part_drag_value_set(wd->base, "elm.dragable.index.1", cdv, cdv);
374 if (it_closest) it_closest->selected = 1;
375 if (it_closest != it_last)
380 const char *stacking, *selectraise;
383 if(wd->level == it->level)
384 edje_object_signal_emit(it->base, "elm,state,inactive", "elm");
385 stacking = edje_object_data_get(it->base, "stacking");
386 selectraise = edje_object_data_get(it->base, "selectraise");
387 if ((selectraise) && (!strcmp(selectraise, "on")))
389 if ((stacking) && (!strcmp(stacking, "below")))
390 evas_object_lower(it->base);
395 const char *selectraise;
398 if(wd->level == it->level)
399 edje_object_signal_emit(it->base, "elm,state,active", "elm");
400 selectraise = edje_object_data_get(it->base, "selectraise");
401 if ((selectraise) && (!strcmp(selectraise, "on")))
402 evas_object_raise(it->base);
403 evas_object_smart_callback_call((void *)obj, "changed", (void *)it->data);
404 if (wd->delay) ecore_timer_del(wd->delay);
405 wd->delay = ecore_timer_add(0.2, _delay_change, obj);
412 last = strdup(it->letter);
415 if (!label) label = strdup(last);
418 label = realloc(label, strlen(label) + strlen(last) + 1);
422 last = strdup(it->letter);
426 if (!label) label = strdup("");
427 if (!last) last = strdup("");
433 edje_object_part_text_set(wd->base, "elm.text.body", last);
434 edje_object_signal_emit(wd->base, "hide_2nd_level", "");
437 if( wd->level == 1 && wd->level_active[1])
439 edje_object_part_text_set(wd->base, "elm.text", last);
440 edje_object_signal_emit(wd->base, "hide_first_level", "");
448 _wheel(void *data, Evas *e __UNUSED__, Evas_Object *o __UNUSED__, void *event_info __UNUSED__)
450 Widget_Data *wd = elm_widget_data_get(data);
451 // Evas_Event_Mouse_Wheel *ev = event_info;
452 // Evas_Object *obj = o;
457 _mouse_down(void *data, Evas *e __UNUSED__, Evas_Object *o __UNUSED__, void *event_info)
459 Widget_Data *wd = elm_widget_data_get(data);
460 Evas_Event_Mouse_Down *ev = event_info;
463 if (ev->button != 1) return;
465 evas_object_geometry_get(wd->base, &x, &y, NULL, NULL);
466 wd->dx = ev->canvas.x - x;
467 wd->dy = ev->canvas.y - y;
468 elm_index_active_set(data, 1);
469 _sel_eval(data, ev->canvas.x, ev->canvas.y);
470 edje_object_part_drag_value_set(wd->base, "elm.dragable.pointer", wd->dx, wd->dy);
474 _mouse_up(void *data, Evas *e __UNUSED__, Evas_Object *o __UNUSED__, void *event_info)
476 Widget_Data *wd = elm_widget_data_get(data);
477 Evas_Event_Mouse_Up *ev = event_info;
482 if (ev->button != 1) return;
483 if (wd->level == 1 && wd->delay) ecore_timer_del(wd->delay);
486 d = (void *)elm_index_item_selected_get(data, wd->level);
487 EINA_LIST_FOREACH(wd->items, l, it)
489 edje_object_signal_emit(it->base, "elm,state,inactive", "elm");
491 if (d) evas_object_smart_callback_call(data, "selected", d);
492 elm_index_active_set(data, 0);
493 edje_object_signal_emit(wd->base, "elm,state,level,0", "elm");
497 _mouse_move(void *data, Evas *e __UNUSED__, Evas_Object *o __UNUSED__, void *event_info)
499 Widget_Data *wd = elm_widget_data_get(data);
500 Evas_Event_Mouse_Move *ev = event_info;
501 Evas_Coord minw = 0, minh = 0, x, y, dx, dy, adx, ady;
505 if (!wd->down) return;
506 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
507 evas_object_geometry_get(wd->base, &x, &y, NULL, NULL);
508 x = ev->cur.canvas.x - x;
509 y = ev->cur.canvas.y - y;
512 if (adx < 0) adx = -dx;
515 if (ady < 0) ady = -dy;
516 edje_object_part_drag_value_set(wd->base, "elm.dragable.pointer", x, y);
527 snprintf(buf, sizeof(buf), "elm,state,level,%i", wd->level);
528 edje_object_signal_emit(wd->base, buf, "elm");
529 evas_object_smart_callback_call(data, "level,up", NULL);
537 snprintf(buf, sizeof(buf), "elm,state,level,%i", wd->level);
538 edje_object_signal_emit(wd->base, buf, "elm");
539 d = (void *)elm_index_item_selected_get(data, wd->level);
540 evas_object_smart_callback_call(data, "changed", d);
541 if (wd->delay) ecore_timer_del(wd->delay);
542 wd->delay = ecore_timer_add(0.2, _delay_change, data);
543 evas_object_smart_callback_call(data, "level,down", NULL);
547 _sel_eval(data, ev->cur.canvas.x, ev->cur.canvas.y);
550 _index_box_refill_job(void *data)
552 Widget_Data *wd = elm_widget_data_get((Evas_Object *)data);
558 evas_object_geometry_get(wd->base, NULL, NULL, &pw, &ph);
559 wd->scale_factor = elm_scale_get();
560 if ( wd->scale_factor == 0.0 ) {
561 wd->scale_factor = 1.0;
563 string = edje_object_data_get(wd->base, "min_obj_height");
565 wd->min_obj_height = (int) (atoi(string))*wd->scale_factor;
567 wd->min_obj_height = MIN_OBJ_HEIGHT*wd->scale_factor;
568 if(!wd->min_obj_height) return;
570 wd->max_grp_size = wd->min_obj_height - 2*MIN_GRP_SIZE;
571 wd->items_count = ph/wd->min_obj_height;
572 wd->max_supp_items_count = wd->max_grp_size*(int)((wd->items_count-1)*0.5)+wd->items_count;
574 if(pw != wd->pwidth && ph != wd->pheight)
579 elm_index_active_set(data, 1);
581 _index_box_clear((Evas_Object *)data, wd->bx[0], 0);
582 evas_object_smart_calculate( wd->bx[0]);
583 elm_index_item_go((Evas_Object *)data, wd->level);
589 static void _index_object_resize(void *data, Evas *e, Evas_Object *obj, void *event_info)
593 wd = elm_widget_data_get((Evas_Object *)data);
595 ecore_job_add(_index_box_refill_job, (Evas_Object *)data);
599 * Add a new index to the parent
601 * @param parent The parent object
602 * @return The new object or NULL if it cannot be created
607 elm_index_add(Evas_Object *parent)
613 Evas_Coord minw, minh;
615 wd = ELM_NEW(Widget_Data);
616 e = evas_object_evas_get(parent);
617 obj = elm_widget_add(e);
618 ELM_SET_WIDTYPE(widtype, "index");
619 elm_widget_type_set(obj, "index");
620 elm_widget_sub_object_add(parent, obj);
621 elm_widget_data_set(obj, wd);
622 elm_widget_del_hook_set(obj, _del_hook);
623 elm_widget_theme_hook_set(obj, _theme_hook);
625 wd->horizontal = EINA_FALSE;
626 wd->min_obj_height = 0;
627 wd->max_grp_size = 0;
629 wd->max_supp_items_count = 0;
630 wd->tot_items_count[0] = 0;
631 wd->tot_items_count[1] = 0;
632 wd->special_char = edje_object_data_get(wd->base, "special_char");
633 if(wd->special_char == NULL) wd->special_char = eina_stringshare_add("*");
635 wd->base = edje_object_add(e);
636 _elm_theme_object_set(obj, wd->base, "index", "base/vertical", "default");
637 elm_widget_resize_object_set(obj, wd->base);
639 o = evas_object_rectangle_add(e);
641 evas_object_color_set(o, 0, 0, 0, 0);
643 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
644 evas_object_size_hint_min_set(o, minw, minh);
645 edje_object_part_swallow(wd->base, "elm.swallow.event.0", o);
646 elm_widget_sub_object_add(obj, o);
647 evas_object_event_callback_add(obj, EVAS_CALLBACK_RESIZE, _index_object_resize, obj);
648 evas_object_event_callback_add(o, EVAS_CALLBACK_MOUSE_WHEEL, _wheel, obj);
649 evas_object_event_callback_add(o, EVAS_CALLBACK_MOUSE_DOWN, _mouse_down, obj);
650 evas_object_event_callback_add(o, EVAS_CALLBACK_MOUSE_UP, _mouse_up, obj);
651 evas_object_event_callback_add(o, EVAS_CALLBACK_MOUSE_MOVE, _mouse_move, obj);
653 if (edje_object_part_exists(wd->base, "elm.swallow.event.1"))
655 o = evas_object_rectangle_add(e);
657 evas_object_color_set(o, 0, 0, 0, 0);
658 evas_object_size_hint_min_set(o, minw, minh);
659 edje_object_part_swallow(wd->base, "elm.swallow.event.1", o);
660 elm_widget_sub_object_add(obj, o);
663 wd->bx[0] = evas_object_box_add(e);
664 evas_object_box_layout_set(wd->bx[0], _layout, wd, NULL);
665 elm_widget_sub_object_add(obj, wd->bx[0]);
666 edje_object_part_swallow(wd->base, "elm.swallow.index.0", wd->bx[0]);
667 evas_object_show(wd->bx[0]);
669 if (edje_object_part_exists(wd->base, "elm.swallow.index.1"))
671 wd->bx[1] = evas_object_box_add(e);
672 evas_object_box_layout_set(wd->bx[1], _layout, wd, NULL);
673 elm_widget_sub_object_add(obj, wd->bx[1]);
674 edje_object_part_swallow(wd->base, "elm.swallow.index.1", wd->bx[1]);
675 evas_object_show(wd->bx[1]);
679 wd->scale_factor = elm_scale_get();
680 if ( wd->scale_factor == 0.0 ) {
681 wd->scale_factor = 1.0;
683 string = edje_object_data_get(wd->base, "min_1st_level_obj_height");
685 wd->min_1st_level_obj_height = (int) (atoi(string))*wd->scale_factor;
687 wd->min_1st_level_obj_height = MIN_OBJ_HEIGHT*wd->scale_factor;
693 _group_count(Evas_Object *obj, int extraIndex, int adj_pos, int vis_pos)
695 Widget_Data *wd = elm_widget_data_get(obj);
697 int group_count = MIN_GRP_SIZE;
698 while(group_count <= wd->max_grp_size)
700 if(extraIndex <= wd->max_grp_size*adj_pos)
702 if(group_count*adj_pos>=extraIndex) return group_count;
705 return wd->max_grp_size;
707 group_count+=MIN_GRP_SIZE;
711 _index_process(Evas_Object *obj)
714 int j,i, group_count;
720 Widget_Data *wd = elm_widget_data_get(obj);
723 if(wd->items_count == 0) return;
725 const int adj_pos = (wd->items_count-1)*0.5;
726 if(wd->tot_items_count[wd->level] <= wd->max_supp_items_count)
727 n = wd->tot_items_count[wd->level];
729 n = wd->max_supp_items_count;
730 group_count = MIN_GRP_SIZE;
733 const int minh = wd->min_obj_height;
734 EINA_LIST_FOREACH(wd->items, l, it)
736 it->vis_letter = eina_stringshare_add(it->letter);
741 int N = wd->items_count;
748 if(extraIndex < 0) return;
750 group_count = _group_count(obj, extraIndex, adj_pos, N);
751 if(group_count <= 0) return;
753 PlacementPart place[adj_pos];
754 remainder = extraIndex%group_count;
755 numberofparts=(extraIndex/group_count)+(remainder == 0? 0: 1);
757 for(i=0;i<numberofparts; i++)
759 place[i].count=group_count+1;
760 count = (int)(((float)(i+1)/(float)(numberofparts+1))*N);
761 place[i].start= count +i*group_count-1;
764 place[numberofparts-1].count=remainder+1;
766 for(i=0;i<numberofparts;i++)
768 for(j=0;j<place[i].count; j++)
770 indx[((place[i].start)+j)]= MIN_PIXEL_VALUE;
772 indx[(place[i].start+(place[i].count)/2)] = minh-place[i].count+1;
775 EINA_LIST_FOREACH(wd->items, l, it)
777 int size = indx[count];
781 it->vis_letter = eina_stringshare_add(it->letter);
786 eina_stringshare_del(it->vis_letter);
787 it->vis_letter = eina_stringshare_add("");
791 eina_stringshare_del(it->vis_letter);
792 it->vis_letter = eina_stringshare_add(wd->special_char);
794 it->size = size*wd->scale_factor;
798 * Set the active state of the index programatically
800 * @param obj The index object
801 * @param active The active starte
806 elm_index_active_set(Evas_Object *obj, Eina_Bool active)
808 ELM_CHECK_WIDTYPE(obj, widtype);
809 Widget_Data *wd = elm_widget_data_get(obj);
811 if (wd->active == active) return;
816 _index_box_clear(obj, wd->bx[1], 1);
818 _index_box_auto_fill(obj, wd->bx[0], 0);
819 edje_object_signal_emit(wd->base, "elm,state,active", "elm");
822 edje_object_signal_emit(wd->base, "elm,state,inactive", "elm");
826 * Sets the level of the item.
828 * @param obj The index object.
829 * @param level To be documented.
834 elm_index_item_level_set(Evas_Object *obj, int level)
836 ELM_CHECK_WIDTYPE(obj, widtype);
837 Widget_Data *wd = elm_widget_data_get(obj);
839 if (wd->level == level) return;
844 * Gets the level of the item.
846 * @param obj The index object
851 elm_index_item_level_get(const Evas_Object *obj)
853 ELM_CHECK_WIDTYPE(obj, widtype) 0;
854 Widget_Data *wd = elm_widget_data_get(obj);
860 * Returns the selected item.
862 * @param obj The index object.
863 * @param level to be documented.
868 elm_index_item_selected_get(const Evas_Object *obj, int level)
870 ELM_CHECK_WIDTYPE(obj, widtype) NULL;
871 Widget_Data *wd = elm_widget_data_get(obj);
874 if (!wd) return NULL;
875 EINA_LIST_FOREACH(wd->items, l, it)
876 if ((it->selected) && (it->level == level)) return it->data;
881 * Appends a new item.
883 * @param obj The index object.
884 * @param letter Letter under which the item should be indexed
885 * @param item The item to put in the index
890 elm_index_item_append(Evas_Object *obj, const char *letter, const void *item)
892 ELM_CHECK_WIDTYPE(obj, widtype);
893 Widget_Data *wd = elm_widget_data_get(obj);
896 it = _item_new(obj, letter, item);
898 wd->items = eina_list_append(wd->items, it);
899 wd->tot_items_count[wd->level]++;
900 _index_box_clear(obj, wd->bx[wd->level], wd->level);
904 * Prepends a new item.
906 * @param obj The index object.
907 * @param letter Letter under which the item should be indexed
908 * @param item The item to put in the index
913 elm_index_item_prepend(Evas_Object *obj, const char *letter, const void *item)
915 ELM_CHECK_WIDTYPE(obj, widtype);
916 Widget_Data *wd = elm_widget_data_get(obj);
920 it = _item_new(obj, letter, item);
922 wd->items = eina_list_prepend(wd->items, it);
923 wd->tot_items_count[wd->level]++;
924 _index_box_clear(obj, wd->bx[wd->level], wd->level);
928 * Append an item after @p relative in letter @p letter.
930 * @param obj The index object
931 * @param letter Letter under which the item should be indexed
932 * @param item The item to put in the index
933 * @param relative The item to put @p item after
938 elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const void *relative)
940 ELM_CHECK_WIDTYPE(obj, widtype);
941 Widget_Data *wd = elm_widget_data_get(obj);
942 Elm_Index_Item *it, *it_rel;
946 elm_index_item_append(obj, letter, item);
947 wd->tot_items_count[wd->level]++;
950 it = _item_new(obj, letter, item);
951 it_rel = _item_find(obj, relative);
954 elm_index_item_append(obj, letter, item);
955 wd->tot_items_count[wd->level]++;
959 wd->items = eina_list_append_relative(wd->items, it, it_rel);
960 wd->tot_items_count[wd->level]++;
961 _index_box_clear(obj, wd->bx[wd->level], wd->level);
965 * Prepend an item before @p relative in letter @p letter.
967 * @param obj The index object
968 * @param letter Letter under which the item should be indexed
969 * @param item The item to put in the index
970 * @param relative The item to put @p item before
975 elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const void *relative)
977 ELM_CHECK_WIDTYPE(obj, widtype);
978 Widget_Data *wd = elm_widget_data_get(obj);
979 Elm_Index_Item *it, *it_rel;
983 elm_index_item_prepend(obj, letter, item);
984 wd->tot_items_count[wd->level]++;
987 it = _item_new(obj, letter, item);
988 it_rel = _item_find(obj, relative);
991 elm_index_item_append(obj, letter, item);
992 wd->tot_items_count[wd->level]++;
996 wd->items = eina_list_prepend_relative(wd->items, it, it_rel);
997 wd->tot_items_count[wd->level]++;
998 _index_box_clear(obj, wd->bx[wd->level], wd->level);
1002 * Insert a new @p item into the sorted index @p obj in @p letter.
1004 * @param obj The index object
1005 * @param letter Letter under which the item should be indexed
1006 * @param item The item to put in the index
1007 * @param cmp_func The function called for the sort of index items.
1008 * @param cmp_data_func The function called for the sort of the data. It will
1009 * be used when cmp_func return 0. It means the index item already exists.
1010 * So, to decide which data item should be pointed by the index item, a function
1011 * to compare them is needed. If this function is not provided, index items
1012 * will be duplicated. If cmp_data_func returns a non-negative value, the
1013 * previous index item data will be replaced by the inserted @p item. So
1014 * if the previous data need to be free, it should be done in this function,
1015 * because the reference will be lost.
1020 elm_index_item_sorted_insert(Evas_Object *obj, const char *letter, const void *item, Eina_Compare_Cb cmp_func, Eina_Compare_Cb cmp_data_func)
1022 ELM_CHECK_WIDTYPE(obj, widtype);
1023 Widget_Data *wd = elm_widget_data_get(obj);
1031 elm_index_item_append(obj, letter, item);
1035 it = _item_new(obj, letter, item);
1038 lnear = eina_list_search_sorted_near_list(wd->items, cmp_func, it, &cmp);
1040 wd->items = eina_list_append_relative_list(wd->items, it, lnear);
1042 wd->items = eina_list_prepend_relative_list(wd->items, it, lnear);
1045 /* If cmp_data_func is not provided, append a duplicated item */
1047 wd->items = eina_list_append_relative_list(wd->items, it, lnear);
1050 Elm_Index_Item *p_it = eina_list_data_get(lnear);
1051 if (cmp_data_func(p_it->data, it->data) >= 0)
1052 p_it->data = it->data;
1057 _index_box_clear(obj, wd->bx[wd->level], wd->level);
1061 * Remove an item from the index.
1063 * @param obj The index object
1064 * @param item The item to remove from the index
1069 elm_index_item_del(Evas_Object *obj, const void *item)
1071 ELM_CHECK_WIDTYPE(obj, widtype);
1072 Widget_Data *wd = elm_widget_data_get(obj);
1075 it = _item_find(obj, item);
1078 wd->tot_items_count[wd->level]--;
1079 _index_box_clear(obj, wd->bx[wd->level], wd->level);
1083 * Find an index item using item data.
1085 * @param obj The index object
1086 * @param item The item pointed by index item
1087 * @return The index item pointing to @p item
1091 EAPI Elm_Index_Item *
1092 elm_index_item_find(Evas_Object *obj, const void *item)
1094 ELM_CHECK_WIDTYPE(obj, widtype) NULL;
1095 Widget_Data *wd = elm_widget_data_get(obj);
1096 if (!wd) return NULL;
1097 return _item_find(obj, item);
1101 * Clears an index of its items.
1103 * @param obj The index object.
1108 elm_index_item_clear(Evas_Object *obj)
1110 ELM_CHECK_WIDTYPE(obj, widtype);
1111 Widget_Data *wd = elm_widget_data_get(obj);
1113 Eina_List *l, *clear = NULL;
1115 _index_box_clear(obj, wd->bx[wd->level], wd->level);
1116 EINA_LIST_FOREACH(wd->items, l, it)
1118 if (it->level != wd->level) continue;
1119 clear = eina_list_append(clear, it);
1121 EINA_LIST_FREE(clear, it) _item_free(it);
1125 * Go to item at @p level
1127 * @param obj The index object
1128 * @param level The index level
1133 elm_index_item_go(Evas_Object *obj, int level __UNUSED__)
1135 ELM_CHECK_WIDTYPE(obj, widtype);
1136 Widget_Data *wd = elm_widget_data_get(obj);
1139 _index_process(obj);
1140 _index_box_auto_fill(obj, wd->bx[0], 0);
1141 if (wd->level == 1) _index_box_auto_fill(obj, wd->bx[1], 1);
1145 * Returns the data associated with the item.
1147 * @param it The list item
1148 * @return The data associated with @p it
1153 elm_index_item_data_get(const Elm_Index_Item *it)
1155 if (!it) return NULL;
1156 return (void *)it->data;
1160 * Set the data item from the index item
1162 * This set a new data value.
1164 * @param it The item
1165 * @param data The new data pointer to set
1170 elm_index_item_data_set(Elm_Index_Item *it, const void *data)
1177 * Gets the letter of the item.
1179 * @param it The list item
1180 * @return The letter of @p it
1185 elm_index_item_letter_get(const Elm_Index_Item *it)
1187 if (!it) return NULL;