More option is composed of the toggle(cue button) and more option view, and more option can change a visibility through the toggle.

More option is based on elm_panel, but more option is different from elm_panel in that the former does not set the scrollable option. To show the more option view, select the toggle or manually use eext_more_option_opened_set(). To hide the more option view, trigger the back event or manually use eext_more_option_opened_set(). Additionally, the toggle disappears when more option view appears. On the other hand, the toggle appears when more option view disappears. The more option view can be manually set by eext_more_option_opened_set() API. An item of more option object can be selected by rotary event.

This widget emits the following signals:

"item,selected": When the user selects an item.
"item,clicked": When the user selects the already selected item again or selects a selector.
"more,option,opened": When more option view is shown.
"more,option,closed": When more option view is hidden.

Functions
Evas_Object *	eext_more_option_add (Evas_Object *parent)
	Add a new more option.
void	eext_more_option_direction_set (Evas_Object *obj, Eext_More_Option_Direction direction)
	Set the direction of more option.
Eext_More_Option_Direction	eext_more_option_direction_get (const Evas_Object *obj)
	Get Eext_More_Option_Direction.
Eext_Object_Item *	eext_more_option_item_append (Evas_Object *obj)
	Append a new item to a more option.
Eext_Object_Item *	eext_more_option_item_prepend (Evas_Object *obj)
	prepend a new item to a more option.
Eext_Object_Item *	eext_more_option_item_insert_after (Evas_Object obj, Eext_Object_Item after)
	Insert a new item into the more option after more option item after.
Eext_Object_Item *	eext_more_option_item_insert_before (Evas_Object obj, Eext_Object_Item before)
	Insert a new item into the more option before more option item before.
void	eext_more_option_item_del (Eext_Object_Item *item)
	Delete an item which is the given more option item item.
void	eext_more_option_items_clear (Evas_Object *obj)
	Remove all items from a given more option object.
void	eext_more_option_item_part_text_set (Eext_Object_Item item, const char part_name, const char *text)
	Set the text of a more option object.
const char *	eext_more_option_item_part_text_get (const Eext_Object_Item item, const char part_name)
	Set the text of a more option object.
void	eext_more_option_item_domain_translatable_part_text_set (Eext_Object_Item item, const char part_name, const char domain, const char text)
	Set the translatable text of a more option object.
void	eext_more_option_item_part_content_set (Eext_Object_Item item, const char part_name, Evas_Object *content)
	Set the content to the part of a given container widget.
Evas_Object *	eext_more_option_item_part_content_get (const Eext_Object_Item item, const char part_name)
	Get the content from the part of a given container widget.
void	eext_more_option_opened_set (Evas_Object *obj, Eina_Bool opened)
	Set the visibility of more option view.
Eina_Bool	eext_more_option_opened_get (Evas_Object *obj)
	Get whether the more option is set to be shown or to be hidden.
const Eina_List *	eext_more_option_items_get (const Evas_Object *obj)
	Get the list of all items from a given more option object.
Eina_Bool	eext_more_option_editing_enabled_get (const Evas_Object *obj)
	Get whether the more option object edit mode is enabled or not.
void	eext_more_option_editing_enabled_set (Evas_Object *obj, Eina_Bool enabled)
	Set whether the more option object edit mode is enabled or not.
Eina_Bool	eext_more_option_add_item_enabled_get (const Evas_Object *obj)
	Get whether item(s) can be added in the edit mode or not.
void	eext_more_option_add_item_enabled_set (Evas_Object *obj, Eina_Bool enabled)
	Set whether item(s) can be added in the edit mode or not.
Eina_Bool	eext_more_option_item_delete_enabled_get (const Eext_Object_Item *item)
	Get whether the item can be deleted in the edit mode or not.
void	eext_more_option_item_delete_enabled_set (Eext_Object_Item *item, Eina_Bool enabled)
	Set whether the item can be deleted in the edit mode or not. By default, it is enabled.

Enumeration Type Documentation

enum Eext_More_Option_Direction

Enumeration of More Option Direction type.

Enumerator:

EEXT_MORE_OPTION_DIRECTION_TOP	More option (dis)appears from the top
EEXT_MORE_OPTION_DIRECTION_BOTTOM	More option (dis)appears from the bottom
EEXT_MORE_OPTION_DIRECTION_LEFT	More option (dis)appears from the left
EEXT_MORE_OPTION_DIRECTION_RIGHT	More option (dis)appears from the right
EEXT_MORE_OPTION_DIRECTION_TOP	More option (dis)appears from the top
EEXT_MORE_OPTION_DIRECTION_BOTTOM	More option (dis)appears from the bottom
EEXT_MORE_OPTION_DIRECTION_LEFT	More option (dis)appears from the left
EEXT_MORE_OPTION_DIRECTION_RIGHT	More option (dis)appears from the right

enum Eext_More_Option_Direction

Enumeration of More Option Direction type.

Enumerator:

