src/lib/elm_slideshow.c

   1 #include <Elementary.h>
   2 #include "elm_priv.h"
   3
   4 /**
   5  * @defgroup Slideshow Slideshow
   6  *
   7  * This object display a list of object (generally a list of images) and some actions like
   8  * next/previous are used to navigate. The animations are defined in the theme,
   9  * consequently new animations can be added without having to update the
  10  * applications.
  11  *
  12  * The slideshow use 2 callbacks to create and delete the objects displayed. When an item
  13  * is displayed the function itc->func.get() is called. This function should create the object,
  14  * for example the object can be an evas_object_image or a photocam. When a object is no more
  15  * displayed the function itc->func.del() is called, the user can delete the dana associated to the item.
  16  */
  17
  18 typedef struct _Widget_Data Widget_Data;
  19
  20 struct _Elm_Slideshow_Item
  21 {
  22    Elm_Widget_Item base;
  23
  24    Eina_List *l, *l_built;
  25
  26    const Elm_Slideshow_Item_Class *itc;
  27 };
  28
  29 struct _Widget_Data
  30 {
  31    Evas_Object *slideshow;
  32
  33    // list of Elm_Slideshow_Item*
  34    Eina_List *items;
  35    Eina_List *items_built;
  36
  37    Elm_Slideshow_Item *current;
  38    Elm_Slideshow_Item *previous;
  39
  40    Eina_List *transitions;
  41    const char *transition;
  42
  43    Ecore_Timer *timer;
  44    double timeout;
  45    Eina_Bool loop:1;
  46
  47    struct {
  48         const char *current;
  49         Eina_List *list; //list of const char *
  50    } layout;
  51 };
  52
  53 static const char *widtype = NULL;
  54 static void _del_hook(Evas_Object *obj);
  55 static void _mirrored_set(Evas_Object *obj, Eina_Bool rtl);
  56 static void _theme_hook(Evas_Object *obj);
  57 static void _sizing_eval(Evas_Object *obj);
  58 static void _changed_size_hints(void *data, Evas *e, Evas_Object *obj, void *event_info);
  59 static Eina_Bool _timer_cb(void *data);
  60 static void _on_focus_hook(void *data, Evas_Object *obj);
  61 static Eina_Bool _event_hook(Evas_Object *obj, Evas_Object *src,
  62                              Evas_Callback_Type type, void *event_info);
  63
  64 static Eina_Bool
  65 _event_hook(Evas_Object *obj, Evas_Object *src __UNUSED__, Evas_Callback_Type type, void *event_info)
  66 {
  67    if (type != EVAS_CALLBACK_KEY_DOWN) return EINA_FALSE;
  68    Evas_Event_Key_Down *ev = event_info;
  69    Widget_Data *wd = elm_widget_data_get(obj);
  70    if (!wd) return EINA_FALSE;
  71    if (ev->event_flags & EVAS_EVENT_FLAG_ON_HOLD) return EINA_FALSE;
  72    if (elm_widget_disabled_get(obj)) return EINA_FALSE;
  73    if ((!strcmp(ev->keyname, "Left")) || (!strcmp(ev->keyname, "KP_Left")))
  74      {
  75         elm_slideshow_previous(obj);
  76         ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
  77         return EINA_TRUE;
  78      }
  79    if ((!strcmp(ev->keyname, "Right")) || (!strcmp(ev->keyname, "KP_Right")))
  80      {
  81         elm_slideshow_next(obj);
  82         ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
  83         return EINA_TRUE;
  84      }
  85    if ((!strcmp(ev->keyname, "Return")) ||
  86        (!strcmp(ev->keyname, "KP_Enter")) ||
  87        (!strcmp(ev->keyname, "space")))
  88      {
  89         if (wd->timeout)
  90           {
  91              if (wd->timer)
  92                {
  93                   ecore_timer_del(wd->timer);
  94                   wd->timer = NULL;
  95                }
  96              else
  97                elm_slideshow_timeout_set(obj, wd->timeout);
  98           }
  99         ev->event_flags |= EVAS_EVENT_FLAG_ON_HOLD;
 100         return EINA_TRUE;
 101      }
 102    return EINA_FALSE;
 103 }
 104
 105 static void
 106 _del_hook(Evas_Object *obj)
 107 {
 108    const char *layout;
 109    Widget_Data *wd = elm_widget_data_get(obj);
 110    if (!wd) return;
 111    elm_slideshow_clear(obj);
 112    elm_widget_stringlist_free(wd->transitions);
 113    if (wd->timer) ecore_timer_del(wd->timer);
 114    EINA_LIST_FREE(wd->layout.list, layout)
 115       eina_stringshare_del(layout);
 116    free(wd);
 117 }
 118
 119 static void
 120 _on_focus_hook(void *data __UNUSED__, Evas_Object *obj)
 121 {
 122    Widget_Data *wd = elm_widget_data_get(obj);
 123    if (!wd) return;
 124    if (elm_widget_focus_get(obj))
 125      {
 126         edje_object_signal_emit(wd->slideshow, "elm,action,focus", "elm");
 127         evas_object_focus_set(wd->slideshow, EINA_TRUE);
 128      }
 129    else
 130      {
 131         edje_object_signal_emit(wd->slideshow, "elm,action,unfocus", "elm");
 132         evas_object_focus_set(wd->slideshow, EINA_FALSE);
 133      }
 134 }
 135
 136 static void
 137 _mirrored_set(Evas_Object *obj, Eina_Bool rtl)
 138 {
 139    Widget_Data *wd = elm_widget_data_get(obj);
 140    if (!wd) return;
 141    edje_object_mirrored_set(wd->slideshow, rtl);
 142 }
 143
 144 static void
 145 _theme_hook(Evas_Object *obj)
 146 {
 147    Widget_Data *wd = elm_widget_data_get(obj);
 148    if (!wd) return;
 149    _elm_widget_mirrored_reload(obj);
 150    _mirrored_set(obj, elm_widget_mirrored_get(obj));
 151    _elm_theme_object_set(obj, wd->slideshow, "slideshow", "base", elm_widget_style_get(obj));
 152    edje_object_scale_set(wd->slideshow, elm_widget_scale_get(obj) *
 153                          _elm_config->scale);
 154    _sizing_eval(obj);
 155 }
 156
 157 static void
 158 _sizing_eval(Evas_Object *obj)
 159 {
 160    Widget_Data *wd = elm_widget_data_get(obj);
 161    Evas_Coord minw = -1, minh = -1;
 162    if (!wd) return;
 163    edje_object_size_min_calc(wd->slideshow, &minw, &minh);
 164    evas_object_size_hint_min_set(obj, minw, minh);
 165    evas_object_size_hint_max_set(obj, minw, minh);
 166 }
 167
 168
 169 static Elm_Slideshow_Item* _item_prev_get(Elm_Slideshow_Item* item)
 170 {
 171    Widget_Data *wd = elm_widget_data_get(item->base.widget);
 172    Elm_Slideshow_Item* prev = eina_list_data_get(eina_list_prev(item->l));
 173    if((!prev) && (wd->loop))
 174      prev = eina_list_data_get(eina_list_last(item->l));
 175    return prev;
 176 }
 177
 178 static Elm_Slideshow_Item* _item_next_get(Elm_Slideshow_Item* item)
 179 {
 180    Widget_Data *wd = elm_widget_data_get(item->base.widget);
 181    Elm_Slideshow_Item* next = eina_list_data_get(eina_list_next(item->l));
 182    if((!next) && (wd->loop))
 183      next = eina_list_data_get(wd->items);
 184    return next;
 185 }
 186
 187
 188 static void
 189 _changed_size_hints(void *data, Evas *e __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
 190 {
 191    _sizing_eval(data);
 192 }
 193
 194 static void
 195 _sub_del(void *data __UNUSED__, Evas_Object *obj __UNUSED__, void *event_info __UNUSED__)
 196 {
 197    ;
 198 }
 199
 200 static void
 201 _item_realize(Elm_Slideshow_Item *item)
 202 {
 203    Elm_Slideshow_Item *_item;
 204    Evas_Object *obj = item->base.widget;
 205    Widget_Data *wd = elm_widget_data_get(obj);
 206
 207    if (!wd) return;
 208    if ((!item->base.view) && (item->itc->func.get))
 209      {
 210         item->base.view = item->itc->func.get((void*)item->base.data, obj);
 211         evas_object_smart_member_add(item->base.view, obj);
 212         item->l_built = eina_list_append(NULL, item);
 213         wd->items_built = eina_list_merge(wd->items_built, item->l_built);
 214         evas_object_hide(item->base.view);
 215      }
 216    else if (item->l_built)
 217      wd->items_built = eina_list_demote_list(wd->items_built, item->l_built);
 218
 219    //pre-create previous and next item
 220    _item = _item_next_get(item);
 221    if ((_item) && (!_item->base.view) && (_item->itc->func.get))
 222      {
 223         _item->base.view = _item->itc->func.get((void*)_item->base.data, obj);
 224         evas_object_smart_member_add(_item->base.view, obj);
 225         _item->l_built = eina_list_append(NULL, _item);
 226         wd->items_built = eina_list_merge(wd->items_built, _item->l_built);
 227         evas_object_hide(_item->base.view);
 228      }
 229    else if ((_item) && (_item->l_built))
 230      wd->items_built = eina_list_demote_list(wd->items_built, _item->l_built);
 231
 232    _item = _item_prev_get(item);
 233    if ((_item) && (!_item->base.view) && (_item->itc->func.get))
 234      {
 235         _item->base.view = _item->itc->func.get((void*)_item->base.data, obj);
 236         evas_object_smart_member_add(_item->base.view, obj);
 237         _item->l_built = eina_list_append(NULL, _item);
 238         wd->items_built = eina_list_merge(wd->items_built, _item->l_built);
 239         evas_object_hide(_item->base.view);
 240      }
 241    else if ((_item) && (_item->l_built))
 242      wd->items_built = eina_list_demote_list(wd->items_built, _item->l_built);
 243
 244    //delete unused items
 245    while (eina_list_count(wd->items_built) > 3)
 246      {
 247         _item = eina_list_data_get(wd->items_built);
 248         wd->items_built = eina_list_remove_list(wd->items_built, wd->items_built);
 249         if(item->itc->func.del)
 250           item->itc->func.del((void*)item->base.data, _item->base.view);
 251         evas_object_del(_item->base.view);
 252         _item->base.view = NULL;
 253      }
 254 }
 255
 256 static void
 257 _end(void *data, Evas_Object *obj __UNUSED__, const char *emission __UNUSED__, const char *source __UNUSED__)
 258 {
 259    Elm_Slideshow_Item *item;
 260    Widget_Data *wd = elm_widget_data_get(data);
 261    if (!wd) return;
 262
 263    item = wd->previous;
 264    if(item)
 265      {
 266         edje_object_part_unswallow(NULL, item->base.view);
 267         evas_object_hide(item->base.view);
 268         wd->previous = NULL;
 269      }
 270
 271
 272    item = wd->current;
 273    if ((!item) || (!item->base.view)) return;
 274
 275    _item_realize(item);
 276    edje_object_part_unswallow(NULL, item->base.view);
 277    evas_object_show(item->base.view);
 278
 279    edje_object_signal_emit(wd->slideshow, "anim,end", "slideshow");
 280    edje_object_part_swallow(wd->slideshow, "elm.swallow.1", item->base.view);
 281 }
 282
 283
 284 static Eina_Bool
 285 _timer_cb(void *data)
 286 {
 287    Evas_Object *obj = data;
 288    Widget_Data *wd = elm_widget_data_get(obj);
 289    if (!wd) return ECORE_CALLBACK_CANCEL;
 290    wd->timer = NULL;
 291    elm_slideshow_next(obj);
 292    return ECORE_CALLBACK_CANCEL;
 293 }
 294
 295
 296
 297 /**
 298  * Add a new slideshow to the parent
 299  *
 300  * @param parent The parent object
 301  * @return The new object or NULL if it cannot be created
 302  *
 303  * @ingroup Slideshow
 304  */
 305 EAPI Evas_Object *
 306 elm_slideshow_add(Evas_Object *parent)
 307 {
 308    Evas_Object *obj;
 309    Evas *e;
 310    Widget_Data *wd;
 311
 312    ELM_WIDGET_STANDARD_SETUP(wd, Widget_Data, parent, e, obj, NULL);
 313
 314    ELM_SET_WIDTYPE(widtype, "slideshow");
 315    elm_widget_type_set(obj, "slideshow");
 316    elm_widget_sub_object_add(parent, obj);
 317    elm_widget_on_focus_hook_set(obj, _on_focus_hook, NULL);
 318    elm_widget_data_set(obj, wd);
 319    elm_widget_del_hook_set(obj, _del_hook);
 320    elm_widget_theme_hook_set(obj, _theme_hook);
 321    elm_widget_can_focus_set(obj, EINA_TRUE);
 322    elm_widget_event_hook_set(obj, _event_hook);
 323
 324    wd->current = NULL;
 325    wd->previous = NULL;
 326
 327    wd->slideshow = edje_object_add(e);
 328    _elm_theme_object_set(obj, wd->slideshow, "slideshow", "base", "default");
 329    evas_object_smart_member_add(wd->slideshow, obj);
 330    elm_widget_resize_object_set(obj, wd->slideshow);
 331    evas_object_show(wd->slideshow);
 332
 333    wd->transitions = elm_widget_stringlist_get(edje_object_data_get(wd->slideshow, "transitions"));
 334    if (eina_list_count(wd->transitions) > 0)
 335      wd->transition = eina_stringshare_add(eina_list_data_get(wd->transitions));
 336
 337    wd->layout.list = elm_widget_stringlist_get(edje_object_data_get(wd->slideshow, "layouts"));
 338    if (eina_list_count(wd->layout.list) > 0)
 339      wd->layout.current = eina_list_data_get(wd->layout.list);
 340
 341    edje_object_signal_callback_add(wd->slideshow, "end", "slideshow", _end, obj);
 342
 343    evas_object_smart_callback_add(obj, "sub-object-del", _sub_del, obj);
 344    evas_object_event_callback_add(obj, EVAS_CALLBACK_CHANGED_SIZE_HINTS, _changed_size_hints, obj);
 345
 346    _mirrored_set(obj, elm_widget_mirrored_get(obj));
 347    _sizing_eval(obj);
 348    return obj;
 349 }
 350
 351 /**
 352  * Add a object in the list. The object can be a evas object image or a elm photo for example.
 353  *
 354  * @param obj The slideshow object
 355  * @aram itc Callbacks used to create the object and delete the data associated when the item is deleted.
 356  * @param data Data used by the user to identified the item
 357  * @return Returns The slideshow item
 358  *
 359  * @ingroup Slideshow
 360  */
 361 EAPI Elm_Slideshow_Item*
 362 elm_slideshow_item_add(Evas_Object *obj, const Elm_Slideshow_Item_Class *itc, const void *data)
 363 {
 364    Elm_Slideshow_Item *item;
 365    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 366    Widget_Data *wd = elm_widget_data_get(obj);
 367
 368    if (!wd) return NULL;
 369    item = elm_widget_item_new(obj, Elm_Slideshow_Item);
 370    item->base.data = data;
 371    item->itc = itc;
 372    item->l = eina_list_append(item->l, item);
 373
 374    wd->items = eina_list_merge(wd->items, item->l);
 375
 376    if (!wd->current) elm_slideshow_show(item);
 377
 378    return item;
 379 }
 380
 381 /**
 382  * Go to the item
 383  *
 384  * @param obj The slideshow object
 385  * @param item The item
 386  *
 387  * @ingroup Slideshow
 388  */
 389 EAPI void
 390 elm_slideshow_show(Elm_Slideshow_Item *item)
 391 {
 392    char buf[1024];
 393    Elm_Slideshow_Item *next = NULL;
 394    Widget_Data *wd;
 395    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
 396    wd = elm_widget_data_get(item->base.widget);
 397    if (!wd)
 398      return;
 399    if (item == wd->current)
 400      return;
 401
 402    next = item;
 403    _end(item->base.widget, item->base.widget, NULL, NULL);
 404
 405    if (wd->timer) ecore_timer_del(wd->timer);
 406    if (wd->timeout > 0.0)
 407      wd->timer = ecore_timer_add(wd->timeout, _timer_cb, item->base.widget);
 408    _item_realize(next);
 409    edje_object_part_swallow(wd->slideshow, "elm.swallow.2", next->base.view);
 410    evas_object_show(next->base.view);
 411    snprintf(buf, sizeof(buf), "%s,next", wd->transition);
 412    edje_object_signal_emit(wd->slideshow, buf, "slideshow");
 413    wd->previous = wd->current;
 414    wd->current = next;
 415    evas_object_smart_callback_call(item->base.widget, "changed", wd->current);
 416 }
 417
 418 /**
 419  * Go to the next item
 420  *
 421  * @param obj The slideshow object
 422  *
 423  * @ingroup Slideshow
 424  */
 425 EAPI void
 426 elm_slideshow_next(Evas_Object *obj)
 427 {
 428    char buf[1024];
 429    Elm_Slideshow_Item *next = NULL;
 430    ELM_CHECK_WIDTYPE(obj, widtype);
 431    Widget_Data *wd = elm_widget_data_get(obj);
 432
 433    if (!wd) return;
 434
 435    if (wd->current)
 436      next = _item_next_get(wd->current);
 437
 438    if ((!next) || (next == wd->current)) return;
 439
 440    _end(obj, obj, NULL, NULL);
 441
 442    if (wd->timer) ecore_timer_del(wd->timer);
 443    if (wd->timeout > 0.0)
 444      wd->timer = ecore_timer_add(wd->timeout, _timer_cb, obj);
 445
 446    _item_realize(next);
 447
 448    edje_object_part_swallow(wd->slideshow, "elm.swallow.2", next->base.view);
 449    evas_object_show(next->base.view);
 450
 451    snprintf(buf, sizeof(buf), "%s,next", wd->transition);
 452    edje_object_signal_emit(wd->slideshow, buf, "slideshow");
 453
 454    wd->previous = wd->current;
 455    wd->current = next;
 456    evas_object_smart_callback_call(obj, "changed", wd->current);
 457 }
 458
 459 /**
 460  * Go to the previous item
 461  *
 462  * @param obj The slideshow object
 463  *
 464  * @ingroup Slideshow
 465  */
 466 EAPI void
 467 elm_slideshow_previous(Evas_Object *obj)
 468 {
 469    char buf[1024];
 470    Elm_Slideshow_Item *prev = NULL;
 471    ELM_CHECK_WIDTYPE(obj, widtype);
 472    Widget_Data *wd = elm_widget_data_get(obj);
 473
 474    if (!wd) return;
 475
 476    if (wd->current)
 477      prev = _item_prev_get(wd->current);
 478
 479    if ((!prev) ||  (prev == wd->current)) return;
 480
 481    _end(obj, obj, NULL, NULL);
 482
 483    if (wd->timer) ecore_timer_del(wd->timer);
 484    if (wd->timeout > 0.0)
 485      wd->timer = ecore_timer_add(wd->timeout, _timer_cb, obj);
 486
 487    _item_realize(prev);
 488
 489    edje_object_part_swallow(wd->slideshow, "elm.swallow.2", prev->base.view);
 490    evas_object_show(prev->base.view);
 491
 492    snprintf(buf, 1024, "%s,previous", wd->transition);
 493    edje_object_signal_emit(wd->slideshow, buf, "slideshow");
 494
 495    wd->previous = wd->current;
 496    wd->current = prev;
 497    evas_object_smart_callback_call(obj, "changed", wd->current);
 498 }
 499
 500 /**
 501  * Returns the list of transitions available.
 502  *
 503  * @param obj The slideshow object
 504  * @return Returns the list of transitions (list of const char*)
 505  *
 506  * @ingroup Slideshow
 507  */
 508 EAPI const Eina_List *
 509 elm_slideshow_transitions_get(const Evas_Object *obj)
 510 {
 511    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 512    Widget_Data *wd = elm_widget_data_get(obj);
 513    if (!wd) return NULL;
 514    return wd->transitions;
 515 }
 516
 517 /**
 518  * Returns the list of layouts available.
 519  *
 520  * @param obj The slideshow object
 521  * @return Returns the list of layout (list of const char*)
 522  *
 523  * @ingroup Slideshow
 524  */
 525 EAPI const Eina_List *
 526 elm_slideshow_layouts_get(const Evas_Object *obj)
 527 {
 528    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 529    Widget_Data *wd = elm_widget_data_get(obj);
 530    if (!wd) return NULL;
 531    return wd->layout.list;
 532 }
 533
 534 /**
 535  * Set the transition to use
 536  *
 537  * @param obj The slideshow object
 538  * @param transition the new transition
 539  *
 540  * @ingroup Slideshow
 541  */
 542 EAPI void
 543 elm_slideshow_transition_set(Evas_Object *obj, const char *transition)
 544 {
 545    ELM_CHECK_WIDTYPE(obj, widtype);
 546    Widget_Data *wd = elm_widget_data_get(obj);
 547    if (!wd) return;
 548    eina_stringshare_replace(&wd->transition, transition);
 549 }
 550
 551 /**
 552  * Returns the transition to use
 553  *
 554  * @param obj The slideshow object
 555  * @return the transition set
 556  *
 557  * @ingroup Slideshow
 558  */
 559 EAPI const char *
 560 elm_slideshow_transition_get(const Evas_Object *obj)
 561 {
 562    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 563    Widget_Data *wd = elm_widget_data_get(obj);
 564    if (!wd) return NULL;
 565    return wd->transition;
 566 }
 567
 568 /**
 569  * The slideshow can go to the next item automatically after a few seconds.
 570  * This method set the timeout to use. A timeout <=0 disable the timer.
 571  *
 572  * @param obj The slideshow object
 573  * @param timeout The new timeout
 574  *
 575  * @ingroup Slideshow
 576  */
 577 EAPI void
 578 elm_slideshow_timeout_set(Evas_Object *obj, double timeout)
 579 {
 580    ELM_CHECK_WIDTYPE(obj, widtype);
 581    Widget_Data *wd = elm_widget_data_get(obj);
 582    if (!wd) return;
 583    wd->timeout = timeout;
 584    if (wd->timer) ecore_timer_del(wd->timer);
 585    wd->timer = NULL;
 586    if (timeout > 0.0)
 587      wd->timer = ecore_timer_add(timeout, _timer_cb, obj);
 588 }
 589
 590 /**
 591  * Returns the timeout value
 592  *
 593  * @param obj The slideshow object
 594  * @return Returns the timeout
 595  *
 596  * @ingroup Slideshow
 597  */
 598 EAPI double
 599 elm_slideshow_timeout_get(const Evas_Object *obj)
 600 {
 601    ELM_CHECK_WIDTYPE(obj, widtype) -1.0;
 602    Widget_Data *wd = elm_widget_data_get(obj);
 603    if (!wd) return -1.0;
 604    return wd->timeout;
 605 }
 606
 607 /**
 608  * Set if the first item should follow the last and vice versa
 609  *
 610  * @param obj The slideshow object
 611  * @param loop if EINA_TRUE, the first item will follow the last and vice versa
 612  *
 613  * @ingroup Slideshow
 614  */
 615 EAPI void
 616 elm_slideshow_loop_set(Evas_Object *obj, Eina_Bool loop)
 617 {
 618    ELM_CHECK_WIDTYPE(obj, widtype);
 619    Widget_Data *wd = elm_widget_data_get(obj);
 620    if (!wd) return;
 621    wd->loop = loop;
 622 }
 623
 624 /**
 625  * Returns the current layout name
 626  *
 627  * @param obj The slideshow object
 628  * @returns Returns the layout name
 629  *
 630  * @ingroup Slideshow
 631  */
 632 EAPI const char *
 633 elm_slideshow_layout_get(const Evas_Object *obj)
 634 {
 635    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 636    Widget_Data *wd = elm_widget_data_get(obj);
 637    if (!wd) return EINA_FALSE;
 638    return wd->layout.current;
 639 }
 640
 641 /**
 642  * Set the layout
 643  *
 644  * @param obj The slideshow object
 645  * @param layout the new layout
 646  *
 647  * @ingroup Slideshow
 648  */
 649 EAPI void
 650 elm_slideshow_layout_set(Evas_Object *obj, const char *layout)
 651 {
 652    char buf[PATH_MAX];
 653    ELM_CHECK_WIDTYPE(obj, widtype);
 654    Widget_Data *wd = elm_widget_data_get(obj);
 655    if (!wd) return;
 656
 657    wd->layout.current = layout;
 658    snprintf(buf, sizeof(buf), "layout,%s", layout);
 659    edje_object_signal_emit(wd->slideshow, buf, "slideshow");
 660 }
 661
 662 /**
 663  * Return if the first item should follow the last and vice versa
 664  *
 665  * @param obj The slideshow object
 666  * @returns Returns the loop flag
 667  *
 668  * @ingroup Slideshow
 669  */
 670 EAPI Eina_Bool
 671 elm_slideshow_loop_get(const Evas_Object *obj)
 672 {
 673    ELM_CHECK_WIDTYPE(obj, widtype) EINA_FALSE;
 674    Widget_Data *wd = elm_widget_data_get(obj);
 675    if (!wd) return EINA_FALSE;
 676    return wd->loop;
 677 }
 678
 679 /**
 680  * Delete all the items
 681  *
 682  * @param obj The slideshow object
 683  *
 684  * @ingroup Slideshow
 685  */
 686 EAPI void
 687 elm_slideshow_clear(Evas_Object *obj)
 688 {
 689    Elm_Slideshow_Item *item;
 690    ELM_CHECK_WIDTYPE(obj, widtype);
 691    Widget_Data *wd = elm_widget_data_get(obj);
 692    if (!wd) return;
 693    wd->previous = NULL;
 694    wd->current = NULL;
 695    EINA_LIST_FREE(wd->items_built, item)
 696      {
 697         if (item->itc->func.del)
 698           item->itc->func.del((void*)item->base.data, item->base.view);
 699         evas_object_del(item->base.view);
 700         item->base.view = NULL;
 701      }
 702
 703    EINA_LIST_FREE(wd->items, item)
 704      {
 705         elm_widget_item_del(item);
 706      }
 707 }
 708
 709
 710 /**
 711  * Delete the item
 712  *
 713  * @param item The slideshow item
 714  *
 715  * @ingroup Slideshow
 716  */
 717 EAPI void
 718 elm_slideshow_item_del(Elm_Slideshow_Item *item)
 719 {
 720    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item);
 721    Widget_Data *wd = elm_widget_data_get(item->base.widget);
 722    if (!wd) return;
 723    if (wd->previous == item) wd->previous = NULL;
 724    if (wd->current == item)
 725      {
 726         Eina_List *l = eina_list_data_find_list(wd->items, item);
 727         Eina_List *l2 = eina_list_next(l);
 728         wd->current = NULL;
 729         if (!l2)
 730           l2 = eina_list_nth_list(wd->items, eina_list_count(wd->items) - 1);
 731         if (l2)
 732           elm_slideshow_show(eina_list_data_get(l2));
 733      }
 734
 735    wd->items = eina_list_remove_list(wd->items, item->l);
 736    wd->items_built = eina_list_remove_list(wd->items_built, item->l_built);
 737
 738    if ((item->base.view) && (item->itc->func.del))
 739      item->itc->func.del((void*)item->base.data, item->base.view);
 740    if (item->base.view)
 741      evas_object_del(item->base.view);
 742    free(item);
 743 }
 744
 745 /**
 746  * Returns the list of items
 747  * @param obj The slideshow object
 748  * @return Returns the list of items (list of Elm_Slideshow_Item).
 749  *
 750  * @ingroup Slideshow
 751  */
 752 EAPI const Eina_List *
 753 elm_slideshow_items_get(const Evas_Object *obj)
 754 {
 755    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 756    Widget_Data *wd = elm_widget_data_get(obj);
 757    if (!wd) return NULL;
 758    return wd->items;
 759 }
 760
 761
 762 /**
 763  * Returns the current item displayed
 764  *
 765  * @param obj The slideshow object
 766  * @return Returns the current item displayed
 767  *
 768  * @ingroup Slideshow
 769  */
 770 EAPI Elm_Slideshow_Item *
 771 elm_slideshow_item_current_get(const Evas_Object *obj)
 772 {
 773    ELM_CHECK_WIDTYPE(obj, widtype) NULL;
 774    Widget_Data *wd = elm_widget_data_get(obj);
 775    if (!wd) return NULL;
 776    return wd->current;
 777 }
 778
 779 /**
 780  * Returns the evas object associated to an item
 781  *
 782  * @param item The slideshow item
 783  * @return Returns the evas object associated to this item
 784  *
 785  * @ingroup Slideshow
 786  */
 787 EAPI Evas_Object *
 788 elm_slideshow_item_object_get(const Elm_Slideshow_Item * item)
 789 {
 790    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
 791    return item->base.view;
 792 }
 793
 794 /**
 795  * Returns the data associated to an item
 796  *
 797  * @param item The slideshow item
 798  * @return Returns the data associated to this item
 799  *
 800  * @ingroup Slideshow
 801  */
 802 EAPI void *
 803 elm_slideshow_item_data_get(const Elm_Slideshow_Item * item)
 804 {
 805    ELM_WIDGET_ITEM_WIDTYPE_CHECK_OR_RETURN(item, NULL);
 806    return elm_widget_item_data_get(item);
 807 }