elm_object_item.h: more documentation for elm_object_item_object_get().
authorDaniel Juyung Seo <seojuyung2@gmail.com>
Mon, 2 Sep 2013 14:36:39 +0000 (23:36 +0900)
committerDaniel Juyung Seo <seojuyung2@gmail.com>
Mon, 2 Sep 2013 14:36:39 +0000 (23:36 +0900)
src/lib/elm_object_item.h

index f256a63..e7bd25f 100644 (file)
@@ -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.