Typedefs | Functions
Multibuttonentry

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. More...
 
typedef char *(* Elm_Multibuttonentry_Format_Cb) (int count, void *data)
 This callback type is used to format the string that will be used to display the hidden items counter, when not in expanded mode. More...
 

Functions

Evas_Objectelm_multibuttonentry_add (Evas_Object *parent)
 Add a new multibuttonentry to the parent. More...
 
void elm_multibuttonentry_format_function_set (Eo *obj, Elm_Multibuttonentry_Format_Cb format_function, const void *data)
 Set a function to format the string that will be used to display the hidden items counter. More...
 

Detailed Description

A multi-button entry is a widget letting a 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 :

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

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

Supported elm_object_item common APIs.

Typedef Documentation

◆ Elm_Multibuttonentry_Item_Filter_Cb

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
objThe parent object
item_labelThe label corresponding to the added item.
item_datadata specific to this item.
datadata specific to the multibuttonentry.
Returns
EINA_TRUE EINA_FALSE otherwise.

◆ Elm_Multibuttonentry_Format_Cb

Elm_Multibuttonentry_Format_Cb

This callback type is used to format the string that will be used to display the hidden items counter, when not in expanded mode.

Parameters
countNumber of hidden items
dataThe (context) data passed in to elm_multibuttonentry_format_function_set()
Returns
String representing the counter that will be set to multibuttonentry's counter item's text.
See also
elm_multibuttonentry_format_function_set()
elm_multibuttonentry_expanded_set()

Function Documentation

◆ elm_multibuttonentry_add()

Evas_Object * elm_multibuttonentry_add ( Evas_Object parent)

Add a new multibuttonentry to the parent.

Parameters
parentThe parent object
Returns
The new object or NULL if it cannot be created

References EINA_SAFETY_ON_NULL_RETURN_VAL.

◆ elm_multibuttonentry_format_function_set()

void elm_multibuttonentry_format_function_set ( Eo *  obj,
Elm_Multibuttonentry_Format_Cb  format_function,
const void *  data 
)

Set a function to format the string that will be used to display the hidden items counter.

If format_function is NULL, the default format will be used, which is $"... + %d".

Parameters
[in]objThe object.
[in]format_functionFormat_function The actual format function
[in]dataData User data to passed to format_function
Since
1.9