#ifndef _ELM_INDEX_EO_H_
#define _ELM_INDEX_EO_H_

#ifndef _ELM_INDEX_EO_CLASS_TYPE
#define _ELM_INDEX_EO_CLASS_TYPE

typedef Eo Elm_Index;

#endif

#ifndef _ELM_INDEX_EO_TYPES
#define _ELM_INDEX_EO_TYPES


#endif
#define ELM_INDEX_CLASS elm_index_class_get()

const Eo_Class *elm_index_class_get(void) EINA_CONST;

/**
 *
 * @brief Enable or disable auto hiding feature for a given index widget.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @see elm_index_autohide_disabled_get()
 *
 * @ingroup Index
 *
 * @param[in] disabled @c EINA_TRUE to disable auto hiding, @c EINA_FALSE to enable
 *
 */
EOAPI void  elm_obj_index_autohide_disabled_set(Eina_Bool disabled);

/**
 *
 * @brief Get whether auto hiding feature is enabled or not for a given index widget.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return @c EINA_TRUE, if auto hiding is disabled, @c EINA_FALSE otherwise
 *
 * @see elm_index_autohide_disabled_set() for more details
 *
 * @ingroup Index
 *
 *
 */
EOAPI Eina_Bool  elm_obj_index_autohide_disabled_get(void);

/**
 *
 * @brief Enable or disable omit feature for a given index widget.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @see elm_index_omit_enabled_get()
 *
 * @since 1.8
 *
 * @ingroup Index
 *
 * @param[in] enabled @c EINA_TRUE to enable omit feature, @c EINA_FALSE to disable
 *
 */
EOAPI void  elm_obj_index_omit_enabled_set(Eina_Bool enabled);

/**
 *
 * @brief Get whether omit feature is enabled or not for a given index widget.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return @c EINA_TRUE, if omit feature is enabled, @c EINA_FALSE otherwise
 *
 * @see elm_index_omit_enabled_set()
 *
 * @since 1.8
 *
 * @ingroup Index
 *
 *
 */
EOAPI Eina_Bool  elm_obj_index_omit_enabled_get(void);

/**
 *
 * Set priority group of index. Priority group will be shown as many items as it can,
 * and other group will be shown one character only.
 *
 * @since tizen 2.4
 *
 * @ingroup Index
 *
 * @param[in] priority @c priority target priority value in index
 *
 */
EOAPI void  elm_obj_index_priority_set(int priority);

/**
 *
 * Get current priority group of index.
 *
 * @return priority value in index
 *
 * @since tizen 2.4
 *
 * @ingroup Index
 *
 *
 */
EOAPI int  elm_obj_index_priority_get(void);

/**
 *
 * @brief Enable or disable horizontal mode on the index object
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @remark Vertical mode is set by default.
 *
 * @remark On horizontal mode items are displayed on index from left to right,
 * instead of from top to bottom. Also, the index will scroll horizontally.
 *
 * @see elm_index_horizontal_get()
 *
 * @ingroup Index
 *
 * @param[in] horizontal @c EINA_TRUE to enable horizontal or @c EINA_FALSE to
disable it, i.e., to enable vertical mode. it's an area one @ref Fingers
"finger" wide on the bottom side of the index widget's container.
 *
 */
EOAPI void  elm_obj_index_horizontal_set(Eina_Bool horizontal);

/**
 *
 * @brief Get a value whether horizontal mode is enabled or not.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return @c EINA_TRUE means horizontal mode selection is enabled.
 * @c EINA_FALSE indicates it's disabled. If @p obj is @c NULL,
 * @c EINA_FALSE is returned.
 *
 * @see elm_index_horizontal_set() for details.
 *
 * @ingroup Index
 *
 *
 */
EOAPI Eina_Bool  elm_obj_index_horizontal_get(void);

/**
 *
 * @brief Set a delay change time for index object.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @remark delay time is 0.2 sec by default.
 *
 * @see elm_index_delay_change_time_get
 *
 * @ingroup Index
 *
 * @param[in] dtime The delay change time to set.
 *
 */
EOAPI void  elm_obj_index_delay_change_time_set(double dtime);

/**
 *
 * @brief Get a delay change time for index object.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return delay change time in seconds
 *
 * @see elm_index_delay_change_time_set
 *
 * @ingroup Index
 *
 *
 */
EOAPI double  elm_obj_index_delay_change_time_get(void);

/**
 *
 * @brief Set the indicator as to be disabled.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @remark In Index widget, Indicator notes popup text, which shows a letter has been selecting.
 *
 * @see elm_index_indicator_disabled_get()
 *
 * @ingroup Index
 *
 * @param[in] disabled @c EINA_TRUE to disable it, @c EINA_FALSE to enable it
 *
 */
EOAPI void  elm_obj_index_indicator_disabled_set(Eina_Bool disabled);

