996 lines
27 KiB
C
996 lines
27 KiB
C
#include <Elementary.h>
|
|
#include "elm_priv.h"
|
|
|
|
/**
|
|
* @defgroup Slideshow Slideshow
|
|
*
|
|
* This object display a list of object (generally a list of images) and some actions like
|
|
* next/previous are used to navigate. The animations are defined in the theme,
|
|
* consequently new animations can be added without having to update the
|
|
* applications.
|
|
*
|
|
* The slideshow use 2 callbacks to create and delete the objects displayed. When an item
|
|
* is displayed the function itc->func.get() is called. This function should create the object,
|
|
* for example the object can be an evas_object_image or a photocam. When an object is no more
|
|
* displayed the function itc->func.del() is called, the user can delete the dana associated to the item.
|
|
*
|
|
* Signals that you can add callbacks for are:
|
|
*
|
|
* "changed" - when the slideshow switch to another item
|
|
*/
|
|
|
|
typedef struct _Widget_Data Widget_Data;
|
|
|
|
struct _Elm_Slideshow_Item
|
|
{
|
|
Elm_Widget_Item base;
|
|
|
|
Eina_List *l, *l_built;
|
|
|
|
const Elm_Slideshow_Item_Class *itc;
|
|
};
|
|
|
|
struct _Widget_Data
|
|
{
|
|
Evas_Object *slideshow;
|
|
|
|
// list of Elm_Slideshow_Item*
|
|
Eina_List *items;
|
|
Eina_List *items_built;
|
|
|
|
Elm_Slideshow_Item *current;
|
|
Elm_Slideshow_Item *previous;
|
|
|
|
Eina_List *transitions;
|
|
const char *transition;
|
|
|
|
int count_item_pre_before;
|
|
int count_item_pre_after;
|
|
Ecore_Timer *timer;
|
|
double timeout;
|
|
Eina_Bool loop:1;
|
|
|
|
struct {
|
|
const char *current;
|
|
Eina_List *list; //list of const char *
|
|
} layout;
|
|
};
|
|
|
|
static const char *widtype = NULL;
|
|
static void _del_hook(Evas_Object *obj);
|
|
static void _mirrored_set(Evas_Object *obj, Eina_Bool rtl);
|
|
static void _theme_hook(Evas_Object *obj);
|
|
static void _sizing_eval(Evas_Object *obj);
|
|
static void _changed_size_hints(void *data, Evas *e, Evas_Object *obj, void *event_info);
|
|
static Eina_Bool _timer_cb(void *data);
|
|
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 const char SIG_CHANGED[] = "changed";
|
|
|
|
static const Evas_Smart_Cb_Description _signals[] = {
|
|
{SIG_CHANGED, ""},
|
|
{NULL, NULL}
|
|
};
|
|
|
|
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;
|
|
if ((!strcmp(ev->keyname, "Left")) || (!strcmp(ev->keyname, "KP_Left")))
|
|
{
|
|
elm_slideshow_previous(obj);
|
|
ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
|
|
return EINA_TRUE;
|
|
}
|
|
if ((!strcmp(ev->keyname, "Right")) || (!strcmp(ev->keyname, "KP_Right")))
|
|
{
|
|
elm_slideshow_next(obj);
|
|
ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
|
|
return EINA_TRUE;
|
|
}
|
|
if ((!strcmp(ev->keyname, "Return")) ||
|
|
(!strcmp(ev->keyname, "KP_Enter")) ||
|
|
(!strcmp(ev->keyname, "space")))
|
|
{
|
|
if (wd->timeout)
|
|
{
|
|
if (wd->timer)
|
|
{
|
|
ecore_timer_del(wd->timer);
|
|
wd->timer = NULL;
|
|
}
|
|
else
|
|
elm_slideshow_timeout_set(obj, wd->timeout);
|
|
}
|
|
ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
|
|
return EINA_TRUE;
|
|
}
|
|
return EINA_FALSE;
|
|
}
|
|
|
|
static void
|
|
_del_hook(Evas_Object *obj)
|
|
{
|
|
const char *layout;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
elm_slideshow_clear(obj);
|
|
elm_widget_stringlist_free(wd->transitions);
|
|
if (wd->timer) ecore_timer_del(wd->timer);
|
|
EINA_LIST_FREE(wd->layout.list, layout)
|
|
eina_stringshare_del(layout);
|
|
free(wd);
|
|
}
|
|
|
|
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->slideshow, "elm,action,focus", "elm");
|
|
evas_object_focus_set(wd->slideshow, EINA_TRUE);
|
|
}
|
|
else
|
|
{
|
|
edje_object_signal_emit(wd->slideshow, "elm,action,unfocus", "elm");
|
|
evas_object_focus_set(wd->slideshow, EINA_FALSE);
|
|
}
|
|
}
|
|
|
|
static void
|
|
_mirrored_set(Evas_Object *obj, Eina_Bool rtl)
|
|
{
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
edje_object_mirrored_set(wd->slideshow, rtl);
|
|
}
|
|
|
|
static void
|
|
_theme_hook(Evas_Object *obj)
|
|
{
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
_elm_widget_mirrored_reload(obj);
|
|
_mirrored_set(obj, elm_widget_mirrored_get(obj));
|
|
_elm_theme_object_set(obj, wd->slideshow, "slideshow", "base", elm_widget_style_get(obj));
|
|
edje_object_scale_set(wd->slideshow, elm_widget_scale_get(obj) *
|
|
_elm_config->scale);
|
|
_sizing_eval(obj);
|
|
}
|
|
|
|
static void
|
|
_sizing_eval(Evas_Object *obj)
|
|
{
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
Evas_Coord minw = -1, minh = -1;
|
|
if (!wd) return;
|
|
edje_object_size_min_calc(wd->slideshow, &minw, &minh);
|
|
evas_object_size_hint_min_set(obj, minw, minh);
|
|
evas_object_size_hint_max_set(obj, minw, minh);
|
|
}
|
|
|
|
|
|
static Elm_Slideshow_Item* _item_prev_get(Elm_Slideshow_Item* item)
|
|
{
|
|
Widget_Data *wd = elm_widget_data_get(item->base.widget);
|
|
Elm_Slideshow_Item* prev = eina_list_data_get(eina_list_prev(item->l));
|
|
if ((!prev) && (wd->loop))
|
|
prev = eina_list_data_get(eina_list_last(item->l));
|
|
return prev;
|
|
}
|
|
|
|
static Elm_Slideshow_Item* _item_next_get(Elm_Slideshow_Item* item)
|
|
{
|
|
Widget_Data *wd = elm_widget_data_get(item->base.widget);
|
|
Elm_Slideshow_Item* next = eina_list_data_get(eina_list_next(item->l));
|
|
if ((!next) && (wd->loop))
|
|
next = eina_list_data_get(wd->items);
|
|
return next;
|
|
}
|
|
|
|
static void
|
|
_changed_size_hints(void *data, Evas *e __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
|
|
{
|
|
_sizing_eval(data);
|
|
}
|
|
|
|
static void
|
|
_sub_del(void *data __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
|
|
{
|
|
;
|
|
}
|
|
|
|
static void
|
|
_item_realize(Elm_Slideshow_Item *item)
|
|
{
|
|
Elm_Slideshow_Item *_item_prev, *_item_next;
|
|
Evas_Object *obj = item->base.widget;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
int ac, bc, lc;
|
|
|
|
if (!wd) return;
|
|
if ((!item->base.view) && (item->itc->func.get))
|
|
{
|
|
item->base.view = item->itc->func.get((void*)item->base.data, obj);
|
|
evas_object_smart_member_add(item->base.view, obj);
|
|
item->l_built = eina_list_append(NULL, item);
|
|
wd->items_built = eina_list_merge(wd->items_built, item->l_built);
|
|
evas_object_hide(item->base.view);
|
|
}
|
|
else if (item->l_built)
|
|
wd->items_built = eina_list_demote_list(wd->items_built, item->l_built);
|
|
|
|
//pre-create previous and next item
|
|
ac = wd->count_item_pre_after;
|
|
_item_next = item;
|
|
bc = wd->count_item_pre_before;
|
|
_item_prev = item;
|
|
lc = eina_list_count(wd->items) - 1;
|
|
while (lc > 0 && ((ac > 0) || (bc > 0)))
|
|
{
|
|
if (lc > 0 && ac > 0)
|
|
{
|
|
--ac;
|
|
--lc;
|
|
if (_item_next)
|
|
{
|
|
_item_next = _item_next_get(_item_next);
|
|
if ((_item_next)
|
|
&& (!_item_next->base.view)
|
|
&& (_item_next->itc->func.get))
|
|
{
|
|
_item_next->base.view =
|
|
_item_next->itc->func.get(
|
|
(void*)_item_next->base.data, obj);
|
|
evas_object_smart_member_add(_item_next->base.view, obj);
|
|
_item_next->l_built = eina_list_append(NULL, _item_next);
|
|
wd->items_built = eina_list_merge(wd->items_built,
|
|
_item_next->l_built);
|
|
evas_object_hide(_item_next->base.view);
|
|
}
|
|
else if (_item_next && _item_next->l_built)
|
|
wd->items_built =
|
|
eina_list_demote_list(wd->items_built,
|
|
_item_next->l_built);
|
|
}
|
|
}
|
|
|
|
if (lc > 0 && bc > 0)
|
|
{
|
|
--bc;
|
|
--lc;
|
|
if (_item_prev)
|
|
{
|
|
_item_prev = _item_prev_get(_item_prev);
|
|
if ((_item_prev)
|
|
&& (!_item_prev->base.view)
|
|
&& (_item_prev->itc->func.get))
|
|
{
|
|
_item_prev->base.view =
|
|
_item_prev->itc->func.get(
|
|
(void*)_item_prev->base.data, obj);
|
|
evas_object_smart_member_add(_item_prev->base.view, obj);
|
|
_item_prev->l_built = eina_list_append(NULL, _item_prev);
|
|
wd->items_built = eina_list_merge(wd->items_built,
|
|
_item_prev->l_built);
|
|
evas_object_hide(_item_prev->base.view);
|
|
}
|
|
else if (_item_prev && _item_prev->l_built)
|
|
wd->items_built =
|
|
eina_list_demote_list(wd->items_built,
|
|
_item_prev->l_built);
|
|
}
|
|
}
|
|
}
|
|
|
|
//delete unused items
|
|
lc = wd->count_item_pre_before + wd->count_item_pre_after + 1;
|
|
while ((int)eina_list_count(wd->items_built) > lc)
|
|
{
|
|
item = eina_list_data_get(wd->items_built);
|
|
wd->items_built = eina_list_remove_list(wd->items_built,
|
|
wd->items_built);
|
|
if (item->itc->func.del)
|
|
item->itc->func.del((void*)item->base.data, item->base.view);
|
|
evas_object_del(item->base.view);
|
|
item->base.view = NULL;
|
|
}
|
|
}
|
|
|
|
static void
|
|
_end(void *data, Evas_Object *obj __UNUSED__, const char *emission __UNUSED__, const char *source __UNUSED__)
|
|
{
|
|
Elm_Slideshow_Item *item;
|
|
Widget_Data *wd = elm_widget_data_get(data);
|
|
if (!wd) return;
|
|
|
|
item = wd->previous;
|
|
if (item)
|
|
{
|
|
edje_object_part_unswallow(NULL, item->base.view);
|
|
evas_object_hide(item->base.view);
|
|
wd->previous = NULL;
|
|
}
|
|
|
|
|
|
item = wd->current;
|
|
if ((!item) || (!item->base.view)) return;
|
|
|
|
_item_realize(item);
|
|
edje_object_part_unswallow(NULL, item->base.view);
|
|
evas_object_show(item->base.view);
|
|
|
|
edje_object_signal_emit(wd->slideshow, "anim,end", "slideshow");
|
|
edje_object_part_swallow(wd->slideshow, "elm.swallow.1", item->base.view);
|
|
}
|
|
|
|
static Eina_Bool
|
|
_timer_cb(void *data)
|
|
{
|
|
Evas_Object *obj = data;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return ECORE_CALLBACK_CANCEL;
|
|
wd->timer = NULL;
|
|
elm_slideshow_next(obj);
|
|
return ECORE_CALLBACK_CANCEL;
|
|
}
|
|
|
|
/**
|
|
* Add a new slideshow to the parent
|
|
*
|
|
* @param parent The parent object
|
|
* @return The new object or NULL if it cannot be created
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI Evas_Object *
|
|
elm_slideshow_add(Evas_Object *parent)
|
|
{
|
|
Evas_Object *obj;
|
|
Evas *e;
|
|
Widget_Data *wd;
|
|
|
|
ELM_WIDGET_STANDARD_SETUP(wd, Widget_Data, parent, e, obj, NULL);
|
|
|
|
ELM_SET_WIDTYPE(widtype, "slideshow");
|
|
elm_widget_type_set(obj, "slideshow");
|
|
elm_widget_sub_object_add(parent, obj);
|
|
elm_widget_on_focus_hook_set(obj, _on_focus_hook, NULL);
|
|
elm_widget_data_set(obj, wd);
|
|
elm_widget_del_hook_set(obj, _del_hook);
|
|
elm_widget_theme_hook_set(obj, _theme_hook);
|
|
elm_widget_can_focus_set(obj, EINA_TRUE);
|
|
elm_widget_event_hook_set(obj, _event_hook);
|
|
|
|
wd->current = NULL;
|
|
wd->previous = NULL;
|
|
|
|
wd->slideshow = edje_object_add(e);
|
|
_elm_theme_object_set(obj, wd->slideshow, "slideshow", "base", "default");
|
|
evas_object_smart_member_add(wd->slideshow, obj);
|
|
wd->count_item_pre_before = 2;
|
|
wd->count_item_pre_after = 2;
|
|
elm_widget_resize_object_set(obj, wd->slideshow);
|
|
evas_object_show(wd->slideshow);
|
|
|
|
wd->transitions = elm_widget_stringlist_get(edje_object_data_get(wd->slideshow, "transitions"));
|
|
if (eina_list_count(wd->transitions) > 0)
|
|
wd->transition = eina_stringshare_add(eina_list_data_get(wd->transitions));
|
|
|
|
wd->layout.list = elm_widget_stringlist_get(edje_object_data_get(wd->slideshow, "layouts"));
|
|
if (eina_list_count(wd->layout.list) > 0)
|
|
wd->layout.current = eina_list_data_get(wd->layout.list);
|
|
|
|
edje_object_signal_callback_add(wd->slideshow, "end", "slideshow", _end, obj);
|
|
|
|
evas_object_smart_callback_add(obj, "sub-object-del", _sub_del, obj);
|
|
evas_object_event_callback_add(obj, EVAS_CALLBACK_CHANGED_SIZE_HINTS, _changed_size_hints, obj);
|
|
|
|
evas_object_smart_callbacks_descriptions_set(obj, _signals);
|
|
|
|
_mirrored_set(obj, elm_widget_mirrored_get(obj));
|
|
_sizing_eval(obj);
|
|
return obj;
|
|
}
|
|
|
|
/**
|
|
* Add an object in the list. The object can be a evas object image or a elm photo for example.
|
|
*
|
|
* @param obj The slideshow object
|
|
* @aram itc Callbacks used to create the object and delete the data associated when the item is deleted.
|
|
* @param data Data used by the user to identified the item
|
|
* @return Returns The slideshow item
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI Elm_Slideshow_Item*
|
|
elm_slideshow_item_add(Evas_Object *obj, const Elm_Slideshow_Item_Class *itc, const void *data)
|
|
{
|
|
Elm_Slideshow_Item *item;
|
|
ELM_CHECK_WIDTYPE(obj, widtype) NULL;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
|
|
if (!wd) return NULL;
|
|
item = elm_widget_item_new(obj, Elm_Slideshow_Item);
|
|
item->base.data = data;
|
|
item->itc = itc;
|
|
item->l = eina_list_append(item->l, item);
|
|
|
|
wd->items = eina_list_merge(wd->items, item->l);
|
|
|
|
if (!wd->current) elm_slideshow_show(item);
|
|
|
|
return item;
|
|
}
|
|
|
|
/**
|
|
* Insert an object in the list. The object can be a evas object image or a elm photo for example.
|
|
*
|
|
* @param obj The slideshow object
|
|
* @aram itc Callbacks used to create the object and delete the data associated when the item is deleted.
|
|
* @param data Data used by the user to identified the item
|
|
* @param func The function to compare data
|
|
* @return Returns The slideshow item
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI Elm_Slideshow_Item*
|
|
elm_slideshow_item_sorted_insert(Evas_Object *obj, const Elm_Slideshow_Item_Class *itc, const void *data, Eina_Compare_Cb func)
|
|
{
|
|
Elm_Slideshow_Item *item;
|
|
ELM_CHECK_WIDTYPE(obj, widtype) NULL;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
|
|
if (!wd) return NULL;
|
|
item = elm_widget_item_new(obj, Elm_Slideshow_Item);
|
|
item->base.data = data;
|
|
item->itc = itc;
|
|
item->l = eina_list_append(item->l, item);
|
|
|
|
wd->items = eina_list_sorted_merge(wd->items, item->l, func);
|
|
|
|
if (!wd->current) elm_slideshow_show(item);
|
|
|
|
return item;
|
|
}
|
|
|
|
/**
|
|
* Go to the item
|
|
*
|
|
* @param obj The slideshow object
|
|
* @param item The item
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI void
|
|
elm_slideshow_show(Elm_Slideshow_Item *item)
|
|
{
|
|
char buf[1024];
|
|
Elm_Slideshow_Item *next = NULL;
|
|
Widget_Data *wd;
|
|
ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
|
|
wd = elm_widget_data_get(item->base.widget);
|
|
if (!wd)
|
|
return;
|
|
if (item == wd->current)
|
|
return;
|
|
|
|
next = item;
|
|
_end(item->base.widget, item->base.widget, NULL, NULL);
|
|
|
|
if (wd->timer) ecore_timer_del(wd->timer);
|
|
if (wd->timeout > 0.0)
|
|
wd->timer = ecore_timer_add(wd->timeout, _timer_cb, item->base.widget);
|
|
_item_realize(next);
|
|
edje_object_part_swallow(wd->slideshow, "elm.swallow.2", next->base.view);
|
|
evas_object_show(next->base.view);
|
|
snprintf(buf, sizeof(buf), "%s,next", wd->transition);
|
|
edje_object_signal_emit(wd->slideshow, buf, "slideshow");
|
|
wd->previous = wd->current;
|
|
wd->current = next;
|
|
evas_object_smart_callback_call(item->base.widget, SIG_CHANGED, wd->current);
|
|
}
|
|
|
|
/**
|
|
* Go to the next item
|
|
*
|
|
* @param obj The slideshow object
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI void
|
|
elm_slideshow_next(Evas_Object *obj)
|
|
{
|
|
char buf[1024];
|
|
Elm_Slideshow_Item *next = NULL;
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
|
|
if (!wd) return;
|
|
|
|
if (wd->current)
|
|
next = _item_next_get(wd->current);
|
|
|
|
if ((!next) || (next == wd->current)) return;
|
|
|
|
_end(obj, obj, NULL, NULL);
|
|
|
|
if (wd->timer) ecore_timer_del(wd->timer);
|
|
if (wd->timeout > 0.0)
|
|
wd->timer = ecore_timer_add(wd->timeout, _timer_cb, obj);
|
|
|
|
_item_realize(next);
|
|
|
|
edje_object_part_swallow(wd->slideshow, "elm.swallow.2", next->base.view);
|
|
evas_object_show(next->base.view);
|
|
|
|
snprintf(buf, sizeof(buf), "%s,next", wd->transition);
|
|
edje_object_signal_emit(wd->slideshow, buf, "slideshow");
|
|
|
|
wd->previous = wd->current;
|
|
wd->current = next;
|
|
evas_object_smart_callback_call(obj, SIG_CHANGED, wd->current);
|
|
}
|
|
|
|
/**
|
|
* Go to the previous item
|
|
*
|
|
* @param obj The slideshow object
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI void
|
|
elm_slideshow_previous(Evas_Object *obj)
|
|
{
|
|
char buf[1024];
|
|
Elm_Slideshow_Item *prev = NULL;
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
|
|
if (!wd) return;
|
|
|
|
if (wd->current)
|
|
prev = _item_prev_get(wd->current);
|
|
|
|
if ((!prev) || (prev == wd->current)) return;
|
|
|
|
_end(obj, obj, NULL, NULL);
|
|
|
|
if (wd->timer) ecore_timer_del(wd->timer);
|
|
if (wd->timeout > 0.0)
|
|
wd->timer = ecore_timer_add(wd->timeout, _timer_cb, obj);
|
|
|
|
_item_realize(prev);
|
|
|
|
edje_object_part_swallow(wd->slideshow, "elm.swallow.2", prev->base.view);
|
|
evas_object_show(prev->base.view);
|
|
|
|
snprintf(buf, 1024, "%s,previous", wd->transition);
|
|
edje_object_signal_emit(wd->slideshow, buf, "slideshow");
|
|
|
|
wd->previous = wd->current;
|
|
wd->current = prev;
|
|
evas_object_smart_callback_call(obj, SIG_CHANGED, wd->current);
|
|
}
|
|
|
|
/**
|
|
* Returns the list of transitions available.
|
|
*
|
|
* @param obj The slideshow object
|
|
* @return Returns the list of transitions (list of const char*)
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI const Eina_List *
|
|
elm_slideshow_transitions_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->transitions;
|
|
}
|
|
|
|
/**
|
|
* Returns the list of layouts available.
|
|
*
|
|
* @param obj The slideshow object
|
|
* @return Returns the list of layout (list of const char*)
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI const Eina_List *
|
|
elm_slideshow_layouts_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->layout.list;
|
|
}
|
|
|
|
/**
|
|
* Set the transition to use
|
|
*
|
|
* @param obj The slideshow object
|
|
* @param transition the new transition
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI void
|
|
elm_slideshow_transition_set(Evas_Object *obj, const char *transition)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
eina_stringshare_replace(&wd->transition, transition);
|
|
}
|
|
|
|
/**
|
|
* Returns the transition to use
|
|
*
|
|
* @param obj The slideshow object
|
|
* @return the transition set
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI const char *
|
|
elm_slideshow_transition_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->transition;
|
|
}
|
|
|
|
/**
|
|
* The slideshow can go to the next item automatically after a few seconds.
|
|
* This method set the timeout to use. A timeout <=0 disable the timer.
|
|
*
|
|
* @param obj The slideshow object
|
|
* @param timeout The new timeout
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI void
|
|
elm_slideshow_timeout_set(Evas_Object *obj, double timeout)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
wd->timeout = timeout;
|
|
if (wd->timer) ecore_timer_del(wd->timer);
|
|
wd->timer = NULL;
|
|
if (timeout > 0.0)
|
|
wd->timer = ecore_timer_add(timeout, _timer_cb, obj);
|
|
}
|
|
|
|
/**
|
|
* Returns the timeout value
|
|
*
|
|
* @param obj The slideshow object
|
|
* @return Returns the timeout
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI double
|
|
elm_slideshow_timeout_get(const Evas_Object *obj)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype) -1.0;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return -1.0;
|
|
return wd->timeout;
|
|
}
|
|
|
|
/**
|
|
* Set if the first item should follow the last and vice versa
|
|
*
|
|
* @param obj The slideshow object
|
|
* @param loop if EINA_TRUE, the first item will follow the last and vice versa
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI void
|
|
elm_slideshow_loop_set(Evas_Object *obj, Eina_Bool loop)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
wd->loop = loop;
|
|
}
|
|
|
|
/**
|
|
* Returns the current layout name
|
|
*
|
|
* @param obj The slideshow object
|
|
* @returns Returns the layout name
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI const char *
|
|
elm_slideshow_layout_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->layout.current;
|
|
}
|
|
|
|
/**
|
|
* Set the layout
|
|
*
|
|
* @param obj The slideshow object
|
|
* @param layout the new layout
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI void
|
|
elm_slideshow_layout_set(Evas_Object *obj, const char *layout)
|
|
{
|
|
char buf[PATH_MAX];
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
|
|
wd->layout.current = layout;
|
|
snprintf(buf, sizeof(buf), "layout,%s", layout);
|
|
edje_object_signal_emit(wd->slideshow, buf, "slideshow");
|
|
}
|
|
|
|
/**
|
|
* Return if the first item should follow the last and vice versa
|
|
*
|
|
* @param obj The slideshow object
|
|
* @returns Returns the loop flag
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI Eina_Bool
|
|
elm_slideshow_loop_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->loop;
|
|
}
|
|
|
|
/**
|
|
* Delete all the items
|
|
*
|
|
* @param obj The slideshow object
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI void
|
|
elm_slideshow_clear(Evas_Object *obj)
|
|
{
|
|
Elm_Slideshow_Item *item;
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
wd->previous = NULL;
|
|
wd->current = NULL;
|
|
EINA_LIST_FREE(wd->items_built, item)
|
|
{
|
|
if (item->itc->func.del)
|
|
item->itc->func.del((void*)item->base.data, item->base.view);
|
|
evas_object_del(item->base.view);
|
|
item->base.view = NULL;
|
|
}
|
|
|
|
EINA_LIST_FREE(wd->items, item)
|
|
{
|
|
elm_widget_item_del(item);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Delete the item
|
|
*
|
|
* @param item The slideshow item
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI void
|
|
elm_slideshow_item_del(Elm_Slideshow_Item *item)
|
|
{
|
|
ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
|
|
Widget_Data *wd = elm_widget_data_get(item->base.widget);
|
|
if (!wd) return;
|
|
if (wd->previous == item) wd->previous = NULL;
|
|
if (wd->current == item)
|
|
{
|
|
Eina_List *l = eina_list_data_find_list(wd->items, item);
|
|
Eina_List *l2 = eina_list_next(l);
|
|
wd->current = NULL;
|
|
if (!l2)
|
|
l2 = eina_list_nth_list(wd->items, eina_list_count(wd->items) - 1);
|
|
if (l2)
|
|
elm_slideshow_show(eina_list_data_get(l2));
|
|
}
|
|
|
|
wd->items = eina_list_remove_list(wd->items, item->l);
|
|
wd->items_built = eina_list_remove_list(wd->items_built, item->l_built);
|
|
|
|
if ((item->base.view) && (item->itc->func.del))
|
|
item->itc->func.del((void*)item->base.data, item->base.view);
|
|
if (item->base.view)
|
|
evas_object_del(item->base.view);
|
|
free(item);
|
|
}
|
|
|
|
/**
|
|
* Returns the list of items
|
|
* @param obj The slideshow object
|
|
* @return Returns the list of items (list of Elm_Slideshow_Item).
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI const Eina_List *
|
|
elm_slideshow_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;
|
|
}
|
|
|
|
/**
|
|
* Returns the current item displayed
|
|
*
|
|
* @param obj The slideshow object
|
|
* @return Returns the current item displayed
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI Elm_Slideshow_Item *
|
|
elm_slideshow_item_current_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->current;
|
|
}
|
|
|
|
/**
|
|
* Returns the evas object associated to an item
|
|
*
|
|
* @param item The slideshow item
|
|
* @return Returns the evas object associated to this item
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI Evas_Object *
|
|
elm_slideshow_item_object_get(const Elm_Slideshow_Item * item)
|
|
{
|
|
ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
|
|
return item->base.view;
|
|
}
|
|
|
|
/**
|
|
* Returns the data associated to an item
|
|
*
|
|
* @param item The slideshow item
|
|
* @return Returns the data associated to this item
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI void *
|
|
elm_slideshow_item_data_get(const Elm_Slideshow_Item * item)
|
|
{
|
|
ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
|
|
return elm_widget_item_data_get(item);
|
|
}
|
|
|
|
/**
|
|
* Returns max amount of cached items before current
|
|
*
|
|
* @param obj The slideshow object
|
|
* @return Returns max amount of cached items
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI int
|
|
elm_slideshow_cache_before_get(const Evas_Object *obj)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype) -1;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return -1;
|
|
return wd->count_item_pre_before;
|
|
}
|
|
|
|
/**
|
|
* Set max amount of cached items before current
|
|
*
|
|
* @param obj The slideshow object
|
|
* @param count Max amount of cached items
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI void
|
|
elm_slideshow_cache_before_set(Evas_Object *obj, int count)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
if (count < 0) count = 0;
|
|
wd->count_item_pre_before = count;
|
|
}
|
|
|
|
/**
|
|
* Returns max amount of cached items after current
|
|
*
|
|
* @param obj The slideshow object
|
|
* @return Returns max amount of cached items
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI int
|
|
elm_slideshow_cache_after_get(const Evas_Object *obj)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype) -1;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return -1;
|
|
return wd->count_item_pre_after;
|
|
}
|
|
|
|
/**
|
|
* Set max amount of cached items after current
|
|
*
|
|
* @param obj The slideshow object
|
|
* @param count max amount of cached items
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI void
|
|
elm_slideshow_cache_after_set(Evas_Object *obj, int count)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype);
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return;
|
|
if (count < 0) count = 0;
|
|
wd->count_item_pre_after = count;
|
|
}
|
|
|
|
/**
|
|
* Get the nth item of the slideshow
|
|
*
|
|
* @param obj The slideshow object
|
|
* @param nth The number of the element (0 being first)
|
|
* @return The item stored in slideshow at position required
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI Elm_Slideshow_Item *
|
|
elm_slideshow_item_nth_get(const Evas_Object *obj, unsigned int nth)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype) NULL;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return NULL;
|
|
return eina_list_nth(wd->items, nth);
|
|
}
|
|
|
|
/**
|
|
* Get count of items stored in slideshow
|
|
*
|
|
* @param obj The slideshow object
|
|
* @return The count of items
|
|
*
|
|
* @ingroup Slideshow
|
|
*/
|
|
EAPI unsigned int
|
|
elm_slideshow_count_get(const Evas_Object *obj)
|
|
{
|
|
ELM_CHECK_WIDTYPE(obj, widtype) 0;
|
|
Widget_Data *wd = elm_widget_data_get(obj);
|
|
if (!wd) return 0;
|
|
return eina_list_count(wd->items);
|
|
}
|