elm_object_item.h: more documentation for elm_object_item_object_get().

This commit is contained in:
Daniel Juyung Seo 2013-09-02 23:36:39 +09:00
parent b67b72f710
commit b1fa29a3ed
1 changed files with 7 additions and 4 deletions

View 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.