/**
 *
 * @brief Get the value of indicator's disabled status.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return EINA_TRUE if the indicator is disabled.
 *
 * @see elm_index_indicator_disabled_set()
 *
 * @ingroup Index
 *
 *
 */
EOAPI Eina_Bool  elm_obj_index_indicator_disabled_get(void);

/**
 *
 * Set the items level for a given index widget.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @see elm_index_item_level_get()
 *
 * @ingroup Index
 *
 * @param[in] level @c 0 or @c 1, the currently implemented levels.
 *
 */
EOAPI void  elm_obj_index_item_level_set(int level);

/**
 *
 * Get the items level set for a given index widget.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return @c 0 or @c 1, which are the levels @p obj might be at.
 *
 * @see elm_index_item_level_set() for more information
 *
 * @ingroup Index
 *
 *
 */
EOAPI int  elm_obj_index_item_level_get(void);

/**
 *
 * @brief Flush the changes made to the index items so they work correctly
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @remark This flushes any changes made to items indicating the object is ready to
 * go. You should call this before any changes you expect to work. This
 * is similar to elm_list_go().
 *
 * @warning If not called, it won't display the index properly.
 *
 * @ingroup Index
 * 
 *
 * @param[in] level The index level (one of @c 0 or @c 1) where changes were made
 *
 */
EOAPI void  elm_obj_index_level_go(int level);

/**
 *
 * @brief Prepend a new item on a given index widget.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return A handle to the item added or @c NULL, on errors
 *
 * @remark Despite the most common usage of the @p letter argument is for
 * single char strings, one could use arbitrary strings as index
 * entries.
 *
 * @c item will be the pointer returned back on @c "changed", @c
 * "delay,changed" and @c "selected" smart events.
 *
 * @ingroup Index
 * 
 *
 * @param[in] letter Letter under which the item should be indexed
 * @param[in] func The function to call when the item is selected.
 * @param[in] data The item data to set for the index's item
 *
 */
EOAPI Elm_Object_Item * elm_obj_index_item_prepend(const char *letter, Evas_Smart_Cb func, const void *data);

/**
 *
 * @brief Removes @b all items from a given index widget.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @remark If deletion callbacks are set, via elm_object_item_del_cb_set(),
 * that callback function will be called for each item in @p obj.
 *
 * @ingroup Index
 * 
 *
 *
 */
EOAPI void  elm_obj_index_item_clear(void);

/**
 *
 * @brief Insert a new item into the index object after item @p after.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return A handle to the item added or @c NULL, on errors
 *
 * @remark Despite the most common usage of the @p letter argument is for
 * single char strings, one could use arbitrary strings as index
 * entries.
 *
 * @c item will be the pointer returned back on @c "changed", @c
 * "delay,changed" and @c "selected" smart events.
 *
 * @remark If @p relative is @c NULL this function will behave as
 * elm_index_item_append().
 *
 * @ingroup Index
 * 
 *
 * @param[in] after The index item to insert after.
 * @param[in] letter Letter under which the item should be indexed
 * @param[in] func The function to call when the item is clicked.
 * @param[in] data The item data to set for the index's item
 *
 */
EOAPI Elm_Object_Item * elm_obj_index_item_insert_after(Elm_Object_Item *after, const char *letter, Evas_Smart_Cb func, const void *data);

/**
 *
 * @brief Find a given index widget's item, <b>using item data</b>.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return The index item handle, if found, or @c NULL otherwise
 *
 * @ingroup Index
 * 
 *
 * @param[in] data The item data pointed to by the desired index item
 *
 */
EOAPI Elm_Object_Item * elm_obj_index_item_find(const void *data);

/**
 *
 * @brief Insert a new item into the index object before item @p before.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return A handle to the item added or @c NULL, on errors
 *
 * @remark Despite the most common usage of the @p letter argument is for
 * single char strings, one could use arbitrary strings as index
 * entries.
 *
 * @c item will be the pointer returned back on @c "changed", @c
 * "delay,changed" and @c "selected" smart events.
 *
 * @remark If @p relative is @c NULL this function will behave as
 * elm_index_item_prepend().
 *
 * @ingroup Index
 * 
 *
 * @param[in] before The index item to insert after.
 * @param[in] letter Letter under which the item should be indexed
 * @param[in] func The function to call when the item is clicked.
 * @param[in] data The item data to set for the index's item
 *
 */
EOAPI Elm_Object_Item * elm_obj_index_item_insert_before(Elm_Object_Item *before, const char *letter, Evas_Smart_Cb func, const void *data);

/**
 *
 * @brief Append a new item on a given index widget.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return A handle to the item added or @c NULL, on errors
 *
 * @remark Despite the most common usage of the @p letter argument is for
 * single char strings, one could use arbitrary strings as index
 * entries.
 *
 * @c item will be the pointer returned back on @c "changed", @c
 * "delay,changed" and @c "selected" smart events.
 *
 * @ingroup Index
 * 
 *
 * @param[in] letter Letter under which the item should be indexed
 * @param[in] func The function to call when the item is selected.
 * @param[in] data The item data to set for the index's item
 *
 */
