1435 lines
40 KiB
C
1435 lines
40 KiB
C
/**
|
|
* @defgroup Diskpicker
|
|
*
|
|
* A diskpicker is a kind of list widget. It scrolls horizontally,
|
|
* and can contain label and icon objects. Three items are displayed
|
|
* with the selected on the middle.
|
|
*
|
|
* It can act like a circular list with round mode and labels can be
|
|
* reduced for a defined lenght for side items.
|
|
*
|
|
* Signal emitted by this widget:
|
|
* "selected" - when item is selected (scroller stops)
|
|
*/
|
|
|
|
#include <Elementary.h>
|
|
#include "elm_priv.h"
|
|
|
|
#ifndef MAX
|
|
# define MAX(a, b) (((a) > (b)) ? (a) : (b))
|
|
#endif
|
|
|
|
typedef struct _Widget_Data Widget_Data;
|
|
|
|
struct _Widget_Data
|
|
{
|
|
Evas_Object *self;
|
|
Evas_Object *scroller;
|
|
Evas_Object *main_box;
|
|
Evas_Object *left_blank;
|
|
Evas_Object *right_blank;
|
|
Elm_Diskpicker_Item *selected_item;
|
|
Elm_Diskpicker_Item *first;
|
|
Elm_Diskpicker_Item *second;
|
|
Elm_Diskpicker_Item *s_last;
|
|
Elm_Diskpicker_Item *last;
|
|
Eina_List *items;
|
|
Eina_List *r_items;
|
|
int item_count, len_threshold, len_side;
|
|
Ecore_Idler *idler;
|
|
Ecore_Idler *check_idler;
|
|
Eina_Bool init:1;
|
|
Eina_Bool round:1;
|
|
};
|
|
|
|
struct _Elm_Diskpicker_Item
|
|
{
|
|
Elm_Widget_Item base;
|
|
Eina_List *node;
|
|
Evas_Object *icon;
|
|
const char *label;
|
|
Evas_Smart_Cb func;
|
|
};
|
|
|
|
static const char *widtype = NULL;
|
|
|
|
#define ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(it, ...) \
|
|
ELM_WIDGET_ITEM_CHECK_OR_RETURN((Elm_Widget_Item *)it, __VA_ARGS__); \
|
|
ELM_CHECK_WIDTYPE(it->base.widget, widtype) __VA_ARGS__;
|
|
|
|
static Eina_Bool _move_scroller(void *data);
|
|
static void _del_hook(Evas_Object * obj);
|
|
static void _del_pre_hook(Evas_Object * obj);
|
|
static void _sizing_eval(Evas_Object * obj);
|
|
static void _theme_hook(Evas_Object * obj);
|
|
static void _on_focus_hook(void *data, Evas_Object *obj);
|
|
static Eina_Bool _event_hook(Evas_Object *obj, Evas_Object *src, Evas_Callback_Type type, void *event_info);
|
|
static void _sub_del(void *data, Evas_Object * obj, void *event_info);
|
|
static void _round_items_del(Widget_Data *wd);
|
|
static void _scroller_move_cb(void *data, Evas_Object *obj, void *event_info);
|
|
|
|
static const char SIG_SELECTED[] = "selected";
|
|
static const Evas_Smart_Cb_Description _signals[] = {
|
|
{SIG_SELECTED, ""},
|
|
{NULL, NULL}
|
|
};
|
|
|
|
static void
|
|
_diskpicker_object_resize(void *data, Evas *e __UNUSED__, Evas_Object *obj, void *event_info __UNUSED__)
|
|
{
|
|
Widget_Data *wd;
|
|
Evas_Coord w, h, minw = -1, minh = -1;
|
|
|
|
wd = elm_widget_data_get(data);
|
|
if (!wd) return;
|
|
|
|
elm_coords_finger_size_adjust(6, &minw, 1, &minh);
|
|
edje_object_size_min_restricted_calc(elm_smart_scroller_edje_object_get(
|
|
wd->scroller), &minw, &minh, minw, minh);
|
|
evas_object_size_hint_min_set(obj, minw, minh);
|
|
evas_object_size_hint_max_set(obj, -1, -1);
|
|
|
|
evas_object_geometry_get(wd->scroller, NULL, NULL, &w, &h);
|
|
if (wd->round)
|
|
evas_object_resize(wd->main_box, w / 3 * (wd->item_count + 4), h);
|
|
else
|
|
evas_object_resize(wd->main_box, w / 3 * (wd->item_count + 2), h);
|
|
|
|
elm_smart_scroller_paging_set(wd->scroller, 0, 0,
|
|
(int)(w / 3), 0);
|
|
|
|
if (!wd->idler)
|
|
wd->idler = ecore_idler_add(_move_scroller, data);
|
|
}
|
|
|
|
static Elm_Diskpicker_Item *
|
|
_item_new(Evas_Object *obj, Evas_Object *icon, const char *label, Evas_Smart_Cb func, const void *data)
|
|
{
|
|
Elm_Diskpicker_Item *it;
|
|
const char *style = elm_widget_style_get(obj);
|
|
|
|
it = elm_widget_item_new(obj, Elm_Diskpicker_Item);
|
|
if (!it) return NULL;
|
|
|
|
it->label = eina_stringshare_add(label);
|
|
it->icon = icon;
|
|
it->func = func;
|
|
it->base.data = data;
|
|
it->base.view = edje_object_add(evas_object_evas_get(obj));
|
|
_elm_theme_object_set(obj, it->base.view, "diskpicker", "item", style);
|
|
evas_object_size_hint_weight_set(it->base.view, EVAS_HINT_EXPAND,
|
|
EVAS_HINT_EXPAND);
|
|
evas_object_size_hint_align_set(it->base.view, EVAS_HINT_FILL,
|
|
EVAS_HINT_FILL);
|
|
evas_object_show(it->base.view);
|
|
|
|
if (it->label)
|
|
edje_object_part_text_set(it->base.view, "elm.text", it->label);
|
|
if (it->icon)
|
|
{
|
|
evas_object_size_hint_min_set(it->icon, 24, 24);
|
|
evas_object_size_hint_max_set(it->icon, 40, 40);
|
|
edje_object_part_swallow(it->base.view, "elm.swallow.icon", it->icon);
|
|
evas_object_show(it->icon);
|
|
elm_widget_sub_object_add(obj, it->icon);
|
|
}
|
|
return it;
|
|
}
|
|
|
|
static void
|
|
_item_del(Elm_Diskpicker_Item *item)
|
|
{
|
|
if (!item) return;
|
|
eina_stringshare_del(item->label);
|
|
if (item->icon)
|
|
evas_object_del(item->icon);
|
|
elm_widget_item_del(item);
|
|
}
|
|
|
|
static void
|
|
_theme_data_get(Widget_Data *wd)
|
|
{
|
|
const char* str;
|
|
str = edje_object_data_get(wd->right_blank, "len_threshold");
|
|
if (str) wd->len_threshold = atoi(str);
|
|
else wd->len_threshold = 0;
|
|
}
|
|
|
|
static void
|
|
_del_hook(Evas_Object * obj)
|
|
{
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
free(wd);
|
|
}
|
|
|
|
static void
|
|
_del_pre_hook(Evas_Object * obj)
|
|
{
|
|
Elm_Diskpicker_Item *it;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
|
|
if (wd->left_blank)
|
|
evas_object_del(wd->left_blank);
|
|
if (wd->right_blank)
|
|
evas_object_del(wd->right_blank);
|
|
if (wd->last)
|
|
{
|
|
eina_stringshare_del(wd->last->label);
|
|
evas_object_del(wd->last->base.view);
|
|
free(wd->last);
|
|
}
|
|
if (wd->s_last)
|
|
{
|
|
eina_stringshare_del(wd->s_last->label);
|
|
evas_object_del(wd->s_last->base.view);
|
|
free(wd->s_last);
|
|
}
|
|
if (wd->second)
|
|
{
|
|
eina_stringshare_del(wd->second->label);
|
|
evas_object_del(wd->second->base.view);
|
|
free(wd->second);
|
|
}
|
|
if (wd->first)
|
|
{
|
|
eina_stringshare_del(wd->first->label);
|
|
evas_object_del(wd->first->base.view);
|
|
free(wd->first);
|
|
}
|
|
|
|
EINA_LIST_FREE(wd->items, it) _item_del(it);
|
|
eina_list_free(wd->r_items);
|
|
}
|
|
|
|
static void
|
|
_sizing_eval(Evas_Object * obj)
|
|
{
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
_diskpicker_object_resize(obj, NULL, obj, NULL);
|
|
}
|
|
|
|
static void
|
|
_theme_hook(Evas_Object * obj)
|
|
{
|
|
Eina_List *l;
|
|
Elm_Diskpicker_Item *it;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
|
|
if (wd->scroller)
|
|
elm_smart_scroller_object_theme_set(obj, wd->scroller, "diskpicker",
|
|
"base", elm_widget_style_get(obj));
|
|
if (wd->round)
|
|
{
|
|
EINA_LIST_FOREACH(wd->r_items, l, it)
|
|
{
|
|
_elm_theme_object_set(obj, it->base.view, "diskpicker", "item",
|
|
elm_widget_style_get(obj));
|
|
}
|
|
}
|
|
else
|
|
{
|
|
EINA_LIST_FOREACH(wd->items, l, it)
|
|
{
|
|
_elm_theme_object_set(obj, it->base.view, "diskpicker", "item",
|
|
elm_widget_style_get(obj));
|
|
}
|
|
}
|
|
_theme_data_get(wd);
|
|
_sizing_eval(obj);
|
|
}
|
|
|
|
static void
|
|
_sub_del(void *data __UNUSED__, Evas_Object * obj, void *event_info)
|
|
{
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
Evas_Object *sub = event_info;
|
|
Elm_Diskpicker_Item *it;
|
|
const Eina_List *l;
|
|
|
|
if (!wd) return;
|
|
if (!sub) abort();
|
|
if (sub == wd->scroller)
|
|
wd->scroller = NULL;
|
|
else
|
|
{
|
|
EINA_LIST_FOREACH(wd->items, l, it)
|
|
{
|
|
if (sub == it->icon)
|
|
{
|
|
it->icon = NULL;
|
|
_sizing_eval(obj);
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
}
|
|
|
|
static void
|
|
_select_item(Elm_Diskpicker_Item *it)
|
|
{
|
|
if (!it) return;
|
|
Widget_Data *wd = elm_widget_data_get(it->base.widget);
|
|
wd->selected_item = it;
|
|
if (it->func) it->func((void *)it->base.data, it->base.widget, it);
|
|
evas_object_smart_callback_call(it->base.widget, SIG_SELECTED, it);
|
|
}
|
|
|
|
static void
|
|
_on_focus_hook(void *data __UNUSED__, Evas_Object *obj)
|
|
{
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd)
|
|
return;
|
|
|
|
if (elm_widget_focus_get(obj))
|
|
{
|
|
edje_object_signal_emit(wd->self, "elm,action,focus", "elm");
|
|
evas_object_focus_set(wd->self, EINA_TRUE);
|
|
}
|
|
else
|
|
{
|
|
edje_object_signal_emit(wd->self, "elm,action,unfocus", "elm");
|
|
evas_object_focus_set(wd->self, EINA_FALSE);
|
|
}
|
|
}
|
|
|
|
static Eina_Bool
|
|
_event_hook(Evas_Object *obj, Evas_Object *src __UNUSED__, Evas_Callback_Type type, void *event_info)
|
|
{
|
|
if (type != EVAS_CALLBACK_KEY_DOWN) return EINA_FALSE;
|
|
Evas_Event_Key_Down *ev = event_info;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return EINA_FALSE;
|
|
if (ev->event_flags & EVAS_EVENT_FLAG_ON_HOLD) return EINA_FALSE;
|
|
if (elm_widget_disabled_get(obj)) return EINA_FALSE;
|
|
|
|
Elm_Diskpicker_Item *it = NULL;
|
|
Eina_List *l;
|
|
|
|
if (!wd->selected_item) {
|
|
ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
|
|
return EINA_TRUE;
|
|
}
|
|
|
|
if ((!strcmp(ev->keyname, "Left")) || (!strcmp(ev->keyname, "KP_Left")) ||
|
|
(!strcmp(ev->keyname, "Up")) || (!strcmp(ev->keyname, "KP_Up")))
|
|
{
|
|
l = wd->selected_item->node->prev;
|
|
if ((!l) && (wd->round))
|
|
l = eina_list_last(wd->items);
|
|
}
|
|
else if ((!strcmp(ev->keyname, "Right")) || (!strcmp(ev->keyname, "KP_Right")) ||
|
|
(!strcmp(ev->keyname, "Down")) || (!strcmp(ev->keyname, "KP_Down")))
|
|
{
|
|
l = wd->selected_item->node->next;
|
|
if ((!l) && (wd->round))
|
|
l = wd->items;
|
|
}
|
|
else if (!strcmp(ev->keyname, "Home"))
|
|
l = wd->items;
|
|
else if (!strcmp(ev->keyname, "End"))
|
|
l = eina_list_last(wd->items);
|
|
else return EINA_FALSE;
|
|
|
|
if (l)
|
|
it = eina_list_data_get(l);
|
|
|
|
if (it)
|
|
{
|
|
wd->selected_item = it;
|
|
if (!wd->idler)
|
|
wd->idler = ecore_idler_add(_move_scroller, obj);
|
|
}
|
|
|
|
ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
|
|
return EINA_TRUE;
|
|
}
|
|
|
|
static int
|
|
_check_letter(const char *str, int length)
|
|
{
|
|
int code = str[length];
|
|
|
|
if (code == '\0')
|
|
return length; // null string
|
|
else if (((code >= 65) && (code <= 90)) || ((code >= 97) && (code <= 122)))
|
|
return length; // alphabet
|
|
else if ((48 <= code) && (code < 58))
|
|
return length; // number
|
|
else if (((33 <= code) && (code < 47)) || ((58 <= code) && (code < 64))
|
|
|| ((91 <= code) && (code < 96)) || ((123 <= code) && (code < 126)))
|
|
return length; // special letter
|
|
return length - 1;
|
|
}
|
|
|
|
static Eina_Bool
|
|
_check_string(void *data)
|
|
{
|
|
int mid, steps, length, diff;
|
|
Elm_Diskpicker_Item *it;
|
|
Eina_List *list, *l;
|
|
Evas_Coord ox, ow;
|
|
char buf[1024];
|
|
Widget_Data *wd = data;
|
|
|
|
evas_object_geometry_get(wd->scroller, &ox, NULL, &ow, NULL);
|
|
if (ow <= 0)
|
|
return EINA_FALSE;
|
|
if (!wd->init)
|
|
return EINA_FALSE;
|
|
if (!wd->round)
|
|
list = wd->items;
|
|
else
|
|
list = wd->r_items;
|
|
|
|
EINA_LIST_FOREACH(list, l, it)
|
|
{
|
|
Evas_Coord x, w;
|
|
int len;
|
|
evas_object_geometry_get(it->base.view, &x, NULL, &w, NULL);
|
|
/* item not visible */
|
|
if ((x + w <= ox) || (x >= ox + ow))
|
|
continue;
|
|
|
|
len = eina_stringshare_strlen(it->label);
|
|
|
|
if (x <= ox + 5)
|
|
edje_object_signal_emit(it->base.view, "elm,state,left_side",
|
|
"elm");
|
|
else if (x + w >= ox + ow - 5)
|
|
edje_object_signal_emit(it->base.view, "elm,state,right_side",
|
|
"elm");
|
|
else
|
|
{
|
|
if ((wd->len_threshold) && (len > wd->len_threshold))
|
|
edje_object_signal_emit(it->base.view, "elm,state,center_small",
|
|
"elm");
|
|
else
|
|
edje_object_signal_emit(it->base.view, "elm,state,center",
|
|
"elm");
|
|
}
|
|
|
|
if (len <= wd->len_side)
|
|
continue;
|
|
|
|
steps = len - wd->len_side + 1;
|
|
mid = x + w / 2;
|
|
if (mid <= ox + ow / 2)
|
|
diff = (ox + ow / 2) - mid;
|
|
else
|
|
diff = mid - (ox + ow / 2);
|
|
|
|
length = len - (int)(diff * steps / (ow / 3));
|
|
length = MAX(length, wd->len_side);
|
|
length = _check_letter(it->label, length);
|
|
strncpy(buf, it->label, length);
|
|
buf[length] = '\0';
|
|
edje_object_part_text_set(it->base.view, "elm.text", buf);
|
|
}
|
|
|
|
if (wd->check_idler)
|
|
ecore_idler_del(wd->check_idler);
|
|
wd->check_idler = NULL;
|
|
return EINA_FALSE;
|
|
}
|
|
|
|
static void
|
|
_scroller_move_cb(void *data, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
|
|
{
|
|
Evas_Coord x, y, w, h, bw;
|
|
Widget_Data *wd = data;
|
|
|
|
_check_string(wd);
|
|
elm_smart_scroller_child_pos_get(obj, &x, &y);
|
|
elm_smart_scroller_child_viewport_size_get(obj, &w, &h);
|
|
if (wd->round)
|
|
{
|
|
evas_object_geometry_get(wd->main_box, NULL, NULL, &bw, NULL);
|
|
if (x > w / 3 * (wd->item_count + 1))
|
|
elm_smart_scroller_child_region_show(wd->scroller,
|
|
x - w / 3 * wd->item_count,
|
|
y, w, h);
|
|
else if (x < 0)
|
|
elm_smart_scroller_child_region_show(wd->scroller,
|
|
x + w / 3 * wd->item_count,
|
|
y, w, h);
|
|
}
|
|
}
|
|
|
|
static void
|
|
_scroller_stop_cb(void *data, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
|
|
{
|
|
Elm_Diskpicker_Item *it;
|
|
Widget_Data *wd = data;
|
|
Evas_Coord x, w, ow;
|
|
Eina_List *l, *list;
|
|
|
|
if (wd->idler)
|
|
return;
|
|
|
|
if (!wd->round)
|
|
list = wd->items;
|
|
else
|
|
list = wd->r_items;
|
|
|
|
evas_object_geometry_get(wd->scroller, NULL, NULL, &ow, NULL);
|
|
EINA_LIST_FOREACH(list, l, it)
|
|
{
|
|
evas_object_geometry_get(it->base.view, &x, NULL, &w, NULL);
|
|
if (abs((int)(ow / 2 - (int)(x + w / 2))) < 10)
|
|
break;
|
|
}
|
|
|
|
if (!it)
|
|
return;
|
|
|
|
_select_item(it);
|
|
}
|
|
|
|
static Eina_Bool
|
|
_move_scroller(void *data)
|
|
{
|
|
Evas_Object *obj = data;
|
|
Widget_Data *wd;
|
|
Eina_List *l;
|
|
Elm_Diskpicker_Item *dit;
|
|
Evas_Coord y, w, h;
|
|
int i;
|
|
|
|
wd = elm_widget_data_get(obj);
|
|
if (!wd) return EINA_FALSE;
|
|
|
|
if (wd->round)
|
|
i = 1;
|
|
else
|
|
i = 0;
|
|
|
|
EINA_LIST_FOREACH(wd->items, l, dit)
|
|
{
|
|
if (wd->selected_item == dit)
|
|
break;
|
|
i++;
|
|
}
|
|
if (!dit)
|
|
{
|
|
wd->selected_item =
|
|
(Elm_Diskpicker_Item *) eina_list_nth(wd->items, 0);
|
|
return EINA_FALSE;
|
|
}
|
|
|
|
evas_object_geometry_get(wd->scroller, NULL, &y, &w, &h);
|
|
elm_smart_scroller_child_region_show(wd->scroller, w / 3 * i, y, w, h);
|
|
_select_item(dit);
|
|
if (wd->idler)
|
|
{
|
|
ecore_idler_del(wd->idler);
|
|
wd->idler = NULL;
|
|
}
|
|
wd->init = EINA_TRUE;
|
|
_check_string(wd);
|
|
|
|
return EINA_TRUE;
|
|
}
|
|
|
|
static void
|
|
_round_item_del(Widget_Data *wd, Elm_Diskpicker_Item *it)
|
|
{
|
|
if (!it) return;
|
|
elm_box_unpack(wd->main_box, it->base.view);
|
|
wd->r_items = eina_list_remove(wd->r_items, it);
|
|
eina_stringshare_del(it->label);
|
|
evas_object_del(it->base.view);
|
|
free(it);
|
|
}
|
|
|
|
static void
|
|
_round_items_del(Widget_Data *wd)
|
|
{
|
|
_round_item_del(wd, wd->last);
|
|
wd->last = NULL;
|
|
_round_item_del(wd, wd->s_last);
|
|
wd->s_last = NULL;
|
|
_round_item_del(wd, wd->second);
|
|
wd->second = NULL;
|
|
_round_item_del(wd, wd->first);
|
|
wd->first = NULL;
|
|
}
|
|
|
|
static void
|
|
_round_items_add(Widget_Data *wd)
|
|
{
|
|
Elm_Diskpicker_Item *dit;
|
|
Elm_Diskpicker_Item *it;
|
|
|
|
dit = it = eina_list_nth(wd->items, 0);
|
|
if (!dit) return;
|
|
|
|
if (!wd->first)
|
|
{
|
|
wd->first = _item_new(it->base.widget, it->icon, it->label, it->func,
|
|
it->base.data);
|
|
wd->first->node = it->node;
|
|
wd->r_items = eina_list_append(wd->r_items, wd->first);
|
|
}
|
|
|
|
it = eina_list_nth(wd->items, 1);
|
|
if (!it)
|
|
it = dit;
|
|
if (!wd->second)
|
|
{
|
|
wd->second = _item_new(it->base.widget, it->icon, it->label, it->func,
|
|
it->base.data);
|
|
wd->second->node = it->node;
|
|
wd->r_items = eina_list_append(wd->r_items, wd->second);
|
|
}
|
|
|
|
it = eina_list_nth(wd->items, wd->item_count - 1);
|
|
if (!it)
|
|
it = dit;
|
|
if (!wd->last)
|
|
{
|
|
wd->last = _item_new(it->base.widget, it->icon, it->label, it->func,
|
|
it->base.data);
|
|
wd->last->node = it->node;
|
|
wd->r_items = eina_list_prepend(wd->r_items, wd->last);
|
|
}
|
|
|
|
it = eina_list_nth(wd->items, wd->item_count - 2);
|
|
if (!it)
|
|
it = dit;
|
|
if (!wd->s_last)
|
|
{
|
|
wd->s_last = _item_new(it->base.widget, it->icon, it->label, it->func,
|
|
it->base.data);
|
|
wd->s_last->node = it->node;
|
|
wd->r_items = eina_list_prepend(wd->r_items, wd->s_last);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Add a new diskpicker object
|
|
*
|
|
* @param parent The parent object
|
|
* @return The new object or NULL if it cannot be created
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI Evas_Object *
|
|
elm_diskpicker_add(Evas_Object *parent)
|
|
{
|
|
Evas_Object *obj;
|
|
Widget_Data *wd;
|
|
|
|
wd = ELM_NEW(Widget_Data);
|
|
wd->self = obj = elm_widget_add(evas_object_evas_get(parent));
|
|
ELM_SET_WIDTYPE(widtype, "diskpicker");
|
|
elm_widget_type_set(obj, "diskpicker");
|
|
elm_widget_sub_object_add(parent, obj);
|
|
elm_widget_data_set(obj, wd);
|
|
elm_widget_del_hook_set(obj, _del_hook);
|
|
elm_widget_del_pre_hook_set(obj, _del_pre_hook);
|
|
elm_widget_theme_hook_set(obj, _theme_hook);
|
|
elm_widget_can_focus_set(obj, EINA_TRUE);
|
|
elm_widget_on_focus_hook_set(obj, _on_focus_hook, NULL);
|
|
elm_widget_event_hook_set(obj, _event_hook);
|
|
|
|
wd->item_count = 0;
|
|
wd->round = EINA_FALSE;
|
|
wd->init = EINA_FALSE;
|
|
wd->len_side = 3;
|
|
|
|
wd->scroller = elm_smart_scroller_add(evas_object_evas_get(parent));
|
|
elm_smart_scroller_widget_set(wd->scroller, obj);
|
|
_theme_hook(obj);
|
|
elm_widget_resize_object_set(obj, wd->scroller);
|
|
elm_smart_scroller_policy_set(wd->scroller, ELM_SMART_SCROLLER_POLICY_OFF,
|
|
ELM_SMART_SCROLLER_POLICY_OFF);
|
|
elm_smart_scroller_bounce_allow_set(wd->scroller, EINA_TRUE, EINA_FALSE);
|
|
evas_object_smart_callback_add(wd->scroller, "scroll", _scroller_move_cb,
|
|
wd);
|
|
evas_object_smart_callback_add(wd->scroller, "animate,stop",
|
|
_scroller_stop_cb, wd);
|
|
_elm_theme_object_set(obj, wd->scroller, "diskpicker", "base",
|
|
"default");
|
|
evas_object_event_callback_add(wd->scroller, EVAS_CALLBACK_RESIZE,
|
|
_diskpicker_object_resize, obj);
|
|
|
|
wd->main_box = elm_box_add(parent);
|
|
elm_box_horizontal_set(wd->main_box, EINA_TRUE);
|
|
elm_box_homogenous_set(wd->main_box, EINA_TRUE);
|
|
evas_object_size_hint_weight_set(wd->main_box, EVAS_HINT_EXPAND,
|
|
EVAS_HINT_EXPAND);
|
|
evas_object_size_hint_align_set(wd->main_box, EVAS_HINT_FILL,
|
|
EVAS_HINT_FILL);
|
|
_elm_theme_object_set(obj, wd->main_box, "diskpicker", "base",
|
|
"default");
|
|
elm_widget_sub_object_add(obj, wd->main_box);
|
|
|
|
elm_smart_scroller_child_set(wd->scroller, wd->main_box);
|
|
|
|
wd->left_blank = edje_object_add(evas_object_evas_get(obj));
|
|
_elm_theme_object_set(obj, wd->left_blank, "diskpicker", "item",
|
|
"default");
|
|
evas_object_size_hint_weight_set(wd->left_blank, EVAS_HINT_EXPAND,
|
|
EVAS_HINT_EXPAND);
|
|
evas_object_size_hint_align_set(wd->left_blank, EVAS_HINT_FILL,
|
|
EVAS_HINT_FILL);
|
|
elm_box_pack_end(wd->main_box, wd->left_blank);
|
|
evas_object_show(wd->left_blank);
|
|
|
|
wd->right_blank = edje_object_add(evas_object_evas_get(obj));
|
|
_elm_theme_object_set(obj, wd->right_blank, "diskpicker", "item",
|
|
"default");
|
|
evas_object_size_hint_weight_set(wd->right_blank, EVAS_HINT_EXPAND,
|
|
EVAS_HINT_EXPAND);
|
|
evas_object_size_hint_align_set(wd->right_blank, EVAS_HINT_FILL,
|
|
EVAS_HINT_FILL);
|
|
elm_box_pack_end(wd->main_box, wd->right_blank);
|
|
evas_object_show(wd->right_blank);
|
|
|
|
_theme_data_get(wd);
|
|
|
|
evas_object_smart_callback_add(obj, "sub-object-del", _sub_del, obj);
|
|
evas_object_smart_callbacks_descriptions_set(obj, _signals);
|
|
_sizing_eval(obj);
|
|
return obj;
|
|
}
|
|
|
|
/**
|
|
* Get round mode
|
|
*
|
|
* If round mode is activated the items list will work like a circle list,
|
|
* so when the user reaches the last item, the first one will popup.
|
|
*
|
|
* @param obj The diskpicker object
|
|
* @return if or not set round mode or false if not a valid diskpicker
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI Eina_Bool
|
|
elm_diskpicker_round_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->round;
|
|
}
|
|
|
|
/**
|
|
* Set round mode
|
|
*
|
|
* If round mode is activated the items list will work like a circle list,
|
|
* so when the user reaches the last item, the first one will popup.
|
|
*
|
|
* @param it The item of diskpicker
|
|
* @param if or not set round mode
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_round_set(Evas_Object * obj, Eina_Bool round)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
|
|
if (wd->round == round)
|
|
return;
|
|
|
|
wd->round = round;
|
|
if (round)
|
|
{
|
|
wd->r_items = eina_list_clone(wd->items);
|
|
elm_box_unpack(wd->main_box, wd->left_blank);
|
|
evas_object_hide(wd->left_blank);
|
|
elm_box_unpack(wd->main_box, wd->right_blank);
|
|
evas_object_hide(wd->right_blank);
|
|
if (!wd->items)
|
|
return;
|
|
|
|
_round_items_add(wd);
|
|
|
|
if (wd->last)
|
|
elm_box_pack_start(wd->main_box, wd->last->base.view);
|
|
if (wd->s_last)
|
|
elm_box_pack_start(wd->main_box, wd->s_last->base.view);
|
|
if (wd->first)
|
|
elm_box_pack_end(wd->main_box, wd->first->base.view);
|
|
if (wd->second)
|
|
elm_box_pack_end(wd->main_box, wd->second->base.view);
|
|
}
|
|
else
|
|
{
|
|
_round_items_del(wd);
|
|
elm_box_pack_start(wd->main_box, wd->left_blank);
|
|
elm_box_pack_end(wd->main_box, wd->right_blank);
|
|
eina_list_free(wd->r_items);
|
|
wd->r_items = NULL;
|
|
}
|
|
_sizing_eval(obj);
|
|
}
|
|
|
|
/**
|
|
* Get the side labels max lenght
|
|
*
|
|
* @param obj The diskpicker object
|
|
* @return The max lenght defined for side labels, or 0 if not a valid
|
|
* diskpicker
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI int
|
|
elm_diskpicker_side_label_lenght_get(const Evas_Object *obj)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype) 0;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return 0;
|
|
return wd->len_side;
|
|
}
|
|
|
|
/**
|
|
* Set the side labels max lenght
|
|
*
|
|
* @param obj The diskpicker object
|
|
* @param len The max lenght defined for side labels
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_side_label_lenght_set(Evas_Object *obj, int len)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
wd->len_side = len;
|
|
}
|
|
|
|
/**
|
|
* Set bounce mode
|
|
*
|
|
* This will enable or disable the scroller bounce mode for the diskpicker.
|
|
* See elm_scroller_bounce_set() for details. Horizontal bounce is enabled by
|
|
* default.
|
|
*
|
|
* @param obj The diskpicker object
|
|
* @param h_bounce Allow bounce horizontally
|
|
* @param v_bounce Allow bounce vertically
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_bounce_set(Evas_Object *obj, Eina_Bool h_bounce, Eina_Bool v_bounce)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
if (wd->scroller)
|
|
elm_smart_scroller_bounce_allow_set(wd->scroller, h_bounce, v_bounce);
|
|
}
|
|
|
|
/**
|
|
* Get the scrollbar policy
|
|
*
|
|
* This sets the scrollbar visibility policy for the given scroller.
|
|
* ELM_SMART_SCROLLER_POLICY_AUTO means the scrollber is made visible if it
|
|
* is needed, and otherwise kept hidden. ELM_SMART_SCROLLER_POLICY_ON turns
|
|
* it on all the time, and ELM_SMART_SCROLLER_POLICY_OFF always keeps it off.
|
|
* This applies respectively for the horizontal and vertical scrollbars.
|
|
* The both are disabled by default.
|
|
*
|
|
* @param obj The diskpicker object
|
|
* @param policy_h Horizontal scrollbar policy
|
|
* @param policy_v Vertical scrollbar policy
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
|
|
EAPI void
|
|
elm_diskpicker_scroller_policy_get(const Evas_Object *obj, Elm_Scroller_Policy *policy_h, Elm_Scroller_Policy *policy_v)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Elm_Smart_Scroller_Policy s_policy_h, s_policy_v;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if ((!wd) || (!wd->scroller)) return;
|
|
elm_smart_scroller_policy_get(wd->scroller, &s_policy_h, &s_policy_v);
|
|
*policy_h = (Elm_Scroller_Policy) s_policy_h;
|
|
*policy_v = (Elm_Scroller_Policy) s_policy_v;
|
|
}
|
|
|
|
|
|
/**
|
|
* Set the scrollbar policy
|
|
*
|
|
* This sets the scrollbar visibility policy for the given scroller.
|
|
* ELM_SMART_SCROLLER_POLICY_AUTO means the scrollber is made visible if it
|
|
* is needed, and otherwise kept hidden. ELM_SMART_SCROLLER_POLICY_ON turns
|
|
* it on all the time, and ELM_SMART_SCROLLER_POLICY_OFF always keeps it off.
|
|
* This applies respectively for the horizontal and vertical scrollbars.
|
|
* The both are disabled by default.
|
|
*
|
|
* @param obj The diskpicker object
|
|
* @param policy_h Horizontal scrollbar policy
|
|
* @param policy_v Vertical scrollbar policy
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_scroller_policy_set(Evas_Object *obj, Elm_Scroller_Policy policy_h, Elm_Scroller_Policy policy_v)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
if ((policy_h >= 3) || (policy_v >= 3)) return;
|
|
if (wd->scroller)
|
|
elm_smart_scroller_policy_set(wd->scroller, policy_h, policy_v);
|
|
}
|
|
|
|
/**
|
|
* Clears a diskpicker of all items.
|
|
*
|
|
* @param obj The diskpicker object
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_clear(Evas_Object *obj)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
Elm_Diskpicker_Item *it;
|
|
|
|
if (!wd) return;
|
|
if (!wd->items) return;
|
|
|
|
wd->selected_item = NULL;
|
|
EINA_LIST_FREE(wd->items, it) _item_del(it);
|
|
_round_items_del(wd);
|
|
_sizing_eval(obj);
|
|
}
|
|
|
|
/**
|
|
* Returns a list of all the diskpicker items.
|
|
*
|
|
* @param obj The diskpicker object
|
|
* @return An Eina_List* of the diskpicker items, or NULL on failure
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI const Eina_List *
|
|
elm_diskpicker_items_get(const Evas_Object *obj)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype) NULL;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return NULL;
|
|
return wd->items;
|
|
}
|
|
|
|
/**
|
|
* Appends an item to the diskpicker object.
|
|
*
|
|
* @param obj The diskpicker object
|
|
* @param label The label of the diskpicker item
|
|
* @param icon The icon object to use for the left side of the item
|
|
* @param func The function to call when the item is selected
|
|
* @param data The data to associate with the item for related callbacks
|
|
*
|
|
* @return The created item or NULL upon failure
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI Elm_Diskpicker_Item *
|
|
elm_diskpicker_item_append(Evas_Object *obj, const char *label, Evas_Object *icon, Evas_Smart_Cb func, const void *data)
|
|
{
|
|
Elm_Diskpicker_Item *it;
|
|
ELM_CHECK_WIDTYPE(obj, widtype) NULL;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return NULL;
|
|
|
|
it = _item_new(obj, icon, label, func, data);
|
|
wd->items = eina_list_append(wd->items, it);
|
|
it->node = eina_list_last(wd->items);
|
|
wd->item_count++;
|
|
if (wd->round)
|
|
{
|
|
_round_items_del(wd);
|
|
wd->r_items = eina_list_append(wd->r_items, it);
|
|
_round_items_add(wd);
|
|
if (wd->last)
|
|
elm_box_pack_start(wd->main_box, wd->last->base.view);
|
|
if (wd->s_last)
|
|
elm_box_pack_start(wd->main_box, wd->s_last->base.view);
|
|
elm_box_pack_end(wd->main_box, it->base.view);
|
|
if (wd->first)
|
|
elm_box_pack_end(wd->main_box, wd->first->base.view);
|
|
if (wd->second)
|
|
elm_box_pack_end(wd->main_box, wd->second->base.view);
|
|
}
|
|
else
|
|
{
|
|
elm_box_unpack(wd->main_box, wd->right_blank);
|
|
elm_box_pack_end(wd->main_box, it->base.view);
|
|
elm_box_pack_end(wd->main_box, wd->right_blank);
|
|
}
|
|
if (!wd->selected_item)
|
|
wd->selected_item = it;
|
|
if (!wd->idler)
|
|
wd->idler = ecore_idler_add(_move_scroller, obj);
|
|
_sizing_eval(obj);
|
|
return it;
|
|
}
|
|
|
|
/**
|
|
* Delete the item
|
|
*
|
|
* @param it The item of diskpicker
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_del(Elm_Diskpicker_Item * it)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(it);
|
|
Elm_Diskpicker_Item *dit;
|
|
Widget_Data *wd = elm_widget_data_get(it->base.widget);
|
|
if (!wd) return;
|
|
|
|
elm_box_unpack(wd->main_box, it->base.view);
|
|
|
|
if (wd->round)
|
|
wd->r_items = eina_list_remove(wd->r_items, it);
|
|
|
|
wd->items = eina_list_remove(wd->items, it);
|
|
|
|
if (wd->selected_item == it)
|
|
{
|
|
dit = (Elm_Diskpicker_Item *) eina_list_nth(wd->items, 0);
|
|
if (dit != it)
|
|
wd->selected_item = dit;
|
|
else
|
|
wd->selected_item = eina_list_nth(wd->items, 1);
|
|
}
|
|
|
|
_item_del(it);
|
|
wd->item_count -= 1;
|
|
|
|
if (wd->round)
|
|
{
|
|
if (!wd->item_count)
|
|
{
|
|
evas_object_hide(wd->first->base.view);
|
|
evas_object_hide(wd->second->base.view);
|
|
evas_object_hide(wd->last->base.view);
|
|
evas_object_hide(wd->s_last->base.view);
|
|
}
|
|
else
|
|
{
|
|
dit = eina_list_nth(wd->items, 0);
|
|
if (dit)
|
|
{
|
|
eina_stringshare_replace(&wd->first->label, dit->label);
|
|
edje_object_part_text_set(wd->first->base.view, "elm.text",
|
|
wd->first->label);
|
|
}
|
|
dit = eina_list_nth(wd->items, 1);
|
|
if (dit)
|
|
{
|
|
eina_stringshare_replace(&wd->second->label, dit->label);
|
|
edje_object_part_text_set(wd->second->base.view, "elm.text",
|
|
wd->second->label);
|
|
}
|
|
dit = eina_list_nth(wd->items, eina_list_count(wd->items) - 1);
|
|
if (dit)
|
|
{
|
|
eina_stringshare_replace(&wd->last->label, dit->label);
|
|
edje_object_part_text_set(wd->last->base.view, "elm.text",
|
|
wd->last->label);
|
|
}
|
|
dit = eina_list_nth(wd->items, eina_list_count(wd->items) - 2);
|
|
if (dit)
|
|
{
|
|
eina_stringshare_replace(&wd->s_last->label, dit->label);
|
|
edje_object_part_text_set(wd->s_last->base.view, "elm.text",
|
|
wd->s_last->label);
|
|
}
|
|
}
|
|
}
|
|
wd->check_idler = ecore_idler_add(_check_string, wd);
|
|
_sizing_eval(it->base.widget);
|
|
}
|
|
|
|
/**
|
|
* Get the label of item
|
|
*
|
|
* @param it The item of diskpicker
|
|
* @return The label of item
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI const char *
|
|
elm_diskpicker_item_label_get(const Elm_Diskpicker_Item * it)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(it, NULL);
|
|
return it->label;
|
|
}
|
|
|
|
/**
|
|
* Set the label of item
|
|
*
|
|
* @param it The item of diskpicker
|
|
* @param label The label of item
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_label_set(Elm_Diskpicker_Item * it, const char *label)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(it);
|
|
eina_stringshare_replace(&it->label, label);
|
|
edje_object_part_text_set(it->base.view, "elm.text", it->label);
|
|
}
|
|
|
|
/**
|
|
* Get the selected item
|
|
*
|
|
* @param obj The diskpicker object
|
|
* @return The selected diskpicker item
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI Elm_Diskpicker_Item *
|
|
elm_diskpicker_item_selected_get(const Evas_Object *obj)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype) NULL;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return NULL;
|
|
return wd->selected_item;
|
|
}
|
|
|
|
/**
|
|
* Set the selected item
|
|
*
|
|
* @param it The item of diskpicker
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_selected_set(Elm_Diskpicker_Item * it)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(it);
|
|
Widget_Data *wd;
|
|
wd = elm_widget_data_get(it->base.widget);
|
|
if (!wd) return;
|
|
|
|
wd->selected_item = it;
|
|
if (!wd->idler)
|
|
ecore_idler_add(_move_scroller, it->base.widget);
|
|
}
|
|
|
|
/**
|
|
* Set the function called when a diskpicker item is freed.
|
|
*
|
|
* @param it The item to set the callback on
|
|
* @param func The function called
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_del_cb_set(Elm_Diskpicker_Item *it, Evas_Smart_Cb func)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(it);
|
|
elm_widget_item_del_cb_set(it, func);
|
|
}
|
|
|
|
/**
|
|
* Returns the data associated with the item.
|
|
*
|
|
* @param it The diskpicker item
|
|
* @return The data associated with @p it
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void *
|
|
elm_diskpicker_item_data_get(const Elm_Diskpicker_Item *it)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(it, NULL);
|
|
return elm_widget_item_data_get(it);
|
|
}
|
|
|
|
/**
|
|
* Returns the icon associated with the item.
|
|
*
|
|
* @param it The diskpicker item
|
|
* @return The icon associated with @p it
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI Evas_Object *
|
|
elm_diskpicker_item_icon_get(const Elm_Diskpicker_Item *it)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(it, NULL);
|
|
return it->icon;
|
|
}
|
|
|
|
/**
|
|
* Sets the icon associated with the item.
|
|
*
|
|
* Once the icon object is set, a previously set one will be deleted.
|
|
* You probably don't want, then, to have the <b>same</b> icon object set
|
|
* for more than one item of the diskpicker.
|
|
*
|
|
* @param it The diskpicker item
|
|
* @param icon The icon object to associate with @p it
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_icon_set(Elm_Diskpicker_Item *it, Evas_Object *icon)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(it);
|
|
if (it->icon == icon) return;
|
|
if (it->icon)
|
|
evas_object_del(it->icon);
|
|
it->icon = icon;
|
|
if (it->base.view)
|
|
edje_object_part_swallow(it->base.view, "elm.swallow.icon", icon);
|
|
}
|
|
|
|
/**
|
|
* Gets the item before @p it in the list.
|
|
*
|
|
* @param it The diskpicker item
|
|
* @return The item before @p it, or NULL on failure
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI Elm_Diskpicker_Item *
|
|
elm_diskpicker_item_prev(const Elm_Diskpicker_Item *it)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(it, NULL);
|
|
if (it->node->prev) return it->node->prev->data;
|
|
else return NULL;
|
|
}
|
|
|
|
/**
|
|
* Gets the item after @p it in the list.
|
|
*
|
|
* @param it The diskpicker item
|
|
* @return The item after @p it, or NULL on failure
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI Elm_Diskpicker_Item *
|
|
elm_diskpicker_item_next(const Elm_Diskpicker_Item *it)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(it, NULL);
|
|
if (it->node->next) return it->node->next->data;
|
|
else return NULL;
|
|
}
|
|
|
|
/**
|
|
* Set the text to be shown in the diskpicker item.
|
|
*
|
|
* @param item Target item
|
|
* @param text The text to set in the content
|
|
*
|
|
* Setup the text as tooltip to object. The item can have only one tooltip,
|
|
* so any previous tooltip data is removed.
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_tooltip_text_set(Elm_Diskpicker_Item *item, const char *text)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(item);
|
|
elm_widget_item_tooltip_text_set(item, text);
|
|
}
|
|
|
|
/**
|
|
* Set the content to be shown in the tooltip item
|
|
*
|
|
* Setup the tooltip to item. The item can have only one tooltip,
|
|
* so any previous tooltip data is removed. @p func(with @p data) will
|
|
* be called every time that need show the tooltip and it should
|
|
* return a valid Evas_Object. This object is then managed fully by
|
|
* tooltip system and is deleted when the tooltip is gone.
|
|
*
|
|
* @param item the diskpicker item being attached a tooltip.
|
|
* @param func the function used to create the tooltip contents.
|
|
* @param data what to provide to @a func as callback data/context.
|
|
* @param del_cb called when data is not needed anymore, either when
|
|
* another callback replaces @func, the tooltip is unset with
|
|
* elm_diskpicker_item_tooltip_unset() or the owner @a item
|
|
* dies. This callback receives as the first parameter the
|
|
* given @a data, and @c event_info is the item.
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_tooltip_content_cb_set(Elm_Diskpicker_Item *item, Elm_Tooltip_Item_Content_Cb func, const void *data, Evas_Smart_Cb del_cb)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(item);
|
|
elm_widget_item_tooltip_content_cb_set(item, func, data, del_cb);
|
|
}
|
|
|
|
/**
|
|
* Unset tooltip from item
|
|
*
|
|
* @param item diskpicker item to remove previously set tooltip.
|
|
*
|
|
* Remove tooltip from item. The callback provided as del_cb to
|
|
* elm_diskpicker_item_tooltip_content_cb_set() will be called to notify
|
|
* it is not used anymore.
|
|
*
|
|
* @see elm_diskpicker_item_tooltip_content_cb_set()
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_tooltip_unset(Elm_Diskpicker_Item *item)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(item);
|
|
elm_widget_item_tooltip_unset(item);
|
|
}
|
|
|
|
/**
|
|
* Sets a different style for this item tooltip.
|
|
*
|
|
* @note before you set a style you should define a tooltip with
|
|
* elm_diskpicker_item_tooltip_content_cb_set() or
|
|
* elm_diskpicker_item_tooltip_text_set()
|
|
*
|
|
* @param item diskpicker item with tooltip already set.
|
|
* @param style the theme style to use (default, transparent, ...)
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_tooltip_style_set(Elm_Diskpicker_Item *item, const char *style)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(item);
|
|
elm_widget_item_tooltip_style_set(item, style);
|
|
}
|
|
|
|
/**
|
|
* Get the style for this item tooltip.
|
|
*
|
|
* @param item diskpicker item with tooltip already set.
|
|
* @return style the theme style in use, defaults to "default". If the
|
|
* object does not have a tooltip set, then NULL is returned.
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI const char *
|
|
elm_diskpicker_item_tooltip_style_get(const Elm_Diskpicker_Item *item)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(item, NULL);
|
|
return elm_widget_item_tooltip_style_get(item);
|
|
}
|
|
|
|
/**
|
|
* Set the cursor to be shown when mouse is over the diskpicker item
|
|
*
|
|
* @param item Target item
|
|
* @param cursor the cursor name to be used.
|
|
*
|
|
* @see elm_object_cursor_set()
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_cursor_set(Elm_Diskpicker_Item *item, const char *cursor)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(item);
|
|
elm_widget_item_cursor_set(item, cursor);
|
|
}
|
|
|
|
/**
|
|
* Unset the cursor to be shown when mouse is over the diskpicker item
|
|
*
|
|
* @param item Target item
|
|
*
|
|
* @see elm_object_cursor_unset()
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_cursor_unset(Elm_Diskpicker_Item *item)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(item);
|
|
elm_widget_item_cursor_unset(item);
|
|
}
|
|
|
|
/**
|
|
* Sets a different style for this item cursor.
|
|
*
|
|
* @note before you set a style you should define a cursor with
|
|
* elm_diskpicker_item_cursor_set()
|
|
*
|
|
* @param item diskpicker item with cursor already set.
|
|
* @param style the theme style to use (default, transparent, ...)
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_cursor_style_set(Elm_Diskpicker_Item *item, const char *style)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(item);
|
|
elm_widget_item_cursor_style_set(item, style);
|
|
}
|
|
|
|
/**
|
|
* Get the style for this item cursor.
|
|
*
|
|
* @param item diskpicker item with cursor already set.
|
|
* @return style the theme style in use, defaults to "default". If the
|
|
* object does not have a cursor set, then NULL is returned.
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI const char *
|
|
elm_diskpicker_item_cursor_style_get(const Elm_Diskpicker_Item *item)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(item, NULL);
|
|
return elm_widget_item_cursor_style_get(item);
|
|
}
|
|
|
|
/**
|
|
* Set if the cursor set should be searched on the theme or should use
|
|
* the provided by the engine, only.
|
|
*
|
|
* @note before you set if should look on theme you should define a cursor
|
|
* with elm_object_cursor_set(). By default it will only look for cursors
|
|
* provided by the engine.
|
|
*
|
|
* @param item widget item with cursor already set.
|
|
* @param engine_only boolean to define it cursors should be looked only
|
|
* between the provided by the engine or searched on widget's theme as well.
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI void
|
|
elm_diskpicker_item_cursor_engine_only_set(Elm_Diskpicker_Item *item, Eina_Bool engine_only)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(item);
|
|
elm_widget_item_cursor_engine_only_set(item, engine_only);
|
|
}
|
|
|
|
/**
|
|
* Get the cursor engine only usage for this item cursor.
|
|
*
|
|
* @param item widget item with cursor already set.
|
|
* @return engine_only boolean to define it cursors should be looked only
|
|
* between the provided by the engine or searched on widget's theme as well. If
|
|
* the object does not have a cursor set, then EINA_FALSE is returned.
|
|
*
|
|
* @ingroup Diskpicker
|
|
*/
|
|
EAPI Eina_Bool
|
|
elm_diskpicker_item_cursor_engine_only_get(const Elm_Diskpicker_Item *item)
|
|
{
|
|
ELM_DISKPICKER_ITEM_CHECK_OR_RETURN(item, EINA_FALSE);
|
|
return elm_widget_item_cursor_engine_only_get(item);
|
|
}
|