seoz pushed a commit to branch master.
commit c8639cf7e85d47669b0dc116f30e168bcf949539
Author: Daniel Juyung Seo <[email protected]>
Date: Thu Apr 18 02:50:39 2013 +0900
elm_list.h: added documentations for label parameter of item insertion.
The label parameter is copied inside the list. So if an application
dynamically
allocated the label, the application should free the label after tem
insertion
call.
---
src/lib/elm_list.h | 20 ++++++++++++++++++++
1 file changed, 20 insertions(+)
diff --git a/src/lib/elm_list.h b/src/lib/elm_list.h
index cf517c0..e5f5e4a 100644
--- a/src/lib/elm_list.h
+++ b/src/lib/elm_list.h
@@ -667,6 +667,10 @@ EAPI Elm_Object_Select_Mode
elm_list_select_mode_get(const Evas_Object *ob
* If such function isn't needed, just passing
* @c NULL as @p func is enough. The same should be done for @p data.
*
+ * @note Remember that the label parameter is copied inside the list. So if an
+ * application dynamically allocated the label, the application should free the
+ * label after this call.
+ *
* Simple example (with no function callback or data associated):
* @code
* li = elm_list_add(win);
@@ -718,6 +722,10 @@ EAPI Elm_Object_Item
*elm_list_item_append(Evas_Object *obj, const
* If such function isn't needed, just passing
* @c NULL as @p func is enough. The same should be done for @p data.
*
+ * @note Remember that the label parameter is copied inside the list. So if an
+ * application dynamically allocated the label, the application should free the
+ * label after this call.
+ *
* @see elm_list_item_append() for a simple code example.
* @see elm_list_select_mode_set()
* @see elm_object_item_del()
@@ -760,6 +768,10 @@ EAPI Elm_Object_Item
*elm_list_item_prepend(Evas_Object *obj, cons
* If such function isn't needed, just passing
* @c NULL as @p func is enough. The same should be done for @p data.
*
+ * @note Remember that the label parameter is copied inside the list. So if an
+ * application dynamically allocated the label, the application should free the
+ * label after this call.
+ *
* @see elm_list_item_append() for a simple code example.
* @see elm_list_select_mode_set()
* @see elm_object_item_del()
@@ -802,6 +814,10 @@ EAPI Elm_Object_Item
*elm_list_item_insert_before(Evas_Object *obj
* If such function isn't needed, just passing
* @c NULL as @p func is enough. The same should be done for @p data.
*
+ * @note Remember that the label parameter is copied inside the list. So if an
+ * application dynamically allocated the label, the application should free the
+ * label after this call.
+ *
* @see elm_list_item_append() for a simple code example.
* @see elm_list_select_mode_set()
* @see elm_object_item_del()
@@ -852,6 +868,10 @@ EAPI Elm_Object_Item
*elm_list_item_insert_after(Evas_Object *obj,
* If such function isn't needed, just passing
* @c NULL as @p func is enough. The same should be done for @p data.
*
+ * @note Remember that the label parameter is copied inside the list. So if an
+ * application dynamically allocated the label, the application should free the
+ * label after this call.
+ *
* @see elm_list_item_append() for a simple code example.
* @see elm_list_select_mode_set()
* @see elm_object_item_del()
--
------------------------------------------------------------------------------
Precog is a next-generation analytics platform capable of advanced
analytics on semi-structured data. The platform includes APIs for building
apps and a phenomenal toolset for data science. Developers can use
our toolset for easy data analysis & visualization. Get a free account!
http://www2.precog.com/precogplatform/slashdotnewsletter
