elementary/genlist - deprecated elm_genlist_item_object_get

SVN revision: 68490

legacy/elementary/src/lib/Elementary.h.in

@@ -202,7 +202,7 @@ EAPI extern Elm_Version *elm_version;
 #include <elm_fonts.h> //Done + XXX in header
 #include <elm_frame.h> //Done + XXX in header
 #include <elm_gengrid.h>
-#include <elm_genlist.h>
+#include <elm_genlist.h> //Done + XXX in headers. 
 #include <elm_gesture_layer.h> //Done
 #include <elm_glview.h> //Done + XXX in header, insufficient doc.
 #include <elm_grid.h> //Done

legacy/elementary/src/lib/elm_deprecated.h

@@ -1627,6 +1627,28 @@ EINA_DEPRECATED EAPI const char                   *elm_genlist_mode_item_style_g
  */
 EINA_DEPRECATED EAPI void                          elm_genlist_mode_item_style_set(Evas_Object *obj, const char *style);
 
+/**
+ * Get the real Evas object created to implement the view of a
+ * given genlist item
+ *
+ * @param it The genlist item.
+ * @return the Evas object implementing this item's view.
+ *
+ * This returns the actual Evas object used to implement the
+ * specified genlist item's view. This may be @c NULL, as it may
+ * not have been created or may have been deleted, at any time, by
+ * the genlist. <b>Do not modify this object</b> (move, resize,
+ * show, hide, etc.), as the genlist is controlling it. This
+ * function is for querying, emitting custom signals or hooking
+ * lower level callbacks for events on that object. Do not delete
+ * this object under any circumstances.
+ *
+ * @see elm_object_item_data_get()
+ * @deprecated No more support
+ *
+ * @ingroup Genlist
+ */
+EINA_DEPRECATED EAPI const Evas_Object            *elm_genlist_item_object_get(const Elm_Object_Item *it);
 
 #define ELM_IMAGE_ROTATE_90_CW 1
 #define ELM_IMAGE_ROTATE_180_CW 2

legacy/elementary/src/lib/elm_genlist.c

@@ -4557,7 +4557,7 @@ elm_genlist_item_prev_get(const Elm_Object_Item *it)
    return (Elm_Object_Item *) _it;
 }
 
-EAPI Evas_Object *
+EINA_DEPRECATED EAPI Evas_Object *
 elm_genlist_item_genlist_get(const Elm_Object_Item *it)
 {
    return elm_object_item_widget_get(it);
@@ -4938,7 +4938,7 @@ elm_genlist_item_contents_orphan(Elm_Object_Item *it)
      }
 }
 
-EAPI const Evas_Object *
+EINA_DEPRECATED EAPI const Evas_Object *
 elm_genlist_item_object_get(const Elm_Object_Item *it)
 {
    ELM_OBJ_ITEM_CHECK_OR_RETURN(it, NULL);

legacy/elementary/src/lib/elm_genlist.h

@@ -157,7 +157,7 @@
  *
  * @section Genlist_Usage_Hints Usage hints
  *
- * There are also convenience functions. elm_genlist_item_genlist_get() will
+ * There are also convenience functions. elm_object_item_widget_get() will
  * return the genlist object the item belongs to. elm_genlist_item_show()
  * will make the scroller scroll to show that specific item so its visible.
  * elm_object_item_data_get() returns the data pointer set by the item
@@ -262,9 +262,7 @@
  *   event_info parameter is the genlist item that was indicated to contract.
  * - @c "realized" - This is called when the item in the list is created as a
  *   real evas object. event_info parameter is the genlist item that was
- *   created. The object may be deleted at any time, so it is up to the
- *   caller to not use the object pointer from elm_genlist_item_object_get()
- *   in a way where it may point to freed objects.
+ *   created.
  * - @c "unrealized" - This is called just before an item is unrealized.
  *   After this call content objects provided will be deleted and the item
  *   object itself delete or be put into a floating cache.
@@ -1357,29 +1355,6 @@ EAPI void                          elm_genlist_item_middle_bring_in(Elm_Object_I
 //XXX: elm_genlist_item_all_contents_unset() ??
 EAPI void                          elm_genlist_item_contents_orphan(Elm_Object_Item *it);
 
-/**
- * Get the real Evas object created to implement the view of a
- * given genlist item
- *
- * @param it The genlist item.
- * @return the Evas object implementing this item's view.
- *
- * This returns the actual Evas object used to implement the
- * specified genlist item's view. This may be @c NULL, as it may
- * not have been created or may have been deleted, at any time, by
- * the genlist. <b>Do not modify this object</b> (move, resize,
- * show, hide, etc.), as the genlist is controlling it. This
- * function is for querying, emitting custom signals or hooking
- * lower level callbacks for events on that object. Do not delete
- * this object under any circumstances.
- *
- * @see elm_object_item_data_get()
- *
- * @ingroup Genlist
- */
-//XXX: Should be deprecated
-EAPI const Evas_Object            *elm_genlist_item_object_get(const Elm_Object_Item *it);
-
 /**
  * Update the contents of an item
  *