seoz pushed a commit to branch master.
commit b24a9f9db5f28cb84314e350952c45c7d89f1cc5
Author: Daniel Juyung Seo <[email protected]>
Date: Mon Sep 2 23:36:39 2013 +0900
elm_object_item.h: more documentation for elm_object_item_object_get().
---
src/lib/elm_object_item.h | 11 +++++++----
1 file changed, 7 insertions(+), 4 deletions(-)
diff --git a/src/lib/elm_object_item.h b/src/lib/elm_object_item.h
index f256a63..e7bd25f 100644
--- a/src/lib/elm_object_item.h
+++ b/src/lib/elm_object_item.h
@@ -39,10 +39,13 @@ EAPI Evas_Object
*elm_object_item_widget_get(const Elm_Object_It
* @param it The Elementary object item
* @return The Internal object of the object item.
*
- * @note This function should only be used if you really need to refer the
- * internal object's properties (i.e geometry). Since the object items are
- * managed/controlled by the widget, you should not modify the object directly
- * nor you should not treat the object without validation.
+ * @note THIS API NEEDS TO BE USED WITH GREAT CONSIDERATION. This function
+ * should only be used if you really need to refer the internal object's
+ * properties (i.e geometry). Since the object items are managed/controlled by
+ * the widget, the object could be deleted, resized, moved and so on by the
+ * widget. So you should not modify the object directly nor you should not
+ * treat the object without validation, we don't guarantee the result of any of
+ * these behavior.
*
* Some widget items may return @c NULL for this API if the items @p are not
* based on the evas object.
--
------------------------------------------------------------------------------
Learn the latest--Visual Studio 2012, SharePoint 2013, SQL 2012, more!
Discover the easy way to master current and previous Microsoft technologies
and advance your career. Get an incredible 1,500+ hours of step-by-step
tutorial videos with LearnDevNow. Subscribe today and save!
http://pubads.g.doubleclick.net/gampad/clk?id=58040911&iu=/4140/ostg.clktrk
