A flip selector is a widget to show a set of text items, one at a time, with the same sheet switching style as the clock widget, when one changes the current displaying sheet (thus, the "flip" in the name).

User clicks to flip sheets which are held for some time will make the flip selector to flip continuously and automatically for the user. The interval between flips will keep growing in time, so that it helps the user to reach an item which is distant from the current selection.

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

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

"selected" - when the widget's selected text item is changed. The event_info parameter is the item that was selected.
"overflowed" - when the widget's current selection is changed from the first item in its list to the last
"underflowed" - when the widget's current selection is changed from the last item in its list to the first
"focused" - When the flip selector has received focus. (since 1.8)
"unfocused" - When the flip selector has lost focus. (since 1.8)
"language,changed" - the program's language changed (since 1.9)

Available styles for it:

"default"

Default text parts of the flipselector items that you can use for are:

"default" - A label of the flipselector item

Supported elm_object common APIs.

Supported elm_object_item common APIs.

elm_object_item_del
elm_object_item_part_text_set
elm_object_item_part_text_get
elm_object_item_signal_emit

Functions
EINA_DEPRECATED const char *	elm_flipselector_item_label_get (const Elm_Object_Item *it)
EINA_DEPRECATED void	elm_flipselector_item_label_set (Elm_Object_Item it, const char label)
EINA_DEPRECATED void	elm_flipselector_item_del (Elm_Object_Item *it)
EINA_DEPRECATED void	elm_flipselector_interval_set (Evas_Object *obj, double interval)
EINA_DEPRECATED double	elm_flipselector_interval_get (const Evas_Object *obj)

Function Documentation

EINA_DEPRECATED double elm_flipselector_interval_get ( const Evas_Object * obj )

Get the interval on time updates for an user mouse button hold on a flip selector widget.

Parameters:

obj	The flip selector object

Returns:: The (first) interval value, in seconds, set on it

See also:: elm_flipselector_interval_set() for more details

Deprecated:: Use elm_flipselector_first_interval_get()

EINA_DEPRECATED void elm_flipselector_interval_set	(	Evas_Object *	obj,
		double	interval
	)

Set the interval on time updates for a user mouse button hold on a flip selector widget.

Parameters:

obj	The flip selector object
interval	The (first) interval value in seconds

This interval value is decreased while the user holds the mouse pointer either flipping up or flipping down a given flip selector.

This helps the user to get to a given item distant from the current one easier/faster, as it will start to flip quicker and quicker on mouse button holds.

The calculation for the next flip interval value, starting from the one set with this call, is the previous interval divided by 1.05, so it decreases a little bit.

The default starting interval value for automatic flips is 0.85 seconds.

See also:: elm_flipselector_interval_get()

Deprecated:: Use elm_flipselector_first_interval_set()

EINA_DEPRECATED void elm_flipselector_item_del ( Elm_Object_Item * it )

Delete a given item from a flip selector widget.

Parameters:

it	The item to delete

Deprecated:: Use elm_object_item_del() instead

EINA_DEPRECATED const char* elm_flipselector_item_label_get ( const Elm_Object_Item * it )

Get the label of a given flip selector widget's item.

Parameters:

it	The item to get label from

Returns:: The text label of item or NULL, on errors

See also:: elm_object_item_text_set()

Deprecated:: see elm_object_item_text_get() instead

EINA_DEPRECATED void elm_flipselector_item_label_set	(	Elm_Object_Item *	it,
		const char *	label
	)

Set the label of a given flip selector widget's item.

Parameters:

it	The item to set label on
label	The text label string, in UTF-8 encoding

See also:: elm_object_item_text_get()

Deprecated:: see elm_object_item_text_set() instead

Functions

Function Documentation