Functions
Evas_Object *	elm_multibuttonentry_add (Evas_Object *parent)
	Add a new multibuttonentry to the parent.
void	elm_multibuttonentry_editable_set (Elm_Multibuttonentry *obj, Eina_Bool editable)
	Sets if the multibuttonentry is to be editable or not.
Eina_Bool	elm_multibuttonentry_editable_get (const Elm_Multibuttonentry *obj)
	Get whether the multibuttonentry is editable or not.
void	elm_multibuttonentry_expanded_set (Elm_Multibuttonentry *obj, Eina_Bool expanded)
	Set/Unset the multibuttonentry to expanded state.
Eina_Bool	elm_multibuttonentry_expanded_get (const Elm_Multibuttonentry *obj)
	Get the value of expanded state.
const Eina_List *	elm_multibuttonentry_items_get (const Elm_Multibuttonentry *obj)
	Get a list of items in the multibuttonentry.
Elm_Object_Item *	elm_multibuttonentry_first_item_get (const Elm_Multibuttonentry *obj)
	Get the first item in the multibuttonentry.
Elm_Object_Item *	elm_multibuttonentry_last_item_get (const Elm_Multibuttonentry *obj)
	Get the last item in the multibuttonentry.
Evas_Object *	elm_multibuttonentry_entry_get (const Elm_Multibuttonentry *obj)
	Get the entry of the multibuttonentry object.
Elm_Object_Item *	elm_multibuttonentry_selected_item_get (const Elm_Multibuttonentry *obj)
	Get the selected item in the multibuttonentry.
Elm_Object_Item *	elm_multibuttonentry_item_prepend (Elm_Multibuttonentry obj, const char label, Evas_Smart_Cb func, void *data)
	Prepend a new item to the multibuttonentry.
void	elm_multibuttonentry_clear (Elm_Multibuttonentry *obj)
	Remove all items in the multibuttonentry.
void	elm_multibuttonentry_item_filter_remove (Elm_Multibuttonentry obj, Elm_Multibuttonentry_Item_Filter_Cb func, void data)
	Remove a filter from the list.
Elm_Object_Item *	elm_multibuttonentry_item_insert_before (Elm_Multibuttonentry obj, Elm_Object_Item before, const char label, Evas_Smart_Cb func, void data)
	Add a new item to the multibuttonentry before the indicated object reference.
Elm_Object_Item *	elm_multibuttonentry_item_append (Elm_Multibuttonentry obj, const char label, Evas_Smart_Cb func, void *data)
	Append a new item to the multibuttonentry.
void	elm_multibuttonentry_item_filter_prepend (Elm_Multibuttonentry obj, Elm_Multibuttonentry_Item_Filter_Cb func, void data)
	Prepend a filter function for text inserted in the Multibuttonentry.
void	elm_multibuttonentry_item_filter_append (Elm_Multibuttonentry obj, Elm_Multibuttonentry_Item_Filter_Cb func, void data)
	Append an item filter function for text inserted in the Multibuttonentry.
Elm_Object_Item *	elm_multibuttonentry_item_insert_after (Elm_Multibuttonentry obj, Elm_Object_Item after, const char label, Evas_Smart_Cb func, void data)
	Add a new item to the multibuttonentry after the indicated object.
void	elm_multibuttonentry_item_selected_set (Elm_Multibuttonentry_Item *obj, Eina_Bool selected)
Eina_Bool	elm_multibuttonentry_item_selected_get (const Elm_Multibuttonentry_Item *obj)
Elm_Object_Item *	elm_multibuttonentry_item_prev_get (const Elm_Multibuttonentry_Item *obj)
Elm_Object_Item *	elm_multibuttonentry_item_next_get (const Elm_Multibuttonentry_Item *obj)
Typedefs
typedef Eina_Bool(*	Elm_Multibuttonentry_Item_Filter_Cb )(Evas_Object obj, const char item_label, void item_data, void data)
	Callback to be invoked when an item is added to the multibuttonentry.

A multi-button entry is a widget letting an user enter text and each chunk of text managed as a set of buttons. Each text button is inserted by pressing the "return" key. If there is no space in the current row, a new button is added to the next row. When a text button is pressed, it will become focused. Backspace removes the focus. When the multi-button entry loses focus, items longer than one line are shrunk to one line.

The typical use case of multi-button entry is composing emails/messages to a group of addresses, each of which is an item that can be clicked for further actions.

This widget inherits from the Layout one, so that all the functions acting on it also work for multi-button entry objects (since 1.8).

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

"item,selected" - this is called when an item is selected by api, user interaction, and etc. this is also called when a user press back space while cursor is on the first field of entry.
"item,added" - when a new multi-button entry item is added.
"item,deleted" - when a multi-button entry item is deleted.
"item,clicked" - this is called when an item is clicked by user interaction. Both "item,selected" and "item,clicked" are needed.
"item,longpressed" - when multi-button entry item is pressed for a long time.
"clicked" - when multi-button entry is clicked.
"focused" - when multi-button entry is focused.
"unfocused" - when multi-button entry is unfocused.
"expanded" - when multi-button entry is expanded.
"contracted" - when multi-button entry is contracted.
"expand,state,changed" - when shrink mode state of multi-button entry is changed.

