Tizen Native API
Widget Tree Navigation

Functions

Eina_Bool elm_object_widget_check (const Evas_Object *obj)
 Check if the given Evas Object is an Elementary widget.
Evas_Objectelm_object_parent_widget_get (const Evas_Object *obj)
 Get the first parent of the given object that is an Elementary widget.
Evas_Objectelm_object_top_widget_get (const Evas_Object *obj)
 Get the top level parent of an Elementary widget.
const char * elm_object_widget_type_get (const Evas_Object *obj)
 Get the string that represents this Elementary widget.

These functions provide checks for if a Evas_Object is an Elementary widget, the possibility of getting a widget's parent, top level parent and getting a string representation of a widget's type.


Function Documentation

Get the first parent of the given object that is an Elementary widget.

Since :
2.3
Parameters:
[in]objthe Elementary object to query parent from.
Returns:
the parent object that is an Elementary widget, or NULL, if it was not found.
Remarks:
Use this to query for an object's parent widget.
Most of Elementary users wouldn't be mixing non-Elementary smart objects in the objects tree of an application, as this is an advanced usage of Elementary with Evas. So, except for the application's window, which is the root of that tree, all other objects would have valid Elementary widget parents.

Get the top level parent of an Elementary widget.

Since :
2.3
Parameters:
[in]objThe object to query.
Returns:
The top level Elementary widget, or NULL if parent cannot be found.

Check if the given Evas Object is an Elementary widget.

Since :
2.3
Parameters:
[in]objthe object to query.
Returns:
EINA_TRUE if it is an elementary widget variant, EINA_FALSE otherwise
const char* elm_object_widget_type_get ( const Evas_Object obj)

Get the string that represents this Elementary widget.

Since :
2.3
Remarks:
Elementary is weird and exposes itself as a single Evas_Object_Smart_Class of type "elm_widget", so evas_object_type_get() always return that, making debug and language bindings hard. This function tries to mitigate this problem, but the solution is to change Elementary to use proper inheritance.
Parameters:
[in]objthe object to query.
Returns:
Elementary widget name, or NULL if not a valid widget.