EEXT_MORE_OPTION_DIRECTION_TOP	More option (dis)appears from the top
EEXT_MORE_OPTION_DIRECTION_BOTTOM	More option (dis)appears from the bottom
EEXT_MORE_OPTION_DIRECTION_LEFT	More option (dis)appears from the left
EEXT_MORE_OPTION_DIRECTION_RIGHT	More option (dis)appears from the right
EEXT_MORE_OPTION_DIRECTION_TOP	More option (dis)appears from the top
EEXT_MORE_OPTION_DIRECTION_BOTTOM	More option (dis)appears from the bottom
EEXT_MORE_OPTION_DIRECTION_LEFT	More option (dis)appears from the left
EEXT_MORE_OPTION_DIRECTION_RIGHT	More option (dis)appears from the right

Function Documentation

Evas_Object * eext_more_option_add ( Evas_Object * parent )

Add a new more option.

Because the return value is the elm_layout handle, the elm_layout APIs can be applicable to more option handle.

Parameters:

[in] parent The parent object

Returns:: A new more option handle, otherwise NULL if it cannot be created

Since :: 2.3.1

Eina_Bool eext_more_option_add_item_enabled_get ( const Evas_Object * obj )

Get whether item(s) can be added in the edit mode or not.

Parameters:

[in] obj The more option object

See also:: eext_more_option_add_item_enabled_set(); eext_more_option_editing_enabled_get(); eext_more_option_editing_enabled_set()

Returns:: EINA_TRUE if item(s) can be added, otherwise EINA_FALSE

When add item is enabled, in the editing mode, the add item is shown at the end of the item list. If users click the add item, the "add_item,clicked" signal is emitted.

Since :: 4.0

void eext_more_option_add_item_enabled_set	(	Evas_Object *	obj,
		Eina_Bool	enabled
	)

Set whether item(s) can be added in the edit mode or not.

Parameters:

[in]	obj	The more option object
[in]	enabled	enable delete item in the edit mode

See also:: eext_more_option_add_item_enabled_get(); eext_more_option_editing_enabled_get(); eext_more_option_editing_enabled_set()

When add item is enabled, in the editing mode, the add item is shown at the end of the item list. If users click the add item, the "add_item,clicked" signal is emitted.

Since :: 4.0

Eext_More_Option_Direction eext_more_option_direction_get ( const Evas_Object * obj )

Get Eext_More_Option_Direction.

Parameters:

[in] obj The more option

Returns:: A direction of more option

See also:: eext_more_option_direction_set() Eext_More_Option_Direction

Since :: 2.3.1

void eext_more_option_direction_set	(	Evas_Object *	obj,
		Eext_More_Option_Direction	direction
	)

Set the direction of more option.

Parameters:

[in]	obj	The more option
[in]	direction	The direction of more option

See also:: eext_more_option_direction_get() Eext_More_Option_Direction

Since :: 2.3.1

Eina_Bool eext_more_option_editing_enabled_get ( const Evas_Object * obj )

Get whether the more option object edit mode is enabled or not.

Parameters:

[in] obj The more option object

See also:: eext_more_option_editing_enabled_set()

Returns:: enabling of the more option object's editing mode

Since :: 4.0

void eext_more_option_editing_enabled_set	(	Evas_Object *	obj,
		Eina_Bool	enabled
	)

Set whether the more option object edit mode is enabled or not.

Parameters:

[in]	obj	The more option object
[in]	enabled	enable editing mode

See also:: eext_more_option_editing_enabled_get()

Since :: 4.0

Eext_Object_Item * eext_more_option_item_append ( Evas_Object * obj )

Append a new item to a more option.

Parameters:

[in] obj The more option

Returns:: A handle to the item added, otherwise NULL in case of an error

See also:: Eext_Object_Item

Since :: 2.3.1

void eext_more_option_item_del ( Eext_Object_Item * item )

Delete an item which is the given more option item item.

Parameters:

[in] item The more option item

Since :: 2.3.1

Eina_Bool eext_more_option_item_delete_enabled_get ( const Eext_Object_Item * item )

Get whether the item can be deleted in the edit mode or not.

Parameters:

[in] item The more option object item

See also:: eext_more_option_item_delete_enabled_set(); eext_more_option_editing_enabled_get(); eext_more_option_editing_enabled_set()

Returns:: EINA_TRUE if item can be deleted, otherwise EINA_FALSE

Since :: 4.0

void eext_more_option_item_delete_enabled_set	(	Eext_Object_Item *	item,
		Eina_Bool	enabled
	)

Set whether the item can be deleted in the edit mode or not. By default, it is enabled.

Parameters:

[in]	item	The more option object item
[in]	enabled	enable delete item in the edit mode

See also:: eext_more_option_item_delete_enabled_get(); eext_more_option_editing_enabled_get(); eext_more_option_editing_enabled_set()

Since :: 4.0

void eext_more_option_item_domain_translatable_part_text_set	(	Eext_Object_Item *	item,
		const char *	part_name,
		const char *	domain,
		const char *	text
	)

Set the translatable text of a more option object.

