Tizen Native API  5.5

index_inheritance_tree.png

An index widget gives you an index for quick 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 lists, generic lists or general grids.

This widget inherits from the Layout one, so that all the functions acting on it also work for index objects.

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

  • "changed" - When the selected index item changes. event_info is the selected item's data pointer.
  • "delay,changed" - When the selected index item changes, but after a small idling period. event_info is the selected item's data pointer.
  • "selected" - When the user releases a mouse button and selects an item. event_info is the selected item's pointer.
  • "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
  • "language,changed" - the program's language changed
  • "focused" - When the index has received focus. (since 1.8)
  • "unfocused" - When the index has lost focus. (since 1.8)

The "delay,changed" event is so that it'll wait a small time before actually reporting those events and, moreover, just the last event happening on those time frames will actually be reported.

Supported elm_object_item common APIs

  • elm_object_item_del

Here are some examples on its usage:

Functions

Evas_Objectelm_index_add (Evas_Object *parent)
void elm_index_horizontal_set (Evas_Object *obj, Eina_Bool horizontal)
 Enable or disable horizontal mode on the index object.
Eina_Bool elm_index_horizontal_get (const Evas_Object *obj)
 Get enable or disable status of horizontal mode on the index object.

Function Documentation

Add a new index widget to the given parent Elementary (container) object

Parameters:
parentThe parent object
Returns:
a new index widget handle or NULL, on errors

This function inserts a new index widget on the canvas.

Since :
2.3
Examples:
index_example_01.c, and index_example_02.c.

Get enable or disable status of horizontal mode on the index object.

Note:
Vertical mode is set by default.

Returns the current status of horizontal mode on index object. On horizontal mode items are displayed on index from left to right, instead of from top to bottom. Also, the index will scroll horizontally.

Returns:
Current status of horizontal mode on index object. true if horizontal mode is enabled or false if disabled.
Since :
2.3
void elm_index_horizontal_set ( Evas_Object obj,
Eina_Bool  horizontal 
)

Enable or disable horizontal mode on the index object.

Note:
Vertical mode is set by default.

On horizontal mode items are displayed on index from left to right, instead of from top to bottom. Also, the index will scroll horizontally.

Parameters:
[in]horizontaltrue to enable horizontal or false to disable it, i.e., to enable vertical mode. it's an area one Fingers "finger" wide on the bottom side of the index widget's container.
Since :
2.3