Tizen Native API  4.0
Efl Extension More Option

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_Objecteext_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_Itemeext_more_option_item_append (Evas_Object *obj)
 Append a new item to a more option.
Eext_Object_Itemeext_more_option_item_prepend (Evas_Object *obj)
 prepend a new item to a more option.
Eext_Object_Itemeext_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_Itemeext_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_Objecteext_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_Listeext_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

Enumeration of More Option Diection 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

Enumeration of More Option Diection 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

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]parentThe parent object
Returns:
A new more option handle, otherwise NULL if it cannot be created
Since :
2.3.1

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

Parameters:
[in]objThe 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

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

Parameters:
[in]objThe more option object
[in]enabledenable 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

Get Eext_More_Option_Direction.

Parameters:
[in]objThe more option
Returns:
A direction of more option
See also:
eext_more_option_direction_set() Eext_More_Option_Direction
Since :
2.3.1

Set the direction of more option.

Parameters:
[in]objThe more option
[in]directionThe direction of more option
See also:
eext_more_option_direction_get() Eext_More_Option_Direction
Since :
2.3.1

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

Parameters:
[in]objThe more option object
See also:
eext_more_option_editing_enabled_set()
Returns:
enabling of the more option object's editing mode
Since :
4.0

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

Parameters:
[in]objThe more option object
[in]enabledenable editing mode
See also:
eext_more_option_editing_enabled_get()
Since :
4.0

Append a new item to a more option.

Parameters:
[in]objThe 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

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

Parameters:
[in]itemThe more option item
Since :
2.3.1

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

Parameters:
[in]itemThe 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

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

Parameters:
[in]itemThe more option object item
[in]enabledenable 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]itemThe more option item
[in]part_nameThe text part name to set (NULL for the default part)
[in]domainThe name of the domain which contains translatable text
[in]textID of the new translatable text
See also:
eext_more_option_item_part_text_get()
Since :
2.3.1

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

Parameters:
[in]objThe more option
[in]afterThe 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

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

Parameters:
[in]objThe more option
[in]beforeThe 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]itemThe more option item
[in]part_nameThe 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]itemThe more option item
[in]part_nameThe more option item's part name to set
[in]contentThe 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]itemThe more option item
[in]part_nameThe 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]itemThe more option item
[in]part_nameThe text part name to set (NULL for the default part)
[in]textThe new text of the part
See also:
eext_more_option_item_part_text_get()
Since :
2.3.1

prepend a new item to a more option.

Parameters:
[in]objThe 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

Remove all items from a given more option object.

Parameters:
[in]objThe more option
Since :
2.3.1

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

Parameters:
[in]objThe more option object
Returns:
All item lists of the more option..
Since :
2.3.1

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

Parameters:
[in]objThe 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]objThe more option object
[in]openedIf 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