The part name exists with the next.

"selector,main_text": This locates in the middle of the selector.
"selector,sub_text": This locates under the main_text.

Parameters:

[in]	item	The more option item
[in]	part_name	The text part name to set (`NULL` for the default part)
[in]	domain	The name of the domain which contains translatable text
[in]	text	ID of the new translatable text

See also:: eext_more_option_item_part_text_get()

Since :: 2.3.1

Eext_Object_Item * eext_more_option_item_insert_after	(	Evas_Object *	obj,
		Eext_Object_Item *	after
	)

Insert a new item into the more option after more option item after.

Parameters:

[in]	obj	The more option
[in]	after	The more option item to insert after

Returns:: A handle to the item added, otherwise NULL in case of an error

See also:: Eext_Object_Item

Since :: 2.3.1

Eext_Object_Item * eext_more_option_item_insert_before	(	Evas_Object *	obj,
		Eext_Object_Item *	before
	)

Insert a new item into the more option before more option item before.

Parameters:

[in]	obj	The more option
[in]	before	The more option item to insert before

Returns:: A handle to the item added, otherwise NULL in case of an error

See also:: Eext_Object_Item

Since :: 2.3.1

Evas_Object * eext_more_option_item_part_content_get	(	const Eext_Object_Item *	item,
		const char *	part_name
	)

Get the content from the part of a given container widget.

The part name exists with the next.

"item,icon": This locates in the middle of the selector.

Parameters:

[in]	item	The more option item
[in]	part_name	The more option item's part name to get

Returns:: The content of the object at the given part, otherwise NULL in case of an error

See also:: eext_more_option_item_part_content_set()

Since :: 2.3.1

void eext_more_option_item_part_content_set	(	Eext_Object_Item *	item,
		const char *	part_name,
		Evas_Object *	content
	)

Set the content to the part of a given container widget.

The part name exists with the next.

"item,icon": This locates in the middle of the selector.

Remarks:: The more option item may hold child objects as content at given parts. This sets new content to a given part. If any object is already set as a content object in the same part, the previous object is automatically deleted. with this call.

Parameters:

[in]	item	The more option item
[in]	part_name	The more option item's part name to set
[in]	content	The new content for that part

See also:: eext_more_option_item_part_content_get()

Since :: 2.3.1

const char * eext_more_option_item_part_text_get	(	const Eext_Object_Item *	item,
		const char *	part_name
	)

Set the text of a more option object.

The part name exists with the next.

"selector,main_text": This locates in the middle of the selector.
"selector,sub_text": This locates under the main_text.

Parameters:

[in]	item	The more option item
[in]	part_name	The text part name to get (`NULL` for the default part)

Returns:: The text of the part, otherwise NULL in case of an error

See also:: eext_more_option_item_part_text_set()

Since :: 2.3.1

void eext_more_option_item_part_text_set	(	Eext_Object_Item *	item,
		const char *	part_name,
		const char *	text
	)

Set the text of a more option object.

The part name exists with the next.

"selector,main_text": This locates in the middle of the selector.
"selector,sub_text": This locates under the main_text.

Parameters:

[in]	item	The more option item
[in]	part_name	The text part name to set (`NULL` for the default part)
[in]	text	The new text of the part

See also:: eext_more_option_item_part_text_get()

Since :: 2.3.1

Eext_Object_Item * eext_more_option_item_prepend ( Evas_Object * obj )

prepend a new item to a more option.

Parameters:

[in] obj The more option

Returns:: A handle to the item added, otherwise NULL in case of an error

See also:: Eext_Object_Item

Since :: 2.3.1

void eext_more_option_items_clear ( Evas_Object * obj )

Remove all items from a given more option object.

Parameters:

[in] obj The more option

Since :: 2.3.1

const Eina_List * eext_more_option_items_get ( const Evas_Object * obj )

Get the list of all items from a given more option object.

Parameters:

[in] obj The more option object

Returns:: All item lists of the more option..

Since :: 2.3.1

Eina_Bool eext_more_option_opened_get ( Evas_Object * obj )

Get whether the more option is set to be shown or to be hidden.

Parameters:

[in] obj The more option object

Returns:: If EINA_TRUE, more option is shown. Otherwise EINA_FALSE, more option is hidden.

See also:: eext_more_option_opened_set()

Since :: 2.3.1

void eext_more_option_opened_set	(	Evas_Object *	obj,
		Eina_Bool	opened
	)

Set the visibility of more option view.

If opened is EINA_TRUE, more option view in which the rotary selector is included disappears and toggle appears. If opened is EINA_FALSE, more option view in which the rotary selector is included appears and toggle disappear.

Remarks:: When more option is closed and opened again, the first item is always selected.

Parameters:

[in]	obj	The more option object
[in]	opened	If `EINA_TRUE`, the more option runs the animation to appear, If `EINA_FALSE`, the more option runs the animation to disappear

See also:: eext_more_option_opened_get()

Since :: 2.3.1

Functions

Enumeration Type Documentation

Function Documentation