multibuttonentry Module

Widget description

A Multibuttonentry is a widget to allow a user enter text and manage it as a number 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 Multibuttonentry loses focus items longer than one line are shrunk to one line.

Typical use case of multibuttonentry is, composing emails/messages to a group of addresses, each of which is an item that can be clicked for further actions.

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

• 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.

• 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 multibuttonentry widget that you can use for are:

• “default” - A label of the multibuttonentry

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

• “default” - A label of the multibuttonentry item

class efl.elementary.multibuttonentry.MultiButtonEntry

Bases: efl.elementary.object.Object

This is the class that actually implements the widget.

editable

Whether the multibuttonentry is to be editable or not.

Type :bool

New in version 1.8.

entry

The Entry object child of the multibuttonentry.

Type :Entry

expanded

The expanded state of the multibuttonentry.

Type :bool

class efl.elementary.multibuttonentry.MultiButtonEntryItem

Bases: efl.elementary.object_item.ObjectItem

An item for the MultiButtonEntry widget.