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", elm_widget_style_get(obj));
241 //_elm_theme_object_set(obj, o, "index", "item/vertical", "default");
242 _elm_theme_object_set(obj, o, "index", "item/vertical", elm_widget_style_get(obj));
243 edje_object_part_text_set(o, "elm.text", it->letter);
244 edje_object_size_min_restricted_calc(o, &mw, &mh, 0, 0);
245 evas_object_size_hint_weight_set(o, 1.0, 1.0);
246 evas_object_size_hint_align_set(o, -1.0, -1.0);
247 edje_object_part_text_set(o, "elm.text", it->vis_letter);
248 evas_object_resize(o, mw, it->size);
249 evas_object_size_hint_min_set(o, mw, it->size);
250 evas_object_size_hint_max_set(o, mw, it->size);
251 elm_widget_sub_object_add(obj, o);
252 evas_object_box_append(box, o);
253 stacking = edje_object_data_get(o, "stacking");
256 if (!strcmp(stacking, "below")) evas_object_lower(o);
257 else if (!strcmp(stacking, "above")) evas_object_raise(o);
262 wd->tot_items_count[1] = i;
263 evas_object_smart_calculate(box); // force a calc so we know the size
264 evas_object_size_hint_min_get(box, &mw, &mh);
267 _index_box_clear(obj, box, level);
270 // FIXME: only i objects fit! try again. overflows right now
274 evas_object_smart_calculate(box);
275 wd->level_active[level] = 1;
279 _index_box_clear(Evas_Object *obj, Evas_Object *box __UNUSED__, int level)
281 Widget_Data *wd = elm_widget_data_get(obj);
285 if (!wd->level_active[level]) return;
286 EINA_LIST_FOREACH(wd->items, l, it)
288 if (!it->base) continue;
289 if (it->level != level) continue;
290 evas_object_del(it->base);
293 wd->level_active[level] = 0;
297 _delay_change(void *data)
299 Widget_Data *wd = elm_widget_data_get(data);
301 if (!wd) return ECORE_CALLBACK_CANCEL;
303 d = (void *)elm_index_item_selected_get(data, wd->level);
304 if (d) evas_object_smart_callback_call(data, "delay,changed", d);
305 return ECORE_CALLBACK_CANCEL;
309 _sel_eval(Evas_Object *obj, Evas_Coord evx, Evas_Coord evy)
311 Widget_Data *wd = elm_widget_data_get(obj);
312 Elm_Index_Item *it, *it_closest, *it_last;
314 Evas_Coord x, y, w, h, bx, by, bw, bh, xx, yy;
320 Eina_Bool change = EINA_FALSE;
321 char *label = NULL, *last = NULL;
324 for (i = 0; i <= wd->level; i++)
329 evas_object_geometry_get(wd->bx[i], &bx, &by, &bw, &bh);
330 dmin = (double)(wd->min_1st_level_obj_height*wd->tot_items_count[1])/(2*(double)bh);
331 dmax = 1.0-dmin-0.08;
332 EINA_LIST_FOREACH(wd->items, l, it)
334 if (!((it->level == i) && (it->base))) continue;
340 evas_object_geometry_get(it->base, &x, &y, &w, &h);
345 x = (x * x) + (y * y);
346 if ((x < dist) || (!it_closest))
349 cdv = (double)(xx - bx) / (double)bw;
351 cdv = (double)(yy - by) / (double)bh;
356 if ((i == 0) && (wd->level == 0))
358 if(cdv > dmax || cdv < dmin)
368 edje_object_part_drag_value_set(wd->base, "elm.dragable.index.1", cdv, cdvv);
372 edje_object_part_drag_value_set(wd->base, "elm.dragable.index.1", cdv, cdv);
375 if (it_closest) it_closest->selected = 1;
376 if (it_closest != it_last)
381 const char *stacking, *selectraise;
384 if(wd->level == it->level)
385 edje_object_signal_emit(it->base, "elm,state,inactive", "elm");
386 stacking = edje_object_data_get(it->base, "stacking");
387 selectraise = edje_object_data_get(it->base, "selectraise");
388 if ((selectraise) && (!strcmp(selectraise, "on")))
390 if ((stacking) && (!strcmp(stacking, "below")))
391 evas_object_lower(it->base);
396 const char *selectraise;
399 if(wd->level == it->level)
400 edje_object_signal_emit(it->base, "elm,state,active", "elm");
401 selectraise = edje_object_data_get(it->base, "selectraise");
402 if ((selectraise) && (!strcmp(selectraise, "on")))
403 evas_object_raise(it->base);
404 evas_object_smart_callback_call((void *)obj, "changed", (void *)it->data);
405 if (wd->delay) ecore_timer_del(wd->delay);
406 wd->delay = ecore_timer_add(0.2, _delay_change, obj);
413 last = strdup(it->letter);
416 if (!label) label = strdup(last);
419 label = realloc(label, strlen(label) + strlen(last) + 1);
423 last = strdup(it->letter);
427 if (!label) label = strdup("");
428 if (!last) last = strdup("");
434 edje_object_part_text_set(wd->base, "elm.text.body", last);
435 edje_object_signal_emit(wd->base, "hide_2nd_level", "");
438 if( wd->level == 1 && wd->level_active[1])
440 edje_object_part_text_set(wd->base, "elm.text", last);
441 edje_object_signal_emit(wd->base, "hide_first_level", "");
449 _wheel(void *data, Evas *e __UNUSED__, Evas_Object *o __UNUSED__, void *event_info __UNUSED__)
451 Widget_Data *wd = elm_widget_data_get(data);
452 // Evas_Event_Mouse_Wheel *ev = event_info;
453 // Evas_Object *obj = o;
458 _mouse_down(void *data, Evas *e __UNUSED__, Evas_Object *o __UNUSED__, void *event_info)
460 Widget_Data *wd = elm_widget_data_get(data);
461 Evas_Event_Mouse_Down *ev = event_info;
464 if (ev->button != 1) return;
466 evas_object_geometry_get(wd->base, &x, &y, NULL, NULL);
467 wd->dx = ev->canvas.x - x;
468 wd->dy = ev->canvas.y - y;
469 elm_index_active_set(data, 1);
470 _sel_eval(data, ev->canvas.x, ev->canvas.y);
471 edje_object_part_drag_value_set(wd->base, "elm.dragable.pointer", wd->dx, wd->dy);
475 _mouse_up(void *data, Evas *e __UNUSED__, Evas_Object *o __UNUSED__, void *event_info)
477 Widget_Data *wd = elm_widget_data_get(data);
478 Evas_Event_Mouse_Up *ev = event_info;
483 if (ev->button != 1) return;
484 if (wd->level == 1 && wd->delay) ecore_timer_del(wd->delay);
487 d = (void *)elm_index_item_selected_get(data, wd->level);
488 EINA_LIST_FOREACH(wd->items, l, it)
490 edje_object_signal_emit(it->base, "elm,state,inactive", "elm");
492 if (d) evas_object_smart_callback_call(data, "selected", d);
493 elm_index_active_set(data, 0);
494 edje_object_signal_emit(wd->base, "elm,state,level,0", "elm");
498 _mouse_move(void *data, Evas *e __UNUSED__, Evas_Object *o __UNUSED__, void *event_info)
500 Widget_Data *wd = elm_widget_data_get(data);
501 Evas_Event_Mouse_Move *ev = event_info;
502 Evas_Coord minw = 0, minh = 0, x, y, dx, dy, adx, ady;
506 if (!wd->down) return;
507 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
508 evas_object_geometry_get(wd->base, &x, &y, NULL, NULL);
509 x = ev->cur.canvas.x - x;
510 y = ev->cur.canvas.y - y;
513 if (adx < 0) adx = -dx;
516 if (ady < 0) ady = -dy;
517 edje_object_part_drag_value_set(wd->base, "elm.dragable.pointer", x, y);
528 snprintf(buf, sizeof(buf), "elm,state,level,%i", wd->level);
529 edje_object_signal_emit(wd->base, buf, "elm");
530 evas_object_smart_callback_call(data, "level,up", NULL);
538 snprintf(buf, sizeof(buf), "elm,state,level,%i", wd->level);
539 edje_object_signal_emit(wd->base, buf, "elm");
540 d = (void *)elm_index_item_selected_get(data, wd->level);
541 evas_object_smart_callback_call(data, "changed", d);
542 if (wd->delay) ecore_timer_del(wd->delay);
543 wd->delay = ecore_timer_add(0.2, _delay_change, data);
544 evas_object_smart_callback_call(data, "level,down", NULL);
548 _sel_eval(data, ev->cur.canvas.x, ev->cur.canvas.y);
551 _index_box_refill_job(void *data)
553 Widget_Data *wd = elm_widget_data_get((Evas_Object *)data);
559 evas_object_geometry_get(wd->base, NULL, NULL, &pw, &ph);
560 wd->scale_factor = elm_scale_get();
561 if ( wd->scale_factor == 0.0 ) {
562 wd->scale_factor = 1.0;
564 string = edje_object_data_get(wd->base, "min_obj_height");
566 wd->min_obj_height = (int) (atoi(string))*wd->scale_factor;
568 wd->min_obj_height = MIN_OBJ_HEIGHT*wd->scale_factor;
569 if(!wd->min_obj_height) return;
571 wd->max_grp_size = wd->min_obj_height - 2*MIN_GRP_SIZE;
572 wd->items_count = ph/wd->min_obj_height;
573 wd->max_supp_items_count = wd->max_grp_size*(int)((wd->items_count-1)*0.5)+wd->items_count;
575 if(pw != wd->pwidth && ph != wd->pheight)
580 elm_index_active_set(data, 1);
582 _index_box_clear((Evas_Object *)data, wd->bx[0], 0);
583 evas_object_smart_calculate( wd->bx[0]);
584 elm_index_item_go((Evas_Object *)data, wd->level);
590 static void _index_object_resize(void *data, Evas *e, Evas_Object *obj, void *event_info)
594 wd = elm_widget_data_get((Evas_Object *)data);
596 ecore_job_add(_index_box_refill_job, (Evas_Object *)data);
600 * Add a new index to the parent
602 * @param parent The parent object
603 * @return The new object or NULL if it cannot be created
608 elm_index_add(Evas_Object *parent)
614 Evas_Coord minw, minh;
616 wd = ELM_NEW(Widget_Data);
617 e = evas_object_evas_get(parent);
618 obj = elm_widget_add(e);
619 ELM_SET_WIDTYPE(widtype, "index");
620 elm_widget_type_set(obj, "index");
621 elm_widget_sub_object_add(parent, obj);
622 elm_widget_data_set(obj, wd);
623 elm_widget_del_hook_set(obj, _del_hook);
624 elm_widget_theme_hook_set(obj, _theme_hook);
626 wd->horizontal = EINA_FALSE;
627 wd->min_obj_height = 0;
628 wd->max_grp_size = 0;
630 wd->max_supp_items_count = 0;
631 wd->tot_items_count[0] = 0;
632 wd->tot_items_count[1] = 0;
633 wd->special_char = edje_object_data_get(wd->base, "special_char");
634 if(wd->special_char == NULL) wd->special_char = eina_stringshare_add("*");
636 wd->base = edje_object_add(e);
637 _elm_theme_object_set(obj, wd->base, "index", "base/vertical", "default");
638 elm_widget_resize_object_set(obj, wd->base);
640 o = evas_object_rectangle_add(e);
642 evas_object_color_set(o, 0, 0, 0, 0);
644 elm_coords_finger_size_adjust(1, &minw, 1, &minh);
645 evas_object_size_hint_min_set(o, minw, minh);
646 edje_object_part_swallow(wd->base, "elm.swallow.event.0", o);
647 elm_widget_sub_object_add(obj, o);
648 evas_object_event_callback_add(obj, EVAS_CALLBACK_RESIZE, _index_object_resize, obj);
649 evas_object_event_callback_add(o, EVAS_CALLBACK_MOUSE_WHEEL, _wheel, obj);
650 evas_object_event_callback_add(o, EVAS_CALLBACK_MOUSE_DOWN, _mouse_down, obj);
651 evas_object_event_callback_add(o, EVAS_CALLBACK_MOUSE_UP, _mouse_up, obj);
652 evas_object_event_callback_add(o, EVAS_CALLBACK_MOUSE_MOVE, _mouse_move, obj);
654 if (edje_object_part_exists(wd->base, "elm.swallow.event.1"))
656 o = evas_object_rectangle_add(e);
658 evas_object_color_set(o, 0, 0, 0, 0);
659 evas_object_size_hint_min_set(o, minw, minh);
660 edje_object_part_swallow(wd->base, "elm.swallow.event.1", o);
661 elm_widget_sub_object_add(obj, o);
664 wd->bx[0] = evas_object_box_add(e);
665 evas_object_box_layout_set(wd->bx[0], _layout, wd, NULL);
666 elm_widget_sub_object_add(obj, wd->bx[0]);
667 edje_object_part_swallow(wd->base, "elm.swallow.index.0", wd->bx[0]);
668 evas_object_show(wd->bx[0]);
670 if (edje_object_part_exists(wd->base, "elm.swallow.index.1"))
672 wd->bx[1] = evas_object_box_add(e);
673 evas_object_box_layout_set(wd->bx[1], _layout, wd, NULL);
674 elm_widget_sub_object_add(obj, wd->bx[1]);
675 edje_object_part_swallow(wd->base, "elm.swallow.index.1", wd->bx[1]);
676 evas_object_show(wd->bx[1]);
680 wd->scale_factor = elm_scale_get();
681 if ( wd->scale_factor == 0.0 ) {
682 wd->scale_factor = 1.0;
684 string = edje_object_data_get(wd->base, "min_1st_level_obj_height");
686 wd->min_1st_level_obj_height = (int) (atoi(string))*wd->scale_factor;
688 wd->min_1st_level_obj_height = MIN_OBJ_HEIGHT*wd->scale_factor;
694 _group_count(Evas_Object *obj, int extraIndex, int adj_pos, int vis_pos)
696 Widget_Data *wd = elm_widget_data_get(obj);
698 int group_count = MIN_GRP_SIZE;
699 while(group_count <= wd->max_grp_size)
701 if(extraIndex <= wd->max_grp_size*adj_pos)
703 if(group_count*adj_pos>=extraIndex) return group_count;
706 return wd->max_grp_size;
708 group_count+=MIN_GRP_SIZE;
712 _index_process(Evas_Object *obj)
715 int j,i, group_count;
721 Widget_Data *wd = elm_widget_data_get(obj);
724 if(wd->items_count == 0) return;
726 const int adj_pos = (wd->items_count-1)*0.5;
727 if(wd->tot_items_count[wd->level] <= wd->max_supp_items_count)
728 n = wd->tot_items_count[wd->level];
730 n = wd->max_supp_items_count;
731 group_count = MIN_GRP_SIZE;
734 const int minh = wd->min_obj_height;
735 EINA_LIST_FOREACH(wd->items, l, it)
737 it->vis_letter = eina_stringshare_add(it->letter);
742 int N = wd->items_count;
749 if(extraIndex < 0) return;
751 group_count = _group_count(obj, extraIndex, adj_pos, N);
752 if(group_count <= 0) return;
754 PlacementPart place[adj_pos];
755 remainder = extraIndex%group_count;
756 numberofparts=(extraIndex/group_count)+(remainder == 0? 0: 1);
758 for(i=0;i<numberofparts; i++)
760 place[i].count=group_count+1;
761 count = (int)(((float)(i+1)/(float)(numberofparts+1))*N);
762 place[i].start= count +i*group_count-1;
765 place[numberofparts-1].count=remainder+1;
767 for(i=0;i<numberofparts;i++)
769 for(j=0;j<place[i].count; j++)
771 indx[((place[i].start)+j)]= MIN_PIXEL_VALUE;
773 indx[(place[i].start+(place[i].count)/2)] = minh-place[i].count+1;
776 EINA_LIST_FOREACH(wd->items, l, it)
778 int size = indx[count];
782 it->vis_letter = eina_stringshare_add(it->letter);
787 eina_stringshare_del(it->vis_letter);
788 it->vis_letter = eina_stringshare_add("");
792 eina_stringshare_del(it->vis_letter);
793 it->vis_letter = eina_stringshare_add(wd->special_char);
795 it->size = size*wd->scale_factor;
799 * Set the active state of the index programatically
801 * @param obj The index object
802 * @param active The active starte
807 elm_index_active_set(Evas_Object *obj, Eina_Bool active)
809 ELM_CHECK_WIDTYPE(obj, widtype);
810 Widget_Data *wd = elm_widget_data_get(obj);
812 if (wd->active == active) return;
817 _index_box_clear(obj, wd->bx[1], 1);
819 _index_box_auto_fill(obj, wd->bx[0], 0);
820 edje_object_signal_emit(wd->base, "elm,state,active", "elm");
823 edje_object_signal_emit(wd->base, "elm,state,inactive", "elm");
827 * Sets the level of the item.
829 * @param obj The index object.
830 * @param level To be documented.
835 elm_index_item_level_set(Evas_Object *obj, int level)
837 ELM_CHECK_WIDTYPE(obj, widtype);
838 Widget_Data *wd = elm_widget_data_get(obj);
840 if (wd->level == level) return;
845 * Gets the level of the item.
847 * @param obj The index object
852 elm_index_item_level_get(const Evas_Object *obj)
854 ELM_CHECK_WIDTYPE(obj, widtype) 0;
855 Widget_Data *wd = elm_widget_data_get(obj);
861 * Returns the selected item.
863 * @param obj The index object.
864 * @param level to be documented.
869 elm_index_item_selected_get(const Evas_Object *obj, int level)
871 ELM_CHECK_WIDTYPE(obj, widtype) NULL;
872 Widget_Data *wd = elm_widget_data_get(obj);
875 if (!wd) return NULL;
876 EINA_LIST_FOREACH(wd->items, l, it)
877 if ((it->selected) && (it->level == level)) return it->data;
882 * Appends a new item.
884 * @param obj The index object.
885 * @param letter Letter under which the item should be indexed
886 * @param item The item to put in the index
891 elm_index_item_append(Evas_Object *obj, const char *letter, const void *item)
893 ELM_CHECK_WIDTYPE(obj, widtype);
894 Widget_Data *wd = elm_widget_data_get(obj);
897 it = _item_new(obj, letter, item);
899 wd->items = eina_list_append(wd->items, it);
900 wd->tot_items_count[wd->level]++;
901 _index_box_clear(obj, wd->bx[wd->level], wd->level);
905 * Prepends a new item.
907 * @param obj The index object.
908 * @param letter Letter under which the item should be indexed
909 * @param item The item to put in the index
914 elm_index_item_prepend(Evas_Object *obj, const char *letter, const void *item)
916 ELM_CHECK_WIDTYPE(obj, widtype);
917 Widget_Data *wd = elm_widget_data_get(obj);
921 it = _item_new(obj, letter, item);
923 wd->items = eina_list_prepend(wd->items, it);
924 wd->tot_items_count[wd->level]++;
925 _index_box_clear(obj, wd->bx[wd->level], wd->level);
929 * Append an item after @p relative in letter @p letter.
931 * @param obj The index object
932 * @param letter Letter under which the item should be indexed
933 * @param item The item to put in the index
934 * @param relative The item to put @p item after
939 elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const void *relative)
941 ELM_CHECK_WIDTYPE(obj, widtype);
942 Widget_Data *wd = elm_widget_data_get(obj);
943 Elm_Index_Item *it, *it_rel;
947 elm_index_item_append(obj, letter, item);
948 wd->tot_items_count[wd->level]++;
951 it = _item_new(obj, letter, item);
952 it_rel = _item_find(obj, relative);
955 elm_index_item_append(obj, letter, item);
956 wd->tot_items_count[wd->level]++;
960 wd->items = eina_list_append_relative(wd->items, it, it_rel);
961 wd->tot_items_count[wd->level]++;
962 _index_box_clear(obj, wd->bx[wd->level], wd->level);
966 * Prepend an item before @p relative in letter @p letter.
968 * @param obj The index object
969 * @param letter Letter under which the item should be indexed
970 * @param item The item to put in the index
971 * @param relative The item to put @p item before
976 elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const void *relative)
978 ELM_CHECK_WIDTYPE(obj, widtype);
979 Widget_Data *wd = elm_widget_data_get(obj);
980 Elm_Index_Item *it, *it_rel;
984 elm_index_item_prepend(obj, letter, item);
985 wd->tot_items_count[wd->level]++;
988 it = _item_new(obj, letter, item);
989 it_rel = _item_find(obj, relative);
992 elm_index_item_append(obj, letter, item);
993 wd->tot_items_count[wd->level]++;
997 wd->items = eina_list_prepend_relative(wd->items, it, it_rel);
998 wd->tot_items_count[wd->level]++;
999 _index_box_clear(obj, wd->bx[wd->level], wd->level);
1003 * Insert a new @p item into the sorted index @p obj in @p letter.
1005 * @param obj The index object
1006 * @param letter Letter under which the item should be indexed
1007 * @param item The item to put in the index
1008 * @param cmp_func The function called for the sort of index items.
1009 * @param cmp_data_func The function called for the sort of the data. It will
1010 * be used when cmp_func return 0. It means the index item already exists.
1011 * So, to decide which data item should be pointed by the index item, a function
1012 * to compare them is needed. If this function is not provided, index items
1013 * will be duplicated. If cmp_data_func returns a non-negative value, the
1014 * previous index item data will be replaced by the inserted @p item. So
1015 * if the previous data need to be free, it should be done in this function,
1016 * because the reference will be lost.
1021 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)
1023 ELM_CHECK_WIDTYPE(obj, widtype);
1024 Widget_Data *wd = elm_widget_data_get(obj);
1032 elm_index_item_append(obj, letter, item);
1036 it = _item_new(obj, letter, item);
1039 lnear = eina_list_search_sorted_near_list(wd->items, cmp_func, it, &cmp);
1041 wd->items = eina_list_append_relative_list(wd->items, it, lnear);
1043 wd->items = eina_list_prepend_relative_list(wd->items, it, lnear);
1046 /* If cmp_data_func is not provided, append a duplicated item */
1048 wd->items = eina_list_append_relative_list(wd->items, it, lnear);
1051 Elm_Index_Item *p_it = eina_list_data_get(lnear);
1052 if (cmp_data_func(p_it->data, it->data) >= 0)
1053 p_it->data = it->data;
1058 _index_box_clear(obj, wd->bx[wd->level], wd->level);
1062 * Remove an item from the index.
1064 * @param obj The index object
1065 * @param item The item to remove from the index
1070 elm_index_item_del(Evas_Object *obj, const void *item)
1072 ELM_CHECK_WIDTYPE(obj, widtype);
1073 Widget_Data *wd = elm_widget_data_get(obj);
1076 it = _item_find(obj, item);
1079 wd->tot_items_count[wd->level]--;
1080 _index_box_clear(obj, wd->bx[wd->level], wd->level);
1084 * Find an index item using item data.
1086 * @param obj The index object
1087 * @param item The item pointed by index item
1088 * @return The index item pointing to @p item
1092 EAPI Elm_Index_Item *
1093 elm_index_item_find(Evas_Object *obj, const void *item)
1095 ELM_CHECK_WIDTYPE(obj, widtype) NULL;
1096 Widget_Data *wd = elm_widget_data_get(obj);
1097 if (!wd) return NULL;
1098 return _item_find(obj, item);
1102 * Clears an index of its items.
1104 * @param obj The index object.
1109 elm_index_item_clear(Evas_Object *obj)
1111 ELM_CHECK_WIDTYPE(obj, widtype);
1112 Widget_Data *wd = elm_widget_data_get(obj);
1114 Eina_List *l, *clear = NULL;
1116 _index_box_clear(obj, wd->bx[wd->level], wd->level);
1117 EINA_LIST_FOREACH(wd->items, l, it)
1119 if (it->level != wd->level) continue;
1120 clear = eina_list_append(clear, it);
1122 EINA_LIST_FREE(clear, it) _item_free(it);
1126 * Go to item at @p level
1128 * @param obj The index object
1129 * @param level The index level
1134 elm_index_item_go(Evas_Object *obj, int level __UNUSED__)
1136 ELM_CHECK_WIDTYPE(obj, widtype);
1137 Widget_Data *wd = elm_widget_data_get(obj);
1140 _index_process(obj);
1141 _index_box_auto_fill(obj, wd->bx[0], 0);
1142 if (wd->level == 1) _index_box_auto_fill(obj, wd->bx[1], 1);
1146 * Returns the data associated with the item.
1148 * @param it The list item
1149 * @return The data associated with @p it
1154 elm_index_item_data_get(const Elm_Index_Item *it)
1156 if (!it) return NULL;
1157 return (void *)it->data;
1161 * Set the data item from the index item
1163 * This set a new data value.
1165 * @param it The item
1166 * @param data The new data pointer to set
1171 elm_index_item_data_set(Elm_Index_Item *it, const void *data)
1178 * Gets the letter of the item.
1180 * @param it The list item
1181 * @return The letter of @p it
1186 elm_index_item_letter_get(const Elm_Index_Item *it)
1188 if (!it) return NULL;