Evas_Object *bx[2]; // 2 - for now all that's supported
Eina_List *items; // 1 list. yes N levels, but only 2 for now and # of items will be small
int level;
+ int max_supp_items_count;
int tot_items_count[2];
int min_obj_height, max_grp_size;
int min_1st_level_obj_height;
const char *special_char;
Eina_Bool level_active[2];
Eina_Bool horizontal : 1;
- Eina_Bool active : 1;
+ Eina_Bool autohide_disabled : 1;
Eina_Bool down : 1;
Eina_Bool indicator_disabled : 1;
};
ELM_WIDGET_ITEM;
const char *letter, *vis_letter;
int level, size;
+ Evas_Smart_Cb func;
Eina_Bool selected : 1;
};
edje_object_scale_set(wd->base, elm_widget_scale_get(obj) * _elm_config->scale);
_sizing_eval(obj);
_index_box_auto_fill(obj, wd->bx[0], 0);
- if (wd->active)
- if (wd->level == 1)
- _index_box_auto_fill(obj, wd->bx[1], 1);
+
+ if (wd->autohide_disabled)
+ {
+ if (wd->level == 1) _index_box_auto_fill(obj, wd->bx[1], 1);
+ edje_object_signal_emit(wd->base, "elm,state,active", "elm");
+ }
+ else
+ edje_object_signal_emit(wd->base, "elm,state,inactive", "elm");
}
static void
{
Widget_Data *wd = elm_widget_data_get(WIDGET(it));
if (!wd) return EINA_FALSE;
- _item_free((Elm_Index_Item *) it);
+ _item_free((Elm_Index_Item *)it);
_index_box_clear(WIDGET(it), wd->bx[wd->level], wd->level);
return EINA_TRUE;
}
static Elm_Index_Item *
-_item_new(Evas_Object *obj, const char *letter, const void *item)
+_item_new(Evas_Object *obj, const char *letter, Evas_Smart_Cb func, const void *data)
{
Widget_Data *wd = elm_widget_data_get(obj);
Elm_Index_Item *it;
it = elm_widget_item_new(obj, Elm_Index_Item);
if (!it) return NULL;
elm_widget_item_del_pre_hook_set(it, _item_del_pre_hook);
- it->base.data = item;
+ it->func = func;
+ it->base.data = data;
it->level = wd->level;
if(wd->level == 0)
it->size = wd->min_obj_height;
}
static Elm_Index_Item *
-_item_find(Evas_Object *obj, const void *item)
+_item_find(Evas_Object *obj, const void *data)
{
Widget_Data *wd = elm_widget_data_get(obj);
Eina_List *l;
Elm_Index_Item *it;
if (!wd) return NULL;
EINA_LIST_FOREACH(wd->items, l, it)
- if (it->base.data == item) return it;
+ if (it->base.data == data) return it;
return NULL;
}
const char *stacking;
if (it->level != level) continue;
+
+//FIXME: Need to check. This cause one less items show up.
+// if(i > wd->max_supp_items_count) break;
+
o = edje_object_add(evas_object_evas_get(obj));
VIEW(it) = o;
edje_object_mirrored_set(VIEW(it), rtl);
- if (i & 0x1)
- _elm_theme_object_set(obj, o, "index", "item_odd/vertical", elm_widget_style_get(obj));
+
+ if (wd->horizontal)
+ {
+ if (i & 0x1)
+ _elm_theme_object_set(obj, o, "index", "item_odd/horizontal",
+ elm_widget_style_get(obj));
+ else
+ _elm_theme_object_set(obj, o, "index", "item/horizontal",
+ elm_widget_style_get(obj));
+ }
else
- _elm_theme_object_set(obj, o, "index", "item/vertical", elm_widget_style_get(obj));
+ {
+ if (i & 0x1)
+ _elm_theme_object_set(obj, o, "index", "item_odd/vertical",
+ elm_widget_style_get(obj));
+ else
+ _elm_theme_object_set(obj, o, "index", "item/vertical",
+ elm_widget_style_get(obj));
+ }
+
edje_object_part_text_set(o, "elm.text", it->letter);
edje_object_size_min_restricted_calc(o, &mw, &mh, 0, 0);
evas_object_size_hint_min_set(o, mw, mh);
evas_object_size_hint_weight_set(o, EVAS_HINT_EXPAND, EVAS_HINT_EXPAND);
evas_object_size_hint_align_set(o, EVAS_HINT_FILL, EVAS_HINT_FILL);
+
edje_object_part_text_set(o, "elm.text", it->vis_letter);
- evas_object_size_hint_min_set(o, mw, it->size);
+
+ //FIXME: Need to check. This cause the page index size incorrect.
+/* evas_object_size_hint_min_set(o, mw, it->size);
evas_object_size_hint_max_set(o, mw, it->size);
- evas_object_resize(o, mw, it->size);
+ evas_object_resize(o, mw, it->size); */
+
elm_widget_sub_object_add(obj, o);
evas_object_box_append(box, o);
stacking = edje_object_data_get(o, "stacking");
Elm_Object_Item *item;
if (!wd) return ECORE_CALLBACK_CANCEL;
wd->delay = NULL;
- item = elm_index_item_selected_get(data, wd->level);
+ item = elm_index_selected_item_get(data, wd->level);
if (item) evas_object_smart_callback_call(data, SIG_DELAY_CHANGED, item);
return ECORE_CALLBACK_CANCEL;
}
Eina_List *l;
Evas_Coord x, y, w, h, bx, by, bw, bh, xx, yy;
double cdv = 0.5;
- double dmax = 0.0;
- double dmin = 0.0;
Evas_Coord dist;
char *label = NULL, *last = NULL;
int i;
it_closest = NULL;
dist = 0x7fffffff;
evas_object_geometry_get(wd->bx[i], &bx, &by, &bw, &bh);
-
- dmin = (double)(wd->min_1st_level_obj_height*wd->tot_items_count[1])/(2*(double)bh);
- dmax = 1.0-dmin-0.08;
EINA_LIST_FOREACH(wd->items, l, it)
{
- if (!((it->level == i) && (VIEW(it)))) continue;
- if ((VIEW(it)) && (it->level != wd->level))
+ if (it->level != i) continue;
+ if (it->level != wd->level)
{
if (it->selected)
{
if (!label) label = strdup(last);
else
{
- /* FIXME: realloc return NULL if the request fails */
label = realloc(label, strlen(label) + strlen(last) + 1);
+ if (!label) return;
strcat(label, last);
}
free(last);
if (!last) last = strdup("");
edje_object_part_text_set(wd->base, "elm.text.body", label);
edje_object_part_text_set(wd->base, "elm.text", last);
- edje_object_signal_emit(wd->base, "hide_2nd_level", "");
free(label);
free(last);
}
evas_object_geometry_get(wd->base, &x, &y, &w, NULL);
wd->dx = ev->canvas.x - x;
wd->dy = ev->canvas.y - y;
- elm_index_active_set(data, 1);
+ if (!wd->autohide_disabled)
+ {
+ _index_box_clear(data, wd->bx[1], 1);
+ _index_box_auto_fill(data, wd->bx[0], 0);
+ edje_object_signal_emit(wd->base, "elm,state,active", "elm");
+ }
_sel_eval(data, ev->canvas.x, ev->canvas.y);
edje_object_part_drag_value_set(wd->base, "elm.dragable.pointer",
(!edje_object_mirrored_get(wd->base)) ? wd->dx : (wd->dx - w), wd->dy);
Widget_Data *wd = elm_widget_data_get(data);
Evas_Event_Mouse_Up *ev = event_info;
Elm_Object_Item *item;
+ Elm_Index_Item *id_item;
if (!wd) return;
if (ev->button != 1) return;
if (wd->level == 1 && wd->delay) ecore_timer_del(wd->delay);
wd->delay = NULL;
wd->down = 0;
- item = elm_index_item_selected_get(data, wd->level);
- if (item) evas_object_smart_callback_call(data, SIG_SELECTED, item);
- elm_index_active_set(data, 0);
+ item = elm_index_selected_item_get(data, wd->level);
+ if (item)
+ {
+ evas_object_smart_callback_call(data, SIG_SELECTED, item);
+ id_item = (Elm_Index_Item *)item;
+ if (id_item->func)
+ id_item->func((void *)id_item->base.data, WIDGET(id_item), id_item);
+ }
+ if (!wd->autohide_disabled)
+ edje_object_signal_emit(wd->base, "elm,state,inactive", "elm");
edje_object_signal_emit(wd->base, "elm,state,level,0", "elm");
if (wd->items && !wd->indicator_disabled)
edje_object_signal_emit(wd->base, "elm,indicator,state,inactive", "elm");
wd->max_grp_size = wd->min_obj_height - 2*MIN_GRP_SIZE;
wd->items_count = ph/wd->min_obj_height;
+ wd->max_supp_items_count = wd->max_grp_size*(int)((wd->items_count-1)*0.5)+wd->items_count;
if(pw != wd->pwidth && ph != wd->pheight)
{
if(wd->down == 1)
- {
- wd->active = 0;
- elm_index_active_set(data, 1);
- }
+ edje_object_signal_emit(wd->base, "elm,state,active", "elm");
_index_box_clear((Evas_Object *)data, wd->bx[0], 0);
evas_object_smart_calculate( wd->bx[0]);
elm_index_item_go((Evas_Object *)data, wd->level);
wd->indicator_disabled = EINA_FALSE;
wd->horizontal = EINA_FALSE;
+ wd->autohide_disabled = EINA_FALSE;
wd->min_obj_height = 0;
wd->max_grp_size = 0;
wd->items_count = 0;
static void
_index_process(Evas_Object *obj)
{
+//FIXME: It seems max_supp_items_count has incorrect value.
+ return;
int extraIndex;
int j,i, group_count;
Eina_List *l;
if (wd->items_count == 0) return;
const int adj_pos = (wd->items_count-1)*0.5;
- n = wd->tot_items_count[wd->level];
+ if(wd->tot_items_count[wd->level] <= wd->max_supp_items_count)
+ n = wd->tot_items_count[wd->level];
+ else
+ n = wd->max_supp_items_count;
group_count = MIN_GRP_SIZE;
int *indx = (int*)calloc(n, sizeof(int));
}
}
-EAPI void
+EINA_DEPRECATED EAPI void
elm_index_active_set(Evas_Object *obj, Eina_Bool active)
{
+ elm_index_autohide_disabled_set(obj, !active);
+}
+
+EINA_DEPRECATED EAPI Eina_Bool
+elm_index_active_get(const Evas_Object *obj)
+{
+ return !elm_index_autohide_disabled_get(obj);
+}
+
+EAPI void
+elm_index_autohide_disabled_set(Evas_Object *obj, Eina_Bool disabled)
+{
ELM_CHECK_WIDTYPE(obj, widtype);
Widget_Data *wd = elm_widget_data_get(obj);
if (!wd) return;
- if (wd->active == active) return;
- wd->active = active;
+ disabled = !!disabled;
+ if (wd->autohide_disabled == disabled) return;
+ wd->autohide_disabled = disabled;
wd->level = 0;
- if (wd->active)
+ if (wd->autohide_disabled)
{
_index_box_clear(obj, wd->bx[1], 1);
_index_process(obj);
}
else
edje_object_signal_emit(wd->base, "elm,state,inactive", "elm");
+
+ //FIXME: Should be update indicator based on the indicator visiblility
}
EAPI Eina_Bool
-elm_index_active_get(const Evas_Object *obj)
+elm_index_autohide_disabled_get(const Evas_Object *obj)
{
ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
Widget_Data *wd = elm_widget_data_get(obj);
if (!wd) return EINA_FALSE;
- return wd->active;
+ return wd->autohide_disabled;
}
EAPI void
return wd->level;
}
-EAPI Elm_Object_Item *
+EAPI void
+elm_index_item_selected_set(Elm_Object_Item *it, Eina_Bool selected)
+{
+ ELM_OBJ_ITEM_CHECK_OR_RETURN(it);
+ Evas_Coord x, y, w, h;
+ Widget_Data *wd = elm_widget_data_get(WIDGET(it));
+ if (!wd) return;
+
+ //FIXME: Should be update indicator based on the autohidden status & indicator visiblility
+
+ if (selected)
+ {
+ evas_object_geometry_get(VIEW(it), &x, &y, &w, &h);
+ _sel_eval(WIDGET(it), x + (w/2), y + (h/2));
+ }
+ else
+ _sel_eval(WIDGET(it), -99999, -9999);
+
+}
+
+EINA_DEPRECATED EAPI Elm_Object_Item *
elm_index_item_selected_get(const Evas_Object *obj, int level)
{
+ return elm_index_selected_item_get(obj, level);
+}
+
+EAPI Elm_Object_Item *
+elm_index_selected_item_get(const Evas_Object *obj, int level)
+{
ELM_CHECK_WIDTYPE(obj, widtype) NULL;
Widget_Data *wd = elm_widget_data_get(obj);
Eina_List *l;
EINA_LIST_FOREACH(wd->items, l, it)
{
if ((it->selected) && (it->level == level))
- return (Elm_Object_Item *) it;
+ return (Elm_Object_Item *)it;
}
return NULL;
}
-EAPI void
-elm_index_item_append(Evas_Object *obj, const char *letter, const void *item)
+EAPI Elm_Object_Item *
+elm_index_item_append(Evas_Object *obj, const char *letter, const void *data)
{
- ELM_CHECK_WIDTYPE(obj, widtype);
+ ELM_CHECK_WIDTYPE(obj, widtype) NULL;
Widget_Data *wd = elm_widget_data_get(obj);
Elm_Index_Item *it;
- if (!wd) return;
- it = _item_new(obj, letter, item);
- if (!it) return;
+ if (!wd) return NULL;
+ it = _item_new(obj, letter, NULL, data);
+ if (!it) return NULL;
wd->items = eina_list_append(wd->items, it);
wd->tot_items_count[wd->level]++;
_index_box_clear(obj, wd->bx[wd->level], wd->level);
+ return (Elm_Object_Item *)it;
}
-EAPI void
-elm_index_item_prepend(Evas_Object *obj, const char *letter, const void *item)
+EAPI Elm_Object_Item *
+elm_index_item_prepend(Evas_Object *obj, const char *letter, const void *data)
{
- ELM_CHECK_WIDTYPE(obj, widtype);
+ ELM_CHECK_WIDTYPE(obj, widtype) NULL;
Widget_Data *wd = elm_widget_data_get(obj);
Elm_Index_Item *it;
- if (!wd) return;
- it = _item_new(obj, letter, item);
- if (!it) return;
+ if (!wd) return NULL;
+ it = _item_new(obj, letter, NULL, data);
+ if (!it) return NULL;
wd->items = eina_list_prepend(wd->items, it);
wd->tot_items_count[wd->level]++;
_index_box_clear(obj, wd->bx[wd->level], wd->level);
+ return (Elm_Object_Item *)it;
}
-EAPI void
+EINA_DEPRECATED EAPI Elm_Object_Item *
elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative)
{
- ELM_CHECK_WIDTYPE(obj, widtype);
+ return elm_index_item_insert_after(obj, (Elm_Object_Item *) relative, letter, NULL, item);
+}
+
+EINA_DEPRECATED EAPI Elm_Object_Item *
+elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative)
+{
+ return elm_index_item_insert_before(obj, (Elm_Object_Item *) relative, letter, NULL, item);
+}
+
+EAPI Elm_Object_Item *
+elm_index_item_insert_after(Evas_Object *obj, Elm_Object_Item *after, const char *letter, Evas_Smart_Cb func, const void *data)
+{
+ ELM_CHECK_WIDTYPE(obj, widtype) NULL;
Widget_Data *wd = elm_widget_data_get(obj);
Elm_Index_Item *it;
- if (!wd) return;
- if (!relative)
+ if (!wd) return NULL;
+ if (!after)
{
- elm_index_item_append(obj, letter, item);
+ it = (Elm_Index_Item *)elm_index_item_append(obj, letter, data);
wd->tot_items_count[wd->level]++;
- return;
+ return (Elm_Object_Item *)it;
}
- it = _item_new(obj, letter, item);
- if (!it) return;
- wd->items = eina_list_append_relative(wd->items, it, relative);
+ it = _item_new(obj, letter, func, data);
+ if (!it) return NULL;
+ wd->items = eina_list_append_relative(wd->items, it, after);
wd->tot_items_count[wd->level]++;
_index_box_clear(obj, wd->bx[wd->level], wd->level);
+ return (Elm_Object_Item *)it;
}
-EAPI void
-elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative)
+EAPI Elm_Object_Item *
+elm_index_item_insert_before(Evas_Object *obj, Elm_Object_Item *before, const char *letter, Evas_Smart_Cb func, const void *data)
{
- ELM_CHECK_WIDTYPE(obj, widtype);
+ ELM_CHECK_WIDTYPE(obj, widtype) NULL;
Widget_Data *wd = elm_widget_data_get(obj);
Elm_Index_Item *it;
- if (!wd) return;
- if (!relative)
+ if (!wd) return NULL;
+ if (!before)
{
- elm_index_item_prepend(obj, letter, item);
+ it = (Elm_Index_Item *)elm_index_item_prepend(obj, letter, data);
wd->tot_items_count[wd->level]++;
- return;
+ return (Elm_Object_Item *)it;
}
- it = _item_new(obj, letter, item);
- if (!it) return;
- wd->items = eina_list_prepend_relative(wd->items, it, relative);
+ it = _item_new(obj, letter, func, data);
+ if (!it) return NULL;
+ wd->items = eina_list_prepend_relative(wd->items, it, before);
wd->tot_items_count[wd->level]++;
_index_box_clear(obj, wd->bx[wd->level], wd->level);
+ return (Elm_Object_Item *)it;
}
-EAPI void
-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)
+EAPI Elm_Object_Item *
+elm_index_item_sorted_insert(Evas_Object *obj, const char *letter, const void *data, Eina_Compare_Cb cmp_func, Eina_Compare_Cb cmp_data_func)
{
- ELM_CHECK_WIDTYPE(obj, widtype);
+ ELM_CHECK_WIDTYPE(obj, widtype) NULL;
Widget_Data *wd = elm_widget_data_get(obj);
Eina_List *lnear;
Elm_Index_Item *it;
int cmp;
- if (!wd) return;
+ if (!wd) return NULL;
if (!(wd->items))
- {
- elm_index_item_append(obj, letter, item);
- return;
- }
+ return elm_index_item_append(obj, letter, data);
- it = _item_new(obj, letter, item);
- if (!it) return;
+ it = _item_new(obj, letter, NULL, data);
+ if (!it) return NULL;
lnear = eina_list_search_sorted_near_list(wd->items, cmp_func, it, &cmp);
if (cmp < 0)
elm_widget_item_free(it);
}
}
-
_index_box_clear(obj, wd->bx[wd->level], wd->level);
+ return (Elm_Object_Item *)it;
}
EAPI void
}
EAPI Elm_Object_Item *
-elm_index_item_find(Evas_Object *obj, const void *item)
+elm_index_item_find(Evas_Object *obj, const void *data)
{
ELM_CHECK_WIDTYPE(obj, widtype) NULL;
Widget_Data *wd = elm_widget_data_get(obj);
if (!wd) return NULL;
- return (Elm_Object_Item *) _item_find(obj, item);
+ return (Elm_Object_Item *) _item_find(obj, data);
}
EAPI void
}
}
+EINA_DEPRECATED EAPI void
+elm_index_item_go(Evas_Object *obj, int level __UNUSED__)
+{
+ elm_index_level_go(obj, level);
+}
+
EAPI void
-elm_index_item_go(Evas_Object *obj, int level)
+elm_index_level_go(Evas_Object *obj, int level __UNUSED__)
{
ELM_CHECK_WIDTYPE(obj, widtype);
Widget_Data *wd = elm_widget_data_get(obj);
if (!wd) return;
- if(level == 0) _index_process(obj);
+ //FIXME: Check the crash problem
+// if(level == 0) _index_process(obj);
_index_box_auto_fill(obj, wd->bx[0], 0);
if (wd->level == 1) _index_box_auto_fill(obj, wd->bx[1], 1);
}
elm_index_item_letter_get(const Elm_Object_Item *it)
{
ELM_OBJ_ITEM_CHECK_OR_RETURN(it, NULL);
- return ((Elm_Index_Item *) it)->letter;
+ return ((Elm_Index_Item *)it)->letter;
}
+EAPI void
+elm_index_horizontal_set(Evas_Object *obj, Eina_Bool horizontal)
+{
+ ELM_CHECK_WIDTYPE(obj, widtype);
+ Widget_Data *wd = elm_widget_data_get(obj);
+ if (!wd) return;
+
+ horizontal = !!horizontal;
+ if (horizontal == wd->horizontal) return;
+ wd->horizontal = horizontal;
+ _theme_hook(obj);
+}
+
+EAPI Eina_Bool
+elm_index_horizontal_get(const Evas_Object *obj)
+{
+ ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
+ Widget_Data *wd = elm_widget_data_get(obj);
+ if (!wd) return EINA_FALSE;
+ return wd->horizontal;
+}
+
+
* @addtogroup Index
* @{
*/
-
/**
* Add a new index widget to the given parent Elementary
* (container) object
* Enable or disable auto hiding feature for a given index widget.
*
* @param obj The index object
- * @param active @c EINA_TRUE to enable auto hiding, @c EINA_FALSE to disable
+ * @param disabled @c EINA_TRUE to disable auto hiding, @c EINA_FALSE to enable
*
- * @see elm_index_active_get()
+ * @see elm_index_autohide_disabled_get()
*
* @ingroup Index
*/
+EAPI void elm_index_autohide_disabled_set(Evas_Object *obj, Eina_Bool disabled);
EAPI void elm_index_active_set(Evas_Object *obj, Eina_Bool active);
/**
* Get whether auto hiding feature is enabled or not for a given index widget.
*
* @param obj The index object
- * @return @c EINA_TRUE, if auto hiding is enabled, @c EINA_FALSE otherwise
+ * @return @c EINA_TRUE, if auto hiding is disabled, @c EINA_FALSE otherwise
*
* @see elm_index_active_set() for more details
*
* @ingroup Index
*/
+EAPI Eina_Bool elm_index_autohide_disabled_get(const Evas_Object *obj);
EAPI Eina_Bool elm_index_active_get(const Evas_Object *obj);
/**
EAPI int elm_index_item_level_get(const Evas_Object *obj);
/**
+ * Set the selected state of an item.
+ *
+ * @param it The index item
+ * @param selected The selected state
+ *
+ * This sets the selected state of the given item @p it.
+ * @c EINA_TRUE for selected, @c EINA_FALSE for not selected.
+ *
+ * If a new item is selected the previously selected will be unselected.
+ * Previously selected item can be get with function
+ * elm_index_selected_item_get().
+ *
+ * Selected items will be highlighted.
+ *
+ * @see elm_index_item_selected_get()
+ * @see elm_index_selected_item_get()
+ *
+ * @ingroup Index
+ */
+EAPI void elm_index_item_selected_set(Elm_Object_Item *it, Eina_Bool selected);
+
+/**
* Returns the last selected item, for a given index widget.
*
* @param obj The index object.
*
* @ingroup Index
*/
+EAPI Elm_Object_Item *elm_index_selected_item_get(const Evas_Object *obj, int level);
EAPI Elm_Object_Item *elm_index_item_selected_get(const Evas_Object *obj, int level);
/**
*
* @param obj The index object.
* @param letter Letter under which the item should be indexed
- * @param item The item data to set for the index's item
+ * @param func The function to call when the item is selected.
+ * @param data The item data to set for the index's item
+ * @return A handle to the item added or @c NULL, on errors
*
* Despite the most common usage of the @p letter argument is for
* single char strings, one could use arbitrary strings as index
*
* @ingroup Index
*/
-EAPI void elm_index_item_append(Evas_Object *obj, const char *letter, const void *item);
+EAPI Elm_Object_Item *elm_index_item_append(Evas_Object *obj, const char *letter, const void *data);
/**
* Prepend a new item on a given index widget.
*
* @param obj The index object.
* @param letter Letter under which the item should be indexed
- * @param item The item data to set for the index's item
+ * @param func The function to call when the item is selected.
+ * @param data The item data to set for the index's item
+ * @return A handle to the item added or @c NULL, on errors
*
* Despite the most common usage of the @p letter argument is for
* single char strings, one could use arbitrary strings as index
*
* @ingroup Index
*/
-EAPI void elm_index_item_prepend(Evas_Object *obj, const char *letter, const void *item);
+EAPI Elm_Object_Item *elm_index_item_prepend(Evas_Object *obj, const char *letter, const void *data);
/**
- * Append a new item, on a given index widget, <b>after the item
- * having @p relative as data</b>.
+ * Insert a new item into the index object after item @p after.
*
* @param obj The index object.
+ * @param after The index item to insert after.
* @param letter Letter under which the item should be indexed
- * @param item The item data to set for the index's item
- * @param relative The index item to be the predecessor of this new one
+ * @param func The function to call when the item is clicked.
+ * @param data The item data to set for the index's item
+ * @return A handle to the item added or @c NULL, on errors
*
* Despite the most common usage of the @p letter argument is for
* single char strings, one could use arbitrary strings as index
*
* @ingroup Index
*/
-EAPI void elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
+EAPI Elm_Object_Item *elm_index_item_insert_after(Evas_Object *obj, Elm_Object_Item *after, const char *letter, Evas_Smart_Cb func, const void *data);
+EAPI Elm_Object_Item *elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *data, const Elm_Object_Item *relative);
/**
- * Prepend a new item, on a given index widget, <b>after the item
- * having @p relative as data</b>.
+ * Insert a new item into the index object before item @p before.
*
* @param obj The index object.
+ * @param before The index item to insert after.
* @param letter Letter under which the item should be indexed
- * @param item The item data to set for the index's item
- * @param relative The index item to be the successor of this new one
+ * @param func The function to call when the item is clicked.
+ * @param data The item data to set for the index's item
+ * @return A handle to the item added or @c NULL, on errors
*
* Despite the most common usage of the @p letter argument is for
* single char strings, one could use arbitrary strings as index
*
* @ingroup Index
*/
-EAPI void elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
+EAPI Elm_Object_Item *elm_index_item_insert_before(Evas_Object *obj, Elm_Object_Item *before, const char *letter, Evas_Smart_Cb func, const void *data);
+EAPI Elm_Object_Item *elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *data, const Elm_Object_Item *relative);
/**
* Insert a new item into the given index widget, using @p cmp_func
*
* @param obj The index object.
* @param letter Letter under which the item should be indexed
- * @param item The item data to set for the index's item
+ * @param func The function to call when the item is clicked.
+ * @param data The item data to set for the index's item
* @param cmp_func The comparing function to be used to sort index
* items <b>by #index item handles</b>
* @param cmp_data_func A @b fallback function to be called for the
* because all references to it will be lost. If this function is
* not provided (@c NULL is given), index items will be @b
* duplicated, if @p cmp_func returns @c 0.
+ * @return A handle to the item added or @c NULL, on errors
*
* Despite the most common usage of the @p letter argument is for
* single char strings, one could use arbitrary strings as index
*
* @ingroup Index
*/
-EAPI void 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);
+EAPI Elm_Object_Item *elm_index_item_sorted_insert(Evas_Object *obj, const char *letter, const void *data, Eina_Compare_Cb cmp_func, Eina_Compare_Cb cmp_data_func);
/**
* Find a given index widget's item, <b>using item data</b>.
*
* @param obj The index object
- * @param item The item data pointed to by the desired index item
+ * @param data The item data pointed to by the desired index item
* @return The index item handle, if found, or @c NULL otherwise
*
* @ingroup Index
*/
-EAPI Elm_Object_Item *elm_index_item_find(Evas_Object *obj, const void *item);
+EAPI Elm_Object_Item *elm_index_item_find(Evas_Object *obj, const void *data);
/**
* Removes @b all items from a given index widget.
*
* @ingroup Index
*/
+EAPI void elm_index_level_go(Evas_Object *obj, int level);
EAPI void elm_index_item_go(Evas_Object *obj, int level);
/**
*
* @ingroup Index
*/
-EAPI Eina_Bool elm_index_indicator_disabled_get(const Evas_Object *obj);
+EAPI Eina_Bool elm_index_indicator_disabled_get(const Evas_Object *obj);
+
+/**
+ * Enable or disable horizontal mode on the index object
+ *
+ * @param obj The index object.
+ * @param horizontal @c EINA_TRUE to enable horizontal or @c EINA_FALSE to
+ * disable it, i.e., to enable vertical mode. it's an area one @ref Fingers
+ * "finger" wide on the bottom side of the index widget's container.
+ *
+ * @note Vertical mode is set by default.
+ *
+ * On horizontal mode items are displayed on index from left to right,
+ * instead of from top to bottom. Also, the index will scroll horizontally.
+ *
+ * @see elm_index_horizontal_get()
+ *
+ * @ingroup Index
+ */
+EAPI void elm_index_horizontal_set(Evas_Object *obj, Eina_Bool horizontal);
-EAPI void elm_index_button_image_invisible_set(Evas_Object *obj, Eina_Bool invisible);
+/**
+ * Get a value whether horizontal mode is enabled or not.
+ *
+ * @param obj The index object.
+ * @return @c EINA_TRUE means horizontal mode selection is enabled.
+ * @c EINA_FALSE indicates it's disabled. If @p obj is @c NULL,
+ * @c EINA_FALSE is returned.
+ *
+ * @see elm_index_horizontal_set() for details.
+ *
+ * @ingroup Index
+ */
+EAPI Eina_Bool elm_index_horizontal_get(const Evas_Object *obj);
/**
* @}