A menu is a list of items displayed above its parent.
When the menu is showing its parent is darkened. Each item can have a sub-menu. The menu object can be used to display a menu on a right click event, in a toolbar, anywhere.
clicked
- the user clicked the empty space in the menu to dismiss.
dismissed
- the user clicked the empty space in the menu to dismiss (since 1.8)
default
- A main content of the menu item
default
- label in the menu item
efl.elementary.
Menu
(Object parent, *args, **kwargs)¶Bases: efl.elementary.__init__.Object
parent (efl.evas.Object
) – The parent object
**kwargs – All the remaining keyword arguments are interpreted as properties of the instance
callback_clicked_add
¶The user clicked the empty space in the menu to dismiss.
callback_clicked_del
¶callback_dismissed_add
¶the user clicked the empty space in the menu to dismiss
New in version 1.8.
callback_dismissed_del
¶close
¶Close a opened menu
Hides the menu and all it’s sub-menus.
first_item_get
¶item_add
¶Add an item at the end of the given menu widget
parent (Object
) – The parent menu item (optional)
label (string) – The label of the item.
icon (string) – An icon display on the item. The icon will be destroyed by the menu.
callback (function) – Function called when the user select the item.
Returns the new item.
item_separator_add
¶Add a separator item to menu under parent
.
This item is a Separator
.
parent (Object
) – The item to add the separator under
The created item or None on failure
MenuSeparatorItem
items_get
¶last_item_get
¶move
¶Move the menu to a new position
Sets the top-left position of the menu to (x
, y
).
Note
x
and y
coordinates are relative to parent.
x (Evas_Coord (int)) – The new position.
y (Evas_Coord (int)) – The new position.
open
¶Open a closed menu
Show the menu with no child sub-menus expanded.
New in version 1.20.
parent
¶The parent for the given menu widget.
Object
parent_get
¶selected_item
¶The selected item in the menu
See also
selected_item_get
¶efl.elementary.
MenuItem
(MenuItem parent=None, label=None, icon=None, callback=None, cb_data=None, *args, **kargs)¶Bases: efl.elementary.__init__.ObjectItem
add_to
¶icon_name
¶The standard icon name of a menu item
Once this icon is set, any previously set icon will be deleted.
string
icon_name_get
¶icon_name_set
¶index
¶Get the position of a menu item
This function returns the index position of a menu item in a menu. For a sub-menu, this number is relative to the first item in the sub-menu.
Note
Index values begin with 0
int
index_get
¶is_separator
¶Returns whether the item is a separator.
See also
bool
next_get
¶object
¶Get the Evas_Object of an Elm_Object_Item
Warning
Don’t manipulate this object!
The edje object containing the swallowed content
object_get
¶prev_get
¶selected
¶The selected state of the item.
bool
selected_get
¶selected_set
¶subitems
¶A list of item’s subitems.
tuple of MenuItem
New in version 1.8: Calling del on this property clears the subitems
subitems_clear
¶subitems_get
¶