Functions that allows finding objects by their position, name or other properties. More...
#define | evas_canvas_focus_get(ret) EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_FOCUS_GET), EO_TYPECHECK(Evas_Object **, ret) |
#define | evas_canvas_object_name_find(name, ret) EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECT_NAME_FIND),EO_TYPECHECK(const char *, name), EO_TYPECHECK(Evas_Object **, ret) |
#define | evas_obj_name_child_find(name, recurse, child) EVAS_OBJ_ID(EVAS_OBJ_SUB_ID_NAME_CHILD_FIND), EO_TYPECHECK(const char *, name), EO_TYPECHECK(int, recurse), EO_TYPECHECK(Evas_Object **, child) |
#define | evas_canvas_object_top_at_xy_get(x, y, include_pass_events_objects, include_hidden_objects, ret) EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECT_TOP_AT_XY_GET), EO_TYPECHECK(Evas_Coord, x), EO_TYPECHECK(Evas_Coord, y), EO_TYPECHECK(Eina_Bool, include_pass_events_objects), EO_TYPECHECK(Eina_Bool, include_hidden_objects), EO_TYPECHECK(Evas_Object **, ret) |
#define | evas_canvas_object_top_in_rectangle_get(x, y, w, h, include_pass_events_objects, include_hidden_objects, ret) EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECT_TOP_IN_RECTANGLE_GET), EO_TYPECHECK(Evas_Coord, x), EO_TYPECHECK(Evas_Coord, y), EO_TYPECHECK(Evas_Coord, w), EO_TYPECHECK(Evas_Coord, h), EO_TYPECHECK(Eina_Bool, include_pass_events_objects), EO_TYPECHECK(Eina_Bool, include_hidden_objects), EO_TYPECHECK(Evas_Object **, ret) |
#define | evas_canvas_objects_at_xy_get(x, y, include_pass_events_objects, include_hidden_objects, ret) EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECTS_AT_XY_GET), EO_TYPECHECK(Evas_Coord, x), EO_TYPECHECK(Evas_Coord, y), EO_TYPECHECK(Eina_Bool, include_pass_events_objects), EO_TYPECHECK(Eina_Bool, include_hidden_objects), EO_TYPECHECK(Eina_List **, ret) |
#define | evas_canvas_objects_in_rectangle_get(x, y, w, h, include_pass_events_objects, include_hidden_objects, ret) EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECTS_IN_RECTANGLE_GET), EO_TYPECHECK(Evas_Coord, x), EO_TYPECHECK(Evas_Coord, y), EO_TYPECHECK(Evas_Coord, w), EO_TYPECHECK(Evas_Coord, h), EO_TYPECHECK(Eina_Bool, include_pass_events_objects), EO_TYPECHECK(Eina_Bool, include_hidden_objects), EO_TYPECHECK(Eina_List **, ret) |
#define | evas_canvas_object_bottom_get(ret) EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECT_BOTTOM_GET), EO_TYPECHECK(Evas_Object **, ret) |
#define | evas_canvas_object_top_get(ret) EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECT_TOP_GET), EO_TYPECHECK(Evas_Object **, ret) |
Evas_Object * | evas_focus_get (const Evas *e) |
Retrieve the object that currently has focus. More... | |
Evas_Object * | evas_object_name_find (const Evas *e, const char *name) |
Retrieves the object on the given evas with the given name. More... | |
Evas_Object * | evas_object_name_child_find (const Evas_Object *obj, const char *name, int recurse) |
Retrieves the object from children of the given object with the given name. More... | |
Evas_Object * | evas_object_top_at_xy_get (const Evas *e, Evas_Coord x, Evas_Coord y, Eina_Bool include_pass_events_objects, Eina_Bool include_hidden_objects) |
Retrieve the Evas object stacked at the top of a given position in a canvas. More... | |
Evas_Object * | evas_object_top_at_pointer_get (const Evas *e) |
Retrieve the Evas object stacked at the top at the position of the mouse cursor, over a given canvas. More... | |
Evas_Object * | evas_object_top_in_rectangle_get (const Evas *e, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h, Eina_Bool include_pass_events_objects, Eina_Bool include_hidden_objects) |
Retrieve the Evas object stacked at the top of a given rectangular region in a canvas. More... | |
Eina_List * | evas_objects_at_xy_get (const Evas *e, Evas_Coord x, Evas_Coord y, Eina_Bool include_pass_events_objects, Eina_Bool include_hidden_objects) |
Retrieve a list of Evas objects lying over a given position in a canvas. More... | |
Eina_List * | evas_objects_in_rectangle_get (const Evas *e, Evas_Coord x, Evas_Coord y, Evas_Coord w, Evas_Coord h, Eina_Bool include_pass_events_objects, Eina_Bool include_hidden_objects) |
Retrieves the objects in the given rectangle region. More... | |
Evas_Object * | evas_object_bottom_get (const Evas *e) |
Get the lowest (stacked) Evas object on the canvas e . More... | |
Evas_Object * | evas_object_top_get (const Evas *e) |
Get the highest (stacked) Evas object on the canvas e . More... | |
Functions that allows finding objects by their position, name or other properties.
#define evas_canvas_focus_get | ( | ret | ) | EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_FOCUS_GET), EO_TYPECHECK(Evas_Object **, ret) |
Retrieve the object that currently has focus.
[out] | ret |
Referenced by evas_focus_get().
#define evas_canvas_object_name_find | ( | name, | |
ret | |||
) | EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECT_NAME_FIND),EO_TYPECHECK(const char *, name), EO_TYPECHECK(Evas_Object **, ret) |
Retrieves the object on the given evas with the given name.
[in] | name | |
[out] | ret |
Referenced by evas_object_name_find().
#define evas_obj_name_child_find | ( | name, | |
recurse, | |||
child | |||
) | EVAS_OBJ_ID(EVAS_OBJ_SUB_ID_NAME_CHILD_FIND), EO_TYPECHECK(const char *, name), EO_TYPECHECK(int, recurse), EO_TYPECHECK(Evas_Object **, child) |
Retrieves the object from children of the given object with the given name.
[in] | name | in |
[in] | recurse | in |
[out] | child | out |
Referenced by evas_object_name_child_find().
#define evas_canvas_object_top_at_xy_get | ( | x, | |
y, | |||
include_pass_events_objects, | |||
include_hidden_objects, | |||
ret | |||
) | EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECT_TOP_AT_XY_GET), EO_TYPECHECK(Evas_Coord, x), EO_TYPECHECK(Evas_Coord, y), EO_TYPECHECK(Eina_Bool, include_pass_events_objects), EO_TYPECHECK(Eina_Bool, include_hidden_objects), EO_TYPECHECK(Evas_Object **, ret) |
Retrieve the Evas object stacked at the top of a given position in a canvas.
[in] | x | |
[in] | y | |
[in] | include_pass_events_objects | |
[in] | include_hidden_objects | |
[out] | ret |
Referenced by evas_object_top_at_pointer_get(), and evas_object_top_at_xy_get().
#define evas_canvas_object_top_in_rectangle_get | ( | x, | |
y, | |||
w, | |||
h, | |||
include_pass_events_objects, | |||
include_hidden_objects, | |||
ret | |||
) | EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECT_TOP_IN_RECTANGLE_GET), EO_TYPECHECK(Evas_Coord, x), EO_TYPECHECK(Evas_Coord, y), EO_TYPECHECK(Evas_Coord, w), EO_TYPECHECK(Evas_Coord, h), EO_TYPECHECK(Eina_Bool, include_pass_events_objects), EO_TYPECHECK(Eina_Bool, include_hidden_objects), EO_TYPECHECK(Evas_Object **, ret) |
Retrieve the Evas object stacked at the top of a given rectangular region in a canvas.
[in] | x | |
[in] | y | |
[in] | w | |
[in] | h | |
[in] | include_pass_events_objects | |
[in] | include_hidden_objects | |
[out] | ret |
Referenced by evas_object_top_in_rectangle_get().
#define evas_canvas_objects_at_xy_get | ( | x, | |
y, | |||
include_pass_events_objects, | |||
include_hidden_objects, | |||
ret | |||
) | EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECTS_AT_XY_GET), EO_TYPECHECK(Evas_Coord, x), EO_TYPECHECK(Evas_Coord, y), EO_TYPECHECK(Eina_Bool, include_pass_events_objects), EO_TYPECHECK(Eina_Bool, include_hidden_objects), EO_TYPECHECK(Eina_List **, ret) |
Retrieve a list of Evas objects lying over a given position in a canvas.
[in] | x | |
[in] | y | |
[in] | include_pass_events_objects | |
[in] | include_hidden_objects | |
[out] | ret |
Referenced by evas_objects_at_xy_get().
#define evas_canvas_objects_in_rectangle_get | ( | x, | |
y, | |||
w, | |||
h, | |||
include_pass_events_objects, | |||
include_hidden_objects, | |||
ret | |||
) | EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECTS_IN_RECTANGLE_GET), EO_TYPECHECK(Evas_Coord, x), EO_TYPECHECK(Evas_Coord, y), EO_TYPECHECK(Evas_Coord, w), EO_TYPECHECK(Evas_Coord, h), EO_TYPECHECK(Eina_Bool, include_pass_events_objects), EO_TYPECHECK(Eina_Bool, include_hidden_objects), EO_TYPECHECK(Eina_List **, ret) |
[in] | x | |
[in] | y | |
[in] | w | |
[in] | h | |
[in] | include_pass_events_objects | |
[in] | include_hidden_objects | |
[out] | ret |
Referenced by evas_objects_in_rectangle_get().
#define evas_canvas_object_bottom_get | ( | ret | ) | EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECT_BOTTOM_GET), EO_TYPECHECK(Evas_Object **, ret) |
Get the lowest (stacked) Evas object on the canvas e.
[out] | ret |
Referenced by evas_object_bottom_get().
#define evas_canvas_object_top_get | ( | ret | ) | EVAS_CANVAS_ID(EVAS_CANVAS_SUB_ID_OBJECT_TOP_GET), EO_TYPECHECK(Evas_Object **, ret) |
Get the highest (stacked) Evas object on the canvas e.
[out] | ret |
Referenced by evas_object_top_get().
Evas_Object* evas_focus_get | ( | const Evas * | e | ) |
Retrieve the object that currently has focus.
e | The Evas canvas to query for focused object on. |
NULL
if there is not one.Evas can have (at most) one of its objects focused at a time. Focused objects will be the ones having key events delivered to, which the programmer can act upon by means of evas_object_event_callback_add() usage.
This call returns the object that currently has focus on the canvas e
or NULL
, if none.
Example:
In this example the event_info
is exactly a pointer to that focused rectangle. See the full example.
References evas_canvas_focus_get.
Evas_Object* evas_object_name_find | ( | const Evas * | e, |
const char * | name | ||
) |
Retrieves the object on the given evas with the given name.
e | The given evas. |
name | The given name. |
NULL
.This looks for the evas object given a name by evas_object_name_set(). If the name is not unique canvas-wide, then which one of the many objects with that name is returned is undefined, so only use this if you can ensure the object name is unique.
References evas_canvas_object_name_find.
Referenced by edje_evas_global_perspective_get(), and edje_perspective_global_set().
Evas_Object* evas_object_name_child_find | ( | const Evas_Object * | obj, |
const char * | name, | ||
int | recurse | ||
) |
Retrieves the object from children of the given object with the given name.
obj | The parent (smart) object whose children to search. |
name | The given name. |
recurse | Set to the number of child levels to recurse (0 == don't recurse, 1 == only look at the children of obj or their immediate children, but no further etc.). |
NULL
.This looks for the evas object given a name by evas_object_name_set(), but it ONLY looks at the children of the object *p obj, and will only recurse into those children if recurse
is greater than 0. If the name is not unique within immediate children (or the whole child tree) then it is not defined which child object will be returned. If recurse
is set to -1 then it will recurse without limit.
References evas_obj_name_child_find.
Evas_Object* evas_object_top_at_xy_get | ( | const Evas * | e, |
Evas_Coord | x, | ||
Evas_Coord | y, | ||
Eina_Bool | include_pass_events_objects, | ||
Eina_Bool | include_hidden_objects | ||
) |
Retrieve the Evas object stacked at the top of a given position in a canvas.
e | A handle to the canvas. |
x | The horizontal coordinate of the position |
y | The vertical coordinate of the position |
include_pass_events_objects | Boolean flag to include or not objects which pass events in this calculation |
include_hidden_objects | Boolean flag to include or not hidden objects in this calculation |
This function will traverse all the layers of the given canvas, from top to bottom, querying for objects with areas covering the given position. The user can remove from the query objects which are hidden and/or which are set to pass events.
References evas_canvas_object_top_at_xy_get.
Evas_Object* evas_object_top_at_pointer_get | ( | const Evas * | e | ) |
Retrieve the Evas object stacked at the top at the position of the mouse cursor, over a given canvas.
e | A handle to the canvas. |
This function will traverse all the layers of the given canvas, from top to bottom, querying for objects with areas covering the mouse pointer's position, over e
.
References EINA_TRUE, and evas_canvas_object_top_at_xy_get.
Evas_Object* evas_object_top_in_rectangle_get | ( | const Evas * | e, |
Evas_Coord | x, | ||
Evas_Coord | y, | ||
Evas_Coord | w, | ||
Evas_Coord | h, | ||
Eina_Bool | include_pass_events_objects, | ||
Eina_Bool | include_hidden_objects | ||
) |
Retrieve the Evas object stacked at the top of a given rectangular region in a canvas.
e | A handle to the canvas. |
x | The top left corner's horizontal coordinate for the rectangular region |
y | The top left corner's vertical coordinate for the rectangular region |
w | The width of the rectangular region |
h | The height of the rectangular region |
include_pass_events_objects | Boolean flag to include or not objects which pass events in this calculation |
include_hidden_objects | Boolean flag to include or not hidden objects in this calculation |
This function will traverse all the layers of the given canvas, from top to bottom, querying for objects with areas overlapping with the given rectangular region inside e
. The user can remove from the query objects which are hidden and/or which are set to pass events.
References evas_canvas_object_top_in_rectangle_get.
Eina_List* evas_objects_at_xy_get | ( | const Evas * | e, |
Evas_Coord | x, | ||
Evas_Coord | y, | ||
Eina_Bool | include_pass_events_objects, | ||
Eina_Bool | include_hidden_objects | ||
) |
Retrieve a list of Evas objects lying over a given position in a canvas.
e | A handle to the canvas. |
x | The horizontal coordinate of the position |
y | The vertical coordinate of the position |
include_pass_events_objects | Boolean flag to include or not objects which pass events in this calculation |
include_hidden_objects | Boolean flag to include or not hidden objects in this calculation |
e
This function will traverse all the layers of the given canvas, from top to bottom, querying for objects with areas covering the given position. The user can remove from query objects which are hidden and/or which are set to pass events.
References evas_canvas_objects_at_xy_get.
Eina_List* evas_objects_in_rectangle_get | ( | const Evas * | eo_e, |
Evas_Coord | x, | ||
Evas_Coord | y, | ||
Evas_Coord | w, | ||
Evas_Coord | h, | ||
Eina_Bool | include_pass_events_objects, | ||
Eina_Bool | include_hidden_objects | ||
) |
Retrieves the objects in the given rectangle region.
eo_e | The given evas object. |
x | The horizontal coordinate. |
y | The vertical coordinate. |
w | The width size. |
h | The height size. |
include_pass_events_objects | Boolean Flag to include or not pass events objects |
include_hidden_objects | Boolean Flag to include or not hidden objects |
References evas_canvas_objects_in_rectangle_get.
Evas_Object* evas_object_bottom_get | ( | const Evas * | e | ) |
Get the lowest (stacked) Evas object on the canvas e
.
e | a valid canvas pointer |
NULL
, otherwiseThis function will take all populated layers in the canvas into account, getting the lowest object for the lowest layer, naturally.
References evas_canvas_object_bottom_get.
Evas_Object* evas_object_top_get | ( | const Evas * | e | ) |
Get the highest (stacked) Evas object on the canvas e
.
e | a valid canvas pointer |
NULL
, otherwiseThis function will take all populated layers in the canvas into account, getting the highest object for the highest layer, naturally.
References evas_canvas_object_top_get.