Default text parts of the multi-button entry widget that you can use are:

"default" - A label of the multi-button entry

Default text parts of multi-button entry items that you can use are:

"default" - A label of the multi-button entry item

Supported elm_object_item common APIs.

Typedef Documentation

typedef Eina_Bool(* Elm_Multibuttonentry_Item_Filter_Cb)(Evas_Object *obj, const char *item_label, void *item_data, void *data)

Callback to be invoked when an item is added to the multibuttonentry.

Parameters:

obj	The parent object
item_label	The label corresponding to the added item.
item_data	data specific to this item.
data	data specific to the multibuttonentry.

Returns:: EINA_TRUE EINA_FALSE otherwise.

Function Documentation

Evas_Object* elm_multibuttonentry_add ( Evas_Object * parent )

Add a new multibuttonentry to the parent.

Since :: 2.3

Parameters:

[in] parent The parent object

Returns:: The new object or NULL if it cannot be created

void elm_multibuttonentry_clear ( Elm_Multibuttonentry * obj )

Remove all items in the multibuttonentry.

Since :: 2.3

Parameters:

[in] obj The elm multibuttonentry object

Eina_Bool elm_multibuttonentry_editable_get ( const Elm_Multibuttonentry * obj )

Get whether the multibuttonentry is editable or not.

Since :: 2.3

Returns:: EINA_TRUE if the multibuttonentry is editable by the user. EINA_FALSE if not.

Since (EFL) :: 1.7

Parameters:

[in] obj The elm multibuttonentry object

void elm_multibuttonentry_editable_set	(	Elm_Multibuttonentry *	obj,
		Eina_Bool	editable
	)

Sets if the multibuttonentry is to be editable or not.

Since :: 2.3

Since (EFL) :: 1.7

Parameters:

[in]	obj	The elm multibuttonentry object
[in]	editable	If `EINA_TRUE`, user can add/delete item in multibuttonentry, if not, the multibuttonentry is non-editable.

Evas_Object* elm_multibuttonentry_entry_get ( const Elm_Multibuttonentry * obj )

Get the entry of the multibuttonentry object.

Since :: 2.3

Returns:: The entry object, or NULL if none

Parameters:

[in] obj The elm multibuttonentry object

Eina_Bool elm_multibuttonentry_expanded_get ( const Elm_Multibuttonentry * obj )

Get the value of expanded state.

Since :: 2.3

Remarks:: In expanded state, the complete entry will be displayed. Otherwise, only single line of the entry will be displayed.

Returns:: EINA_TRUE if the widget is in expanded state. EINA_FALSE if not.

Parameters:

[in] obj The elm multibuttonentry object

void elm_multibuttonentry_expanded_set	(	Elm_Multibuttonentry *	obj,
		Eina_Bool	expanded
	)

Set/Unset the multibuttonentry to expanded state.

Since :: 2.3

Remarks:: In expanded state, the complete entry will be displayed. Otherwise, only single line of the entry will be displayed.

Parameters:

[in]	obj	The elm multibuttonentry object
[in]	expanded	the value of expanded state. Set this to `EINA_TRUE` for expanded state. Set this to EINA_FALSE for single line state.

Elm_Object_Item* elm_multibuttonentry_first_item_get ( const Elm_Multibuttonentry * obj )

Get the first item in the multibuttonentry.

Since :: 2.3

Returns:: The first item, or NULL if none

Parameters:

[in] obj The elm multibuttonentry object

Elm_Object_Item* elm_multibuttonentry_item_append	(	Elm_Multibuttonentry *	obj,
		const char *	label,
		Evas_Smart_Cb	func,
		void *	data
	)

Append a new item to the multibuttonentry.

Since :: 2.3

Returns:: A handle to the item added or NULL if not possible

See also:: Use elm_object_item_del() to delete the item.

Parameters:

[in]	obj	The elm multibuttonentry object
[in]	label	The label of new item
[in]	func	The callback function to be invoked when this item is pressed.
[in]	data	The pointer to the data to be attached

void elm_multibuttonentry_item_filter_append	(	Elm_Multibuttonentry *	obj,
		Elm_Multibuttonentry_Item_Filter_Cb	func,
		void *	data
	)

Append an item filter function for text inserted in the Multibuttonentry.

Since :: 2.3

Remarks:: Append the given callback to the list. This functions will be called whenever any text is inserted into the Multibuttonentry, with the text to be inserted as a parameter. The callback function is free to alter the text in any way it wants, but it must remember to free the given pointer and update it. If the new text is to be discarded, the function can free it and set it text parameter to NULL. This will also prevent any following filters from being called.

Parameters:

[in]	obj	The elm multibuttonentry object
[in]	func	The function to use as item filter
[in]	data	User data to pass to `func`

