An index widget gives you an index for fast access to whichever group of other UI items one might have.
It’s a list of text items (usually letters, for alphabetically ordered access).
Index widgets are by default hidden and just appear when the
user clicks over it’s reserved area in the canvas. In its
default theme, it’s an area one finger
wide on
the right side of the index widget’s container.
When items on the index are selected, smart callbacks get called, so that its
user can make other container objects to show a given area or child object
depending on the index item selected. You’d probably be using an index together
with List
,
Genlist
or
Gengrid
.
changed
- When the selected index item changes. event_info
is the selected item’s data.
delay,changed
- When the selected index item changes, but
after a small idling period. event_info
is the selected
item’s data.
selected
- When the user releases a mouse button and
selects an item. event_info
is the selected item’s data.
level,up
- when the user moves a finger from the first
level to the second level
level,down
- when the user moves a finger from the second
level to the first level
The delay,changed
event has a delay on change before the event is actually
reported and moreover just the last event happening on those time frames will
actually be reported.
efl.elementary.
Index
(Object parent, *args, **kwargs)¶parent (efl.evas.Object
) – The parent object
**kwargs – All the remaining keyword arguments are interpreted as properties of the instance
efl.elementary.
IndexItem
(letter, callback=None, cb_data=None, *args, **kwargs)¶Despite the most common usage of the letter
argument is for
single char strings, one could use arbitrary strings as index
entries.
item
will be the item returned back on "changed"
,
"delay,changed"
and "selected"
smart events.
letter (string) – Letter under which the item should be indexed
callback (callable) – The function to call when the item is selected.
cb_data – User data for the callback function
**kwargs – All the remaining keyword arguments are interpreted as properties of the instance