EOAPI Elm_Object_Item * elm_obj_index_item_append(const char *letter, Evas_Smart_Cb func, const void *data);

/**
 *
 * @brief Returns the last selected item, for a given index widget.
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return The last item @b selected on @p obj (or @c NULL, on errors).
 *
 * @ingroup Index
 * 
 *
 * @param[in] level @c 0 or @c 1, the currently implemented levels.
 *
 */
EOAPI Elm_Object_Item * elm_obj_index_selected_item_get(int level);

/**
 *
 * @brief Insert a new item into the given index widget, using @p cmp_func
 * function to sort items (by item handles).
 *
 * @if MOBILE @since_tizen 2.3
 * @elseif WEARABLE @since_tizen 2.3.1
 * @endif
 *
 * @return A handle to the item added or @c NULL, on errors
 *
 * @remark Despite the most common usage of the @p letter argument is for
 * single char strings, one could use arbitrary strings as index
 * entries.
 *
 * @c item will be the pointer returned back on @c "changed", @c
 * "delay,changed" and @c "selected" smart events.
 *
 * @ingroup Index
 * 
 *
 * @param[in] letter Letter under which the item should be indexed
 * @param[in] func The function to call when the item is clicked.
 * @param[in] data The item data to set for the index's item
 * @param[in] cmp_func The comparing function to be used to sort index
items <b>by index item handles</b>
 * @param[in] cmp_data_func A @b fallback function to be called for the
sorting of index items <b>by item data</b>). It will be used
when @p cmp_func returns @c 0 (equality), which means an index
item with provided item data already exists. To decide which
data item should be pointed to by the index item in question, @p
cmp_data_func will be used. If @p cmp_data_func returns a
non-negative value, the previous index item data will be
replaced by the given @p item pointer. If the previous data need
to be freed, it should be done by the @p cmp_data_func function,
because all references to it will be lost. If this function is
not provided (@c NULL is given), index items will be @b
duplicated, if @p cmp_func returns @c 0.
 *
 */
EOAPI Elm_Object_Item * elm_obj_index_item_sorted_insert(const char *letter, Evas_Smart_Cb func, const void *data, Eina_Compare_Cb cmp_func, Eina_Compare_Cb cmp_data_func);

EOAPI extern const Eo_Event_Description _ELM_INDEX_EVENT_CHANGED;
EOAPI extern const Eo_Event_Description _ELM_INDEX_EVENT_DELAY_CHANGED;
EOAPI extern const Eo_Event_Description _ELM_INDEX_EVENT_SELECTED;
EOAPI extern const Eo_Event_Description _ELM_INDEX_EVENT_LEVEL_UP;
EOAPI extern const Eo_Event_Description _ELM_INDEX_EVENT_LEVEL_DOWN;
EOAPI extern const Eo_Event_Description _ELM_INDEX_EVENT_LANGUAGE_CHANGED;
EOAPI extern const Eo_Event_Description _ELM_INDEX_EVENT_ACCESS_CHANGED;
EOAPI extern const Eo_Event_Description _ELM_INDEX_EVENT_FOCUSED;
EOAPI extern const Eo_Event_Description _ELM_INDEX_EVENT_UNFOCUSED;

/**
 * No description
 */
#define ELM_INDEX_EVENT_CHANGED (&(_ELM_INDEX_EVENT_CHANGED))

/**
 * No description
 */
#define ELM_INDEX_EVENT_DELAY_CHANGED (&(_ELM_INDEX_EVENT_DELAY_CHANGED))

/**
 * No description
 */
#define ELM_INDEX_EVENT_SELECTED (&(_ELM_INDEX_EVENT_SELECTED))

/**
 * No description
 */
#define ELM_INDEX_EVENT_LEVEL_UP (&(_ELM_INDEX_EVENT_LEVEL_UP))

/**
 * No description
 */
#define ELM_INDEX_EVENT_LEVEL_DOWN (&(_ELM_INDEX_EVENT_LEVEL_DOWN))

/**
 * No description
 */
#define ELM_INDEX_EVENT_LANGUAGE_CHANGED (&(_ELM_INDEX_EVENT_LANGUAGE_CHANGED))

/**
 * No description
 */
#define ELM_INDEX_EVENT_ACCESS_CHANGED (&(_ELM_INDEX_EVENT_ACCESS_CHANGED))

/**
 * No description
 */
#define ELM_INDEX_EVENT_FOCUSED (&(_ELM_INDEX_EVENT_FOCUSED))

/**
 * No description
 */
#define ELM_INDEX_EVENT_UNFOCUSED (&(_ELM_INDEX_EVENT_UNFOCUSED))

#endif