void elm_multibuttonentry_item_filter_prepend	(	Elm_Multibuttonentry *	obj,
		Elm_Multibuttonentry_Item_Filter_Cb	func,
		void *	data
	)

Prepend a filter function for text inserted in the Multibuttonentry.

Since :: 2.3

Remarks:: Prepend the given callback to the list. See elm_multibuttonentry_item_filter_append() for more information

Parameters:

[in]	obj	The elm multibuttonentry object
[in]	func	The function to use as text filter
[in]	data	User data to pass to `func`

void elm_multibuttonentry_item_filter_remove	(	Elm_Multibuttonentry *	obj,
		Elm_Multibuttonentry_Item_Filter_Cb	func,
		void *	data
	)

Remove a filter from the list.

Since :: 2.3

Remarks:: Removes the given callback from the filter list. See elm_multibuttonentry_item_filter_append() for more information.

Parameters:

[in]	obj	The elm multibuttonentry object
[in]	func	The filter function to remove
[in]	data	The user data passed when adding the function

Elm_Object_Item* elm_multibuttonentry_item_insert_after	(	Elm_Multibuttonentry *	obj,
		Elm_Object_Item *	after,
		const char *	label,
		Evas_Smart_Cb	func,
		void *	data
	)

Add a new item to the multibuttonentry after the indicated object.

Since :: 2.3

Returns:: A handle to the item added or NULL if not possible

See also:: Use elm_object_item_del() to delete the item.

Parameters:

[in]	obj	The elm multibuttonentry object
[in]	after	The item after which to add it
[in]	label	The label of new item
[in]	func	The callback function to be invoked when this item is pressed.
[in]	data	The pointer to the data to be attached

Elm_Object_Item* elm_multibuttonentry_item_insert_before	(	Elm_Multibuttonentry *	obj,
		Elm_Object_Item *	before,
		const char *	label,
		Evas_Smart_Cb	func,
		void *	data
	)

Add a new item to the multibuttonentry before the indicated object reference.

Since :: 2.3

Returns:: A handle to the item added or NULL if not possible

See also:: Use elm_object_item_del() to delete the item.

Parameters:

[in]	obj	The elm multibuttonentry object
[in]	before	The item before which to add it
[in]	label	The label of new item
[in]	func	The callback function to be invoked when this item is pressed.
[in]	data	The pointer to the data to be attached

Elm_Object_Item* elm_multibuttonentry_item_next_get ( const Elm_Multibuttonentry_Item * obj )

Get the next item in the multibuttonentry

Since :: 2.3

Returns:: The item after the item it

Parameters:

[in] obj The elm multibuttonentry item object

Elm_Object_Item* elm_multibuttonentry_item_prepend	(	Elm_Multibuttonentry *	obj,
		const char *	label,
		Evas_Smart_Cb	func,
		void *	data
	)

Prepend a new item to the multibuttonentry.

Since :: 2.3

Returns:: A handle to the item added or NULL if not possible

See also:: Use elm_object_item_del() to delete the item.

Parameters:

[in]	obj	The elm multibuttonentry object
[in]	label	The label of new item
[in]	func	The callback function to be invoked when this item is pressed.
[in]	data	The pointer to the data to be attached

Elm_Object_Item* elm_multibuttonentry_item_prev_get ( const Elm_Multibuttonentry_Item * obj )

Get the previous item in the multibuttonentry

Since :: 2.3

Returns:: The item before the item it

Parameters:

[in] obj The elm multibuttonentry item object

Eina_Bool elm_multibuttonentry_item_selected_get ( const Elm_Multibuttonentry_Item * obj )

Get the selected state of an item

Since :: 2.3

Parameters:

[in] obj The elm multibuttonentry item object

void elm_multibuttonentry_item_selected_set	(	Elm_Multibuttonentry_Item *	obj,
		Eina_Bool	selected
	)

Set the selected state of an item

Since :: 2.3

Parameters:

[in]	obj	The elm multibuttonentry item object
[in]	selected	EINA_TRUE if selected EINA_FALSE otherwise

const Eina_List* elm_multibuttonentry_items_get ( const Elm_Multibuttonentry * obj )

Get a list of items in the multibuttonentry.

Since :: 2.3

Returns:: The list of items, or NULL if none

Parameters:

[in] obj The elm multibuttonentry object

Elm_Object_Item* elm_multibuttonentry_last_item_get ( const Elm_Multibuttonentry * obj )

Get the last item in the multibuttonentry.

Since :: 2.3

Returns:: The last item, or NULL if none

Parameters:

[in] obj The elm multibuttonentry object

Elm_Object_Item* elm_multibuttonentry_selected_item_get ( const Elm_Multibuttonentry * obj )

Get the selected item in the multibuttonentry.

Since :: 2.3

Returns:: The selected item, or NULL if none

Parameters:

[in] obj The elm multibuttonentry object

Functions

Typedefs

Typedef Documentation

Function Documentation