Hoversel

../_images/hoversel-preview.png

Widget description

A hoversel is a button that pops up a list of items (automatically choosing the direction to display) that have a label and, optionally, an icon to select from.

It is a convenience widget to avoid the need to do all the piecing together yourself. It is intended for a small number of items in the hoversel menu (no more than 8), though is capable of many more.

Emitted signals

  • clicked - the user clicked the hoversel button and popped up the sel

  • selected - an item in the hoversel list is selected. event_info is the item

  • dismissed - the hover is dismissed

  • expanded - the hover is expanded (since 1.9)

  • item,focused - the hoversel item has received focus. (since 1.10)

  • item,unfocused - the hoversel item has lost focus. (since 1.10)

Layout content parts

  • icon - An icon of the hoversel

Layout text parts

  • default - Label of the hoversel

Inheritance diagram

class efl.elementary.Hoversel(Object parent, *args, **kwargs)
Parameters
  • parent (efl.evas.Object) – The parent object

  • **kwargs – All the remaining keyword arguments are interpreted as properties of the instance

class efl.elementary.HoverselItem(label=None, icon_file=None, icon_type=enums.ELM_ICON_NONE, callback=None, cb_data=None, *args, **kwargs)

For more information on what icon_file and icon_type are, see Icon.

Parameters
  • label (string) – The text label to use for the item (None if not desired)

  • icon_file (string) – An image file path on disk to use for the icon or standard icon name (None if not desired)

  • icon_type (Icon type) – The icon type if relevant

  • callback (function) – Convenience function to call when this item is selected

  • cb_data – User data for the callback function

  • **kwargs – All the remaining keyword arguments are interpreted as properties of the instance