Reviewed elm_index's APIs and documentations. So many things to be

modified :(


SVN revision: 68004
This commit is contained in:
WooHyun Jung 2012-02-16 06:38:46 +00:00
parent 385704bd95
commit 8ef51b7c7d
2 changed files with 12 additions and 9 deletions

View File

@ -210,7 +210,7 @@ EAPI extern Elm_Version *elm_version;
// Woohyun Jung // Woohyun Jung
#include <elm_hover.h> // OK #include <elm_hover.h> // OK
#include <elm_image.h> // OK #include <elm_image.h> // OK
#include <elm_index.h> #include <elm_index.h> // OK
#include <elm_label.h> #include <elm_label.h>
#include <elm_layout.h> #include <elm_layout.h>
#include <elm_macros.h> #include <elm_macros.h>

View File

@ -63,14 +63,10 @@
EAPI Evas_Object *elm_index_add(Evas_Object *parent); EAPI Evas_Object *elm_index_add(Evas_Object *parent);
/** /**
* Set whether a given index widget is or not visible, * Enable or disable auto hiding feature for a given index widget.
* programmatically.
* *
* @param obj The index object * @param obj The index object
* @param active @c EINA_TRUE to show it, @c EINA_FALSE to hide it * @param active @c EINA_TRUE to enable auto hiding, @c EINA_FALSE to disable
*
* Not to be confused with visible as in @c evas_object_show() --
* visible with regard to the widget's auto hiding feature.
* *
* @see elm_index_active_get() * @see elm_index_active_get()
* *
@ -79,10 +75,10 @@ EAPI Evas_Object *elm_index_add(Evas_Object *parent);
EAPI void elm_index_active_set(Evas_Object *obj, Eina_Bool active); EAPI void elm_index_active_set(Evas_Object *obj, Eina_Bool active);
/** /**
* Get whether a given index widget is currently visible or not. * Get whether auto hiding feature is enabled or not for a given index widget.
* *
* @param obj The index object * @param obj The index object
* @return @c EINA_TRUE, if it's shown, @c EINA_FALSE otherwise * @return @c EINA_TRUE, if auto hiding is enabled, @c EINA_FALSE otherwise
* *
* @see elm_index_active_set() for more details * @see elm_index_active_set() for more details
* *
@ -140,6 +136,7 @@ EAPI Elm_Object_Item *elm_index_item_selected_get(const Evas_Object *obj, i
* *
* @ingroup Index * @ingroup Index
*/ */
//XXX: Should be changed like Elm_Object_Item *elm_index_item_append(Evas_Object *obj, const char* letter, const void *data);
EAPI void elm_index_item_append(Evas_Object *obj, const char *letter, const void *item); EAPI void elm_index_item_append(Evas_Object *obj, const char *letter, const void *item);
/** /**
@ -158,6 +155,7 @@ EAPI void elm_index_item_append(Evas_Object *obj, const char *l
* *
* @ingroup Index * @ingroup Index
*/ */
//XXX: Should be changed like Elm_Object_Item *elm_index_item_prepend(Evas_Object *obj, const char* letter, const void *data);
EAPI void elm_index_item_prepend(Evas_Object *obj, const char *letter, const void *item); EAPI void elm_index_item_prepend(Evas_Object *obj, const char *letter, const void *item);
/** /**
@ -181,6 +179,7 @@ EAPI void elm_index_item_prepend(Evas_Object *obj, const char *
* *
* @ingroup Index * @ingroup Index
*/ */
//XXX: Should be changed like Elm_Object_Item *elm_index_item_insert_after(Evas_Object *obj, const Elm_Object_Item *after, const char* letter, const void *data);
EAPI void elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative); EAPI void elm_index_item_append_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
/** /**
@ -204,6 +203,7 @@ EAPI void elm_index_item_append_relative(Evas_Object *obj, cons
* *
* @ingroup Index * @ingroup Index
*/ */
//XXX: Should be changed like Elm_Object_Item *elm_index_item_insert_before(Evas_Object *obj, const Elm_Object_Item *before, const char* letter, const void *data);
EAPI void elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative); EAPI void elm_index_item_prepend_relative(Evas_Object *obj, const char *letter, const void *item, const Elm_Object_Item *relative);
/** /**
@ -237,6 +237,7 @@ EAPI void elm_index_item_prepend_relative(Evas_Object *obj, con
* *
* @ingroup Index * @ingroup Index
*/ */
//XXX: Should be changed like Elm_Object_Item *elm_index_item_sorted_insert(Evas_Object *obj, const char* letter, const void *data, Eina_Compare_Cb cmp_func, Eina_Compare_Cb cmp_data_func);
EAPI void elm_index_item_sorted_insert(Evas_Object *obj, const char *letter, const void *item, Eina_Compare_Cb cmp_func, Eina_Compare_Cb cmp_data_func); EAPI void elm_index_item_sorted_insert(Evas_Object *obj, const char *letter, const void *item, Eina_Compare_Cb cmp_func, Eina_Compare_Cb cmp_data_func);
/** /**
@ -248,6 +249,7 @@ EAPI void elm_index_item_sorted_insert(Evas_Object *obj, const
* *
* @ingroup Index * @ingroup Index
*/ */
//XXX: After changing above APIs, this should be deprecated.
EAPI Elm_Object_Item *elm_index_item_find(Evas_Object *obj, const void *item); EAPI Elm_Object_Item *elm_index_item_find(Evas_Object *obj, const void *item);
/** /**
@ -270,6 +272,7 @@ EAPI void elm_index_item_clear(Evas_Object *obj);
* *
* @ingroup Index * @ingroup Index
*/ */
//XXX: how about elm_index_level_go ??
EAPI void elm_index_item_go(Evas_Object *obj, int level); EAPI void elm_index_item_go(Evas_Object *obj, int level);
/** /**