Tizen Native API  5.0
Slideshow

slideshow_inheritance_tree.png

This widget, as the name indicates, is a pre-made image slideshow panel, with API functions acting on (child) image items presentation. Between those actions, are:

  • advance to next/previous image
  • select the style of image transition animation
  • set the exhibition time for each image
  • start/stop the slideshow

The transition animations are defined in the widget's theme, consequently new animations can be added without having to update the widget's code.

Slideshow items

For slideshow items, just like for genlist ones, the user defines a classes, specifying functions that will be called on the item's creation and deletion times.

The Elm_Slideshow_Item_Class structure contains the following members:

  • func.get - When an item is displayed, this function is called, and it's where one should create the item object, de facto. For example, the object can be a pure Evas image object or an Elementary photocam widget. See SlideshowItemGetFunc.
  • func.del - When an item is no more displayed, this function is called, where the user must delete any data associated to the item. See SlideshowItemDelFunc.

Slideshow caching

The slideshow provides facilities to have items adjacent to the one being displayed already "realized" (i.e. loaded) for you, so that the system does not have to decode image data anymore at the time it has to actually switch images on its viewport. The user is able to set the numbers of items to be cached before and after the current item, in the widget's item list.

This widget inherits from the Layout one, so that all the functions acting on it also work for slideshow objects.

This widget emits the following signals, besides the ones sent from Layout:

  • "changed" - when the slideshow switches its view to a new item. event_info parameter in callback contains the current visible item
  • "transition,end" - when a slide transition ends. event_info parameter in callback contains the current visible item
  • "focused" - When the slideshow has received focus. (since 1.8)
  • "unfocused" - When the slideshow has lost focus. (since 1.8)
  • "language,changed" - the program's language changed (since 1.9)

Supported elm_object_item common APIs.

List of examples for the slideshow widget:

Typedefs

typedef Evas_Object *(* SlideshowItemGetFunc )(void *data, Evas_Object *obj)
typedef void(* SlideshowItemDelFunc )(void *data, Evas_Object *obj)
typedef struct
_Elm_Slideshow_Item_Class 
Elm_Slideshow_Item_Class
typedef struct
_Elm_Slideshow_Item_Class_Func 
Elm_Slideshow_Item_Class_Func

Typedef Documentation

Slideshow item class definition struct

typedef struct _Elm_Slideshow_Item_Class_Func Elm_Slideshow_Item_Class_Func

Class functions for slideshow item classes.

typedef void(* SlideshowItemDelFunc)(void *data, Evas_Object *obj)

Deletion class function for slideshow item classes.

typedef Evas_Object*(* SlideshowItemGetFunc)(void *data, Evas_Object *obj)

Image fetching class function for slideshow item classes.