Tizen Native API
7.0
|
Functions that manipulate generic Evas objects.
All Evas displaying units are Evas objects. One handles them all by means of the handle Evas_Object. Besides Evas treats their objects equally, they have types that define their specific behavior (and individual API).
Evas comes with a set of built-in object types:
- rectangle,
- line,
- polygon,
- text,
- textblock,
- textgrid and
- image.
These functions apply to any Evas object, whatever type they may have.
- Note:
- The built-in types that are most used are rectangles, text and images. In fact, with these one can create 2D interfaces of arbitrary complexity and EFL makes it easy.
Functions | |
Eina_Bool | evas_object_pointer_mode_set (Efl_Canvas_Object *obj, Evas_Object_Pointer_Mode pointer_mode) |
Low-level pointer behaviour. | |
Evas_Object_Pointer_Mode | evas_object_pointer_mode_get (const Efl_Canvas_Object *obj) |
Low-level pointer behaviour. | |
void | evas_object_clip_set (Efl_Canvas_Object *obj, Efl_Canvas_Object *clip) |
Clip one object to another. | |
Efl_Canvas_Object * | evas_object_clip_get (const Efl_Canvas_Object *obj) |
Get the object clipping obj (if any). | |
void | evas_object_repeat_events_set (Efl_Canvas_Object *obj, Eina_Bool repeat) |
Set whether an Evas object is to repeat events. | |
Eina_Bool | evas_object_repeat_events_get (const Efl_Canvas_Object *obj) |
Determine whether an object is set to repeat events. | |
void | evas_object_focus_set (Efl_Canvas_Object *obj, Eina_Bool focus) |
Indicates that this object is the keyboard event receiver on its canvas. | |
Eina_Bool | evas_object_focus_get (const Efl_Canvas_Object *obj) |
Indicates that this object is the keyboard event receiver on its canvas. | |
void | evas_object_precise_is_inside_set (Efl_Canvas_Object *obj, Eina_Bool precise) |
Set whether to use precise (usually expensive) point collision detection for a given Evas object. | |
Eina_Bool | evas_object_precise_is_inside_get (const Efl_Canvas_Object *obj) |
Determine whether an object is set to use precise point collision detection. | |
void | evas_object_propagate_events_set (Efl_Canvas_Object *obj, Eina_Bool propagate) |
Set whether events on a smart object's member should be propagated up to its parent. | |
Eina_Bool | evas_object_propagate_events_get (const Efl_Canvas_Object *obj) |
Retrieve whether an Evas object is set to propagate events. | |
void | evas_object_pass_events_set (Efl_Canvas_Object *obj, Eina_Bool pass) |
Set whether an Evas object is to pass (ignore) events. | |
Eina_Bool | evas_object_pass_events_get (const Efl_Canvas_Object *obj) |
Determine whether an object is set to pass (ignore) events. | |
void | evas_object_anti_alias_set (Efl_Canvas_Object *obj, Eina_Bool anti_alias) |
Sets whether or not the given Evas object is to be drawn anti-aliased. | |
Eina_Bool | evas_object_anti_alias_get (const Efl_Canvas_Object *obj) |
Retrieves whether or not the given Evas object is to be drawn anti_aliased. | |
Efl_Canvas_Object * | evas_object_smart_parent_get (const Efl_Canvas_Object *obj) |
Gets the parent smart object of a given Evas object, if it has one. | |
void | evas_object_paragraph_direction_set (Efl_Canvas_Object *obj, Evas_BiDi_Direction dir) |
This handles text paragraph direction of the given object. Even if the given object is not textblock or text, its smart child objects can inherit the paragraph direction from the given object. The default paragraph direction is inherit . | |
Evas_BiDi_Direction | evas_object_paragraph_direction_get (const Efl_Canvas_Object *obj) |
This handles text paragraph direction of the given object. Even if the given object is not textblock or text, its smart child objects can inherit the paragraph direction from the given object. The default paragraph direction is inherit . | |
Eina_Bool | evas_object_clipees_has (const Efl_Canvas_Object *obj) |
Test if any object is clipped by obj . | |
void | evas_object_move (Evas_Object *obj, Evas_Coord x, Evas_Coord y) |
void | evas_object_resize (Evas_Object *obj, Evas_Coord w, Evas_Coord h) |
Eina_Bool | evas_object_visible_get (const Evas_Object *obj) |
void | evas_object_size_hint_max_set (Evas_Object *obj, Evas_Coord w, Evas_Coord h) |
Sets the hints for an object's maximum size. | |
void | evas_object_size_hint_max_get (const Evas_Object *obj, Evas_Coord *w, Evas_Coord *h) |
Retrieves the hints for an object's maximum size. | |
void | evas_object_size_hint_request_set (Evas_Object *obj, Evas_Coord w, Evas_Coord h) |
Sets the hints for an object's optimum size. | |
void | evas_object_size_hint_request_get (const Evas_Object *obj, Evas_Coord *w, Evas_Coord *h) |
Retrieves the hints for an object's optimum size. | |
void | evas_object_size_hint_min_set (Evas_Object *obj, Evas_Coord w, Evas_Coord h) |
Sets the hints for an object's minimum size. | |
void | evas_object_clip_unset (Evas_Object *obj) |
Disable/cease clipping on a clipped obj object. | |
void | evas_object_size_hint_min_get (const Evas_Object *obj, Evas_Coord *w, Evas_Coord *h) |
Retrieves the hints for an object's minimum size. | |
void | evas_object_size_hint_padding_set (Evas_Object *obj, Evas_Coord l, Evas_Coord r, Evas_Coord t, Evas_Coord b) |
Sets the hints for an object's padding space. | |
void | evas_object_size_hint_padding_get (const Evas_Object *obj, Evas_Coord *l, Evas_Coord *r, Evas_Coord *t, Evas_Coord *b) |
Retrieves the hints for an object's padding space. | |
void | evas_object_size_hint_weight_set (Evas_Object *obj, double x, double y) |
Sets the hints for an object's weight. | |
void | evas_object_size_hint_weight_get (const Evas_Object *obj, double *x, double *y) |
Retrieves the hints for an object's weight. | |
void | evas_object_size_hint_align_set (Evas_Object *obj, double x, double y) |
Sets the hints for an object's alignment. | |
void | evas_object_size_hint_align_get (const Evas_Object *obj, double *x, double *y) |
Retrieves the hints for on object's alignment. | |
void | evas_object_size_hint_aspect_set (Evas_Object *obj, Evas_Aspect_Control aspect, Evas_Coord w, Evas_Coord h) |
Sets the hints for an object's aspect ratio. | |
void | evas_object_size_hint_aspect_get (const Evas_Object *obj, Evas_Aspect_Control *aspect, Evas_Coord *w, Evas_Coord *h) |
Retrieves the hints for an object's aspect ratio. | |
void | evas_object_size_hint_display_mode_set (Evas_Object *obj, Evas_Display_Mode dispmode) |
Sets the hints for an object's disply mode,. | |
Evas_Display_Mode | evas_object_size_hint_display_mode_get (const Evas_Object *obj) |
Retrieves the hints for an object's display mode. | |
void | evas_object_layer_set (Evas_Object *obj, short l) |
short | evas_object_layer_get (const Evas_Object *obj) |
Evas_Object * | evas_object_below_get (const Evas_Object *obj) |
Evas_Object * | evas_object_above_get (const Evas_Object *obj) |
void | evas_object_stack_below (Evas_Object *obj, Evas_Object *below) |
void | evas_object_raise (Evas_Object *obj) |
void | evas_object_stack_above (Evas_Object *obj, Evas_Object *above) |
void | evas_object_lower (Evas_Object *obj) |
void | evas_object_static_clip_set (Evas_Object *obj, Eina_Bool is_static_clip) |
Set a hint flag on the given Evas object that it's used as a "static
clipper". | |
const Eina_List * | evas_object_clipees_get (const Evas_Object *obj) |
Return a list of objects currently clipped by obj . | |
void | evas_object_render_op_set (Evas_Object *obj, Evas_Render_Op render_op) |
Sets the render mode to be used for compositing the Evas object. | |
Evas_Render_Op | evas_object_render_op_get (const Evas_Object *obj) |
Retrieves the current value of the operation used for rendering the Evas object. | |
Eina_Bool | evas_object_static_clip_get (const Evas_Object *obj) |
Get the "static clipper" hint flag for a given Evas object. | |
void | evas_object_scale_set (Evas_Object *obj, double scale) |
Sets the scaling factor for an Evas object. Does not affect all objects. | |
double | evas_object_scale_get (const Evas_Object *obj) |
Retrieves the scaling factor for the given Evas object. | |
Eina_Bool | evas_object_pointer_inside_by_device_get (const Evas_Object *obj, Efl_Input_Device *dev) |
Returns whether the mouse pointer is logically inside the object. | |
Eina_Bool | evas_object_pointer_inside_get (const Evas_Object *obj) |
Returns whether the default mouse pointer is logically inside the object. | |
Eina_Bool | evas_object_pointer_coords_inside_get (const Evas_Object *eo_obj, int x, int y) |
Returns whether the coords are logically inside the object. | |
Evas * | evas_object_evas_get (const Eo *obj) |
Get the Evas to which this object belongs to. | |
void | evas_object_map_set (Evas_Object *obj, const Evas_Map *map) |
Set current object transformation map. | |
const Evas_Map * | evas_object_map_get (const Evas_Object *obj) |
Get current object transformation map. | |
void | evas_object_map_enable_set (Evas_Object *obj, Eina_Bool enabled) |
Enable or disable the map that is set. | |
Eina_Bool | evas_object_map_enable_get (const Evas_Object *obj) |
Whether the map is enabled or not. | |
void | evas_map_direct_render_set (Evas_Map *m, Eina_Bool direct_render) |
Set direct render of map. | |
void | evas_object_is_frame_object_set (Efl_Canvas_Object *obj, Eina_Bool is_frame) |
If true the object belongs to the window border decorations. | |
Eina_Bool | evas_object_is_frame_object_get (const Efl_Canvas_Object *obj) |
If true the object belongs to the window border decorations. | |
void | evas_object_freeze_events_set (Efl_Canvas_Object *obj, Eina_Bool freeze) |
Set whether an Evas object is to freeze (discard) events. | |
Eina_Bool | evas_object_freeze_events_get (const Efl_Canvas_Object *obj) |
Determine whether an object is set to freeze (discard) events. | |
Typedefs | |
typedef Eo | Efl_Canvas_Object |
typedef Efl_Canvas_Object | Evas_Object |
Typedef Documentation
An Evas Object handle
- See also:
- Evas_Object
An Evas Object handle.
Enumeration Type Documentation
enum Evas_Render_Op |
How the object should be rendered to output.
- Enumerator:
Function Documentation
void evas_map_direct_render_set | ( | Evas_Map * | m, |
Eina_Bool | direct_render | ||
) |
Set direct render of map.
This interface has very special purpose to optimize memory usage of map. It works when a map object has only one image object through its smart object tree. In this case, it regards the map has one image object which of buffer can be directly draw on the main surface so that it skips to create an additional frame buffer to composite the contents of the map. If the condition is not satisfied, map works as it's supposed to do in the default behavior.
- Parameters:
-
m map to enable direct render. direct_render true
to enable direct render.
Evas_Object* evas_object_above_get | ( | const Evas_Object * | obj | ) |
Get the Evas object stacked right above obj
- Returns:
- the Evas_Object directly above
obj
, if any, orNULL
, if none
This function will traverse layers in its search, if there are objects on layers above the one obj
is placed at.
- Since :
- 2.3
- Examples:
- evas-stacking.c.
Eina_Bool evas_object_anti_alias_get | ( | const Efl_Canvas_Object * | obj | ) |
Retrieves whether or not the given Evas object is to be drawn anti_aliased.
- Parameters:
-
[in] obj The object.
- Returns:
true
if the object is to be anti_aliased,false
otherwise.
- Since :
- 2.3
void evas_object_anti_alias_set | ( | Efl_Canvas_Object * | obj, |
Eina_Bool | anti_alias | ||
) |
Sets whether or not the given Evas object is to be drawn anti-aliased.
- Parameters:
-
[in] obj The object. [in] anti_alias true
if the object is to be anti_aliased,false
otherwise.
- Since :
- 2.3
Evas_Object* evas_object_below_get | ( | const Evas_Object * | obj | ) |
Get the Evas object stacked right below obj
- Returns:
- the Evas_Object directly below
obj
, if any, orNULL
, if none
This function will traverse layers in its search, if there are objects on layers below the one obj
is placed at.
- Since :
- 2.3
- Examples:
- evas-stacking.c.
Efl_Canvas_Object* evas_object_clip_get | ( | const Efl_Canvas_Object * | obj | ) |
Get the object clipping obj
(if any).
This function returns the object clipping obj
. If obj
is not being clipped at all, null
is returned. The object obj
must be a valid Evas_Object.
- Parameters:
-
[in] obj The object.
- Returns:
- The object to clip
obj
by.
- Since :
- 2.3
- Examples:
- evas-object-manipulation.c.
void evas_object_clip_set | ( | Efl_Canvas_Object * | obj, |
Efl_Canvas_Object * | clip | ||
) |
Clip one object to another.
This function will clip the object obj
to the area occupied by the object clip
. This means the object obj
will only be visible within the area occupied by the clipping object ($clip).
The color of the object being clipped will be multiplied by the color of the clipping one, so the resulting color for the former will be "RESULT = (OBJ * CLIP) / (255 * 255)", per color element (red, green, blue and alpha).
Clipping is recursive, so clipping objects may be clipped by others, and their color will in term be multiplied. You may not set up circular clipping lists (i.e. object 1 clips object 2, which clips object 1): the behavior of Evas is undefined in this case.
Objects which do not clip others are visible in the canvas as normal; those that clip one or more objects become invisible themselves, only affecting what they clip. If an object ceases to have other objects being clipped by it, it will become visible again.
The visibility of an object affects the objects that are clipped by it, so if the object clipping others is not shown (as in Efl::Gfx::Entity::visible), the objects clipped by it will not be shown either.
If obj
was being clipped by another object when this function is called, it gets implicitly removed from the old clipper's domain and is made now to be clipped by its new clipper.
If clip
is null
, this call will disable clipping for the object i.e. its visibility and color get detached from the previous clipper. If it wasn't, this has no effect.
- Note:
- Only rectangle and image (masks) objects can be used as clippers. Anything else will result in undefined behaviour.
- Parameters:
-
[in] obj The object. [in] clip The object to clip obj
by.
- Since :
- 2.3
- Examples:
- evas-object-manipulation.c.
void evas_object_clip_unset | ( | Evas_Object * | obj | ) |
Disable/cease clipping on a clipped obj
object.
This function disables clipping for the object obj
, if it was already clipped, i.e., its visibility and color get detached from the previous clipper. If it wasn't, this has no effect. The object obj
must be a valid Evas_Object.
See also evas_object_clip_set, evas_object_clipees_get and evas_object_clip_get.
- Since :
- 2.3
- Examples:
- evas-object-manipulation.c.
const Eina_List* evas_object_clipees_get | ( | const Evas_Object * | obj | ) |
Return a list of objects currently clipped by obj
.
This returns the internal list handle that contains all objects clipped by the object obj
. If none are clipped by it, the call returns null
. This list is only valid until the clip list is changed and should be fetched again with another call to this function if any objects being clipped by this object are unclipped, clipped by a new object, deleted or get the clipper deleted. These operations will invalidate the list returned, so it should not be used anymore after that point. Any use of the list after this may have undefined results, possibly leading to crashes. The object obj
must be a valid Evas_Object.
See also evas_object_clip_set, evas_object_clip_unset and evas_object_clip_get.
- Returns:
- A list of objects being clipped by
obj
.
- Since :
- 2.3
Eina_Bool evas_object_clipees_has | ( | const Efl_Canvas_Object * | obj | ) |
Test if any object is clipped by obj
.
- Parameters:
-
[in] obj The object.
- Returns:
true
if any object is clipped byobj
,false
otherwise
- Since (EFL) :
- 1.8
- Since :
- 3.0
Evas* evas_object_evas_get | ( | const Eo * | obj | ) |
Get the Evas to which this object belongs to.
The object may be an evas object, an elementary object or window, or an evas 3D / VG object.
- Since :
- 2.3
- Examples:
- bg_example_03.c, bubble_example_01.c, check_example_01.c, colorselector_example_01.c, ctxpopup_example_01.c, efl_thread_1.c, efl_thread_2.c, efl_thread_3.c, efl_thread_4.c, efl_thread_5.c, efl_thread_6.c, evas-aspect-hints.c, evas-smart-interface.c, evas-smart-object.c, flip_example_01.c, frame_example_01.c, hover_example_01.c, hoversel_example_01.c, map_example_01.c, map_example_02.c, map_example_03.c, menu_example_01.c, separator_example_01.c, table_example_02.c, transit_example_04.c, and web_example_02.c.
Eina_Bool evas_object_focus_get | ( | const Efl_Canvas_Object * | obj | ) |
Indicates that this object is the keyboard event receiver on its canvas.
Changing focus only affects where (key) input events go. There can be only one object focused at any time. If focus
is true
, obj
will be set as the currently focused object and it will receive all keyboard events that are not exclusive key grabs on other objects. See also Efl::Canvas::Object::seat_focus_check, Efl::Canvas::Object::seat_focus_add, Efl::Canvas::Object::seat_focus_del.
- Parameters:
-
[in] obj The object.
- Returns:
true
when set as focused orfalse
otherwise.
- Since :
- 2.3
- Examples:
- ecore_imf_example.c, and evas-events.c.
void evas_object_focus_set | ( | Efl_Canvas_Object * | obj, |
Eina_Bool | focus | ||
) |
Indicates that this object is the keyboard event receiver on its canvas.
Changing focus only affects where (key) input events go. There can be only one object focused at any time. If focus
is true
, obj
will be set as the currently focused object and it will receive all keyboard events that are not exclusive key grabs on other objects. See also Efl::Canvas::Object::seat_focus_check, Efl::Canvas::Object::seat_focus_add, Efl::Canvas::Object::seat_focus_del.
- Parameters:
-
[in] obj The object. [in] focus true
when set as focused orfalse
otherwise.
- Since :
- 2.3
- Examples:
- ecore_evas_window_sizes_example.c, ecore_imf_example.c, edje-basic.c, edje-box.c, edje-box2.c, edje-drag.c, edje-perspective.c, edje-signals-messages.c, evas-aspect-hints.c, evas-box.c, evas-events.c, evas-hints.c, evas-images.c, evas-images2.c, evas-map-utils.c, evas-object-manipulation.c, evas-smart-interface.c, evas-smart-object.c, evas-stacking.c, and evas-text.c.
Eina_Bool evas_object_freeze_events_get | ( | const Efl_Canvas_Object * | obj | ) |
Determine whether an object is set to freeze (discard) events.
- Parameters:
-
[in] obj The object.
- Returns:
- Pass when
obj
is to freeze events ($true) or not ($false).
- Since (EFL) :
- 1.1
- Since :
- 2.3
void evas_object_freeze_events_set | ( | Efl_Canvas_Object * | obj, |
Eina_Bool | freeze | ||
) |
Set whether an Evas object is to freeze (discard) events.
If freeze
is true
, it will force events on obj
to be discarded. Unlike evas_object_pass_events_set, events will not be passed to next lower object. This API can be used for blocking events while obj
is in transition.
If freeze
is false
, events will be processed on that object as normal.
- Warning:
- If you block only key/mouse up events with this API, you can't be sure of the state of any objects that have only key/mouse down events.
- Parameters:
-
[in] obj The object. [in] freeze Pass when obj
is to freeze events ($true) or not ($false).
- Since (EFL) :
- 1.1
- Since :
- 2.3
Eina_Bool evas_object_is_frame_object_get | ( | const Efl_Canvas_Object * | obj | ) |
If true
the object belongs to the window border decorations.
This will be false
by default, and should be false
for all objects created by the application, unless swallowed in some very specific parts of the window.
It is very unlikely that an application needs to call this manually, as the window will handle this feature automatically.
- Parameters:
-
[in] obj The object.
- Returns:
true
if the object is a frame,false
otherwise
- Since (EFL) :
- 1.2
- Since :
- 3.0
void evas_object_is_frame_object_set | ( | Efl_Canvas_Object * | obj, |
Eina_Bool | is_frame | ||
) |
If true
the object belongs to the window border decorations.
This will be false
by default, and should be false
for all objects created by the application, unless swallowed in some very specific parts of the window.
It is very unlikely that an application needs to call this manually, as the window will handle this feature automatically.
- Parameters:
-
[in] obj The object. [in] is_frame true
if the object is a frame,false
otherwise
- Since (EFL) :
- 1.2
- Since :
- 3.0
short evas_object_layer_get | ( | const Evas_Object * | obj | ) |
Retrieves the layer of its canvas that the given object is part of.
- Returns:
- Number of its layer
- See also:
- evas_object_layer_set()
- Since :
- 2.3
- Examples:
- evas-stacking.c.
void evas_object_layer_set | ( | Evas_Object * | obj, |
short | l | ||
) |
Sets the layer of its canvas that the given object will be part of.
If you don't use this function, you'll be dealing with an unique layer of objects, the default one. Additional layers are handy when you don't want a set of objects to interfere with another set with regard to stacking. Two layers are completely disjoint in that matter.
This is a low-level function, which you'd be using when something should be always on top, for example.
- Warning:
- Be careful, it doesn't make sense to change the layer of smart objects' children. Smart objects have a layer of their own, which should contain all their children objects.
- See also:
- evas_object_layer_get()
- Parameters:
-
[in] l The number of the layer to place the object on. Must be between #EVAS_LAYER_MIN and #EVAS_LAYER_MAX.
- Since :
- 2.3
- Examples:
- eina_tiler_01.c, and evas-stacking.c.
void evas_object_lower | ( | Evas_Object * | obj | ) |
Lower obj
to the bottom of its layer.
obj
will, then, be the lowest one in the layer it belongs to. Objects on other layers won't get touched.
- Since :
- 2.3
- Examples:
- evas-stacking.c.
Eina_Bool evas_object_map_enable_get | ( | const Evas_Object * | obj | ) |
Whether the map is enabled or not.
- Parameters:
-
[in] obj The evas object
- Returns:
- The value of
enabled
as passed to evas_object_map_enable_set().
- See also:
- evas_object_map_enable_set
- Since :
- 2.3
void evas_object_map_enable_set | ( | Evas_Object * | obj, |
Eina_Bool | enabled | ||
) |
Enable or disable the map that is set.
Enable or disable the use of map for the object obj
. On enable, the object geometry will be saved, and the new geometry will change (position and size) to reflect the map geometry set.
If the object doesn't have a map set (with evas_object_map_set), the initial geometry will be undefined. It is advised to always set a map to the object first, and then call this function to enable its use.
- Parameters:
-
[in] enabled Enabled state.
- Since :
- 2.3
- Examples:
- evas-map-utils.c, and evas-smart-object.c.
const Evas_Map* evas_object_map_get | ( | const Evas_Object * | obj | ) |
Get current object transformation map.
This returns the current internal map set on the indicated object. It is intended for read-only access and is only valid as long as the object is not deleted or the map on the object is not changed.
- Returns:
- The map.
- Since :
- 2.3
void evas_object_map_set | ( | Evas_Object * | obj, |
const Evas_Map * | map | ||
) |
Set current object transformation map.
This sets the map on a given object. It is copied from the map
pointer, so there is no need to keep the map
object if you don't need it anymore.
A map is a set of 4 points which have canvas x, y coordinates per point, with an optional z point value as a hint for perspective correction, if it is available. As well each point has u and v coordinates. These are like "texture coordinates" in OpenGL in that they define a point in the source image that is mapped to that map vertex/point. The u corresponds to the x coordinate of this mapped point and v, the y coordinate. Note that these coordinates describe a bounding region to sample.
- Note:
- The map points a uv coordinates match the image geometry. If the
map
parameter isnull
, the stored map will be freed and geometry prior to enabling/setting a map will be restored.
- Parameters:
-
[in] map The map.
- Since :
- 2.3
- Examples:
- evas-map-utils.c, and evas-smart-object.c.
void evas_object_move | ( | Evas_Object * | obj, |
Evas_Coord | x, | ||
Evas_Coord | y | ||
) |
Move the given Evas object to the given location inside its canvas' viewport.
- Parameters:
-
[in] x in [in] y in
- Since :
- 2.3
- Examples:
- box_example_02.c, bubble_example_01.c, button_example_00.c, check_example_01.c, ctxpopup_example_01.c, ecore_animator_example.c, ecore_evas_buffer_example_01.c, ecore_evas_buffer_example_02.c, ecore_evas_window_sizes_example.c, ecore_imf_example.c, edje-basic.c, edje-box.c, edje-box2.c, edje-color-class.c, edje-drag.c, edje-perspective.c, edje-signals-messages.c, edje-swallow.c, edje-table.c, edje-text.c, efl_thread_1.c, efl_thread_2.c, efl_thread_3.c, efl_thread_4.c, efl_thread_5.c, efl_thread_6.c, eina_tiler_01.c, evas-aspect-hints.c, evas-box.c, evas-buffer-simple.c, evas-events.c, evas-hints.c, evas-images.c, evas-images2.c, evas-map-utils.c, evas-object-manipulation.c, evas-smart-interface.c, evas-smart-object.c, evas-stacking.c, evas-table.c, evas-text.c, flip_example_01.c, frame_example_01.c, hover_example_01.c, hoversel_example_01.c, label_example_01.c, photocam_example_01.c, transit_example_01.c, transit_example_02.c, transit_example_03.c, and transit_example_04.c.
Evas_BiDi_Direction evas_object_paragraph_direction_get | ( | const Efl_Canvas_Object * | obj | ) |
This handles text paragraph direction of the given object. Even if the given object is not textblock or text, its smart child objects can inherit the paragraph direction from the given object. The default paragraph direction is inherit
.
- Parameters:
-
[in] obj The object.
- Returns:
- Paragraph direction for the given object.
- Since :
- 3.0
void evas_object_paragraph_direction_set | ( | Efl_Canvas_Object * | obj, |
Evas_BiDi_Direction | dir | ||
) |
This handles text paragraph direction of the given object. Even if the given object is not textblock or text, its smart child objects can inherit the paragraph direction from the given object. The default paragraph direction is inherit
.
- Parameters:
-
[in] obj The object. [in] dir Paragraph direction for the given object.
- Since :
- 3.0
Eina_Bool evas_object_pass_events_get | ( | const Efl_Canvas_Object * | obj | ) |
Determine whether an object is set to pass (ignore) events.
See also evas_object_repeat_events_get, evas_object_propagate_events_get.
- Parameters:
-
[in] obj The object.
- Returns:
- Whether
obj
is to pass events ($true) or not ($false).
- Since :
- 2.3
- Examples:
- evas-stacking.c.
void evas_object_pass_events_set | ( | Efl_Canvas_Object * | obj, |
Eina_Bool | pass | ||
) |
Set whether an Evas object is to pass (ignore) events.
If pass
is true
, it will make events on obj
to be ignored. They will be triggered on the next lower object (that is not set to pass events), instead (see Efl::Gfx::Stack::below).
If pass
is false
events will be processed on that object as normal.
See also evas_object_repeat_events_set, evas_object_propagate_events_set
- Parameters:
-
[in] obj The object. [in] pass Whether obj
is to pass events ($true) or not ($false).
- Since :
- 2.3
- Examples:
- ecore_imf_example.c, and evas-stacking.c.
Eina_Bool evas_object_pointer_coords_inside_get | ( | const Evas_Object * | eo_obj, |
int | x, | ||
int | y | ||
) |
Returns whether the coords are logically inside the object.
When this function is called it will return a value of either false
or true
, depending on if the coords are inside the object's current geometry.
A return value of true
indicates the position is logically inside the object, and false
implies it is logically outside the object.
If e
is not a valid object, the return value is undefined.
- Parameters:
-
[in] x The canvas-relative x coordinate. [in] y The canvas-relative y coordinate.
- Returns:
true
if the coords are inside the object,false
otherwise
Eina_Bool evas_object_pointer_inside_by_device_get | ( | const Evas_Object * | obj, |
Efl_Input_Device * | dev | ||
) |
Returns whether the mouse pointer is logically inside the object.
- Parameters:
-
[in] dev The pointer device.
- Returns:
true
if the pointer is inside,false
otherwise.
- Since (EFL) :
- 1.20
Eina_Bool evas_object_pointer_inside_get | ( | const Evas_Object * | obj | ) |
Returns whether the default mouse pointer is logically inside the object.
When this function is called it will return a value of either false
or true
, depending on if event_feed_mouse_in or event_feed_mouse_out have been called to feed in a mouse enter event into the object.
A return value of true
indicates the mouse is logically inside the object, and false
implies it is logically outside the object.
If e
is not a valid object, the return value is undefined.
- Returns:
true
if the mouse pointer is inside the object,false
otherwise
Low-level pointer behaviour.
This function has a direct effect on event callbacks related to pointers (mouse, ...).
If the value is EVAS_OBJECT_POINTER_MODE_AUTO_GRAB (default), then when mouse is pressed down over this object, events will be restricted to it as source, mouse moves, for example, will be emitted even when the pointer goes outside this objects geometry.
If the value is EVAS_OBJECT_POINTER_MODE_NO_GRAB, then events will be emitted just when inside this object area.
The default value is EVAS_OBJECT_POINTER_MODE_AUTO_GRAB. See also: Efl::Canvas::Object::pointer_mode_by_device::get and Efl::Canvas::Object::pointer_mode_by_device::set Note: This function will only set/get the mode for the default pointer.
- Parameters:
-
[in] obj The object.
- Returns:
- Input pointer mode
- Since :
- 2.3
Eina_Bool evas_object_pointer_mode_set | ( | Efl_Canvas_Object * | obj, |
Evas_Object_Pointer_Mode | pointer_mode | ||
) |
Low-level pointer behaviour.
This function has a direct effect on event callbacks related to pointers (mouse, ...).
If the value is EVAS_OBJECT_POINTER_MODE_AUTO_GRAB (default), then when mouse is pressed down over this object, events will be restricted to it as source, mouse moves, for example, will be emitted even when the pointer goes outside this objects geometry.
If the value is EVAS_OBJECT_POINTER_MODE_NO_GRAB, then events will be emitted just when inside this object area.
The default value is EVAS_OBJECT_POINTER_MODE_AUTO_GRAB. See also: Efl::Canvas::Object::pointer_mode_by_device::get and Efl::Canvas::Object::pointer_mode_by_device::set Note: This function will only set/get the mode for the default pointer.
- Parameters:
-
[in] obj The object. [in] pointer_mode Input pointer mode
- Returns:
true
if pointer behaviour was set,false
otherwise
- Since :
- 2.3
Eina_Bool evas_object_precise_is_inside_get | ( | const Efl_Canvas_Object * | obj | ) |
Determine whether an object is set to use precise point collision detection.
- Parameters:
-
[in] obj The object.
- Returns:
- Whether to use precise point collision detection or not. The default value is false.
- Since :
- 2.3
- Examples:
- evas-events.c.
void evas_object_precise_is_inside_set | ( | Efl_Canvas_Object * | obj, |
Eina_Bool | precise | ||
) |
Set whether to use precise (usually expensive) point collision detection for a given Evas object.
Use this function to make Evas treat objects' transparent areas as not belonging to it with regard to mouse pointer events. By default, all of the object's boundary rectangle will be taken in account for them.
- Warning:
- By using precise point collision detection you'll be making Evas more resource intensive.
- Parameters:
-
[in] obj The object. [in] precise Whether to use precise point collision detection or not. The default value is false.
- Since :
- 2.3
- Examples:
- evas-events.c.
Eina_Bool evas_object_propagate_events_get | ( | const Efl_Canvas_Object * | obj | ) |
Retrieve whether an Evas object is set to propagate events.
See also evas_object_repeat_events_get, evas_object_pass_events_get.
- Parameters:
-
[in] obj The object.
- Returns:
- Whether to propagate events ($true) or not ($false).
- Since :
- 2.3
void evas_object_propagate_events_set | ( | Efl_Canvas_Object * | obj, |
Eina_Bool | propagate | ||
) |
Set whether events on a smart object's member should be propagated up to its parent.
This function has no effect if obj
is not a member of a smart object.
If prop
is true
, events occurring on this object will be propagated on to the smart object of which obj
is a member. If prop
is false
, events occurring on this object will not be propagated on to the smart object of which obj
is a member. The default value is true
.
See also evas_object_repeat_events_set, evas_object_pass_events_set.
- Parameters:
-
[in] obj The object. [in] propagate Whether to propagate events ($true) or not ($false).
- Since :
- 2.3
- Examples:
- gengrid_example.c.
void evas_object_raise | ( | Evas_Object * | obj | ) |
Raise obj
to the top of its layer.
obj
will, then, be the highest one in the layer it belongs to. Object on other layers won't get touched.
- Since :
- 2.3
- Examples:
- evas-stacking.c.
Evas_Render_Op evas_object_render_op_get | ( | const Evas_Object * | obj | ) |
Retrieves the current value of the operation used for rendering the Evas object.
- Returns:
- One of the Evas_Render_Op values. Only blend (default) and copy modes are supported.
- Since :
- 2.3
void evas_object_render_op_set | ( | Evas_Object * | obj, |
Evas_Render_Op | render_op | ||
) |
Sets the render mode to be used for compositing the Evas object.
Note that only copy and blend modes are actually supported: - Evas_Render_Op::EVAS_RENDER_BLEND means the object will be merged on top of objects below it using simple alpha compositing. - Evas_Render_Op::EVAS_RENDER_COPY means this object's pixels will replace everything that is below, making this object opaque.
Please do not assume that Evas_Render_Op::EVAS_RENDER_COPY mode can be used to "poke" holes in a window (to see through it), as only the compositor can ensure that. Copy mode should only be used with otherwise opaque widgets, or inside non-window surfaces (eg. a transparent background inside an Ecore.Evas.Buffer).
- Parameters:
-
[in] render_op One of the Evas_Render_Op values. Only blend (default) and copy modes are supported.
- Since :
- 2.3
Eina_Bool evas_object_repeat_events_get | ( | const Efl_Canvas_Object * | obj | ) |
Determine whether an object is set to repeat events.
- Parameters:
-
[in] obj The object.
- Returns:
- Whether
obj
is to repeat events ($true) or not ($false).
- Since :
- 2.3
- Examples:
- evas-stacking.c.
void evas_object_repeat_events_set | ( | Efl_Canvas_Object * | obj, |
Eina_Bool | repeat | ||
) |
Set whether an Evas object is to repeat events.
If repeat
is true
, it will make events on obj
to also be repeated for the next lower object in the objects' stack (see see Efl::Gfx::Stack::below).
If repeat
is false
, events occurring on obj
will be processed only on it.
- Parameters:
-
[in] obj The object. [in] repeat Whether obj
is to repeat events ($true) or not ($false).
- Since :
- 2.3
- Examples:
- edje-signals-messages.c, and evas-stacking.c.
void evas_object_resize | ( | Evas_Object * | obj, |
Evas_Coord | w, | ||
Evas_Coord | h | ||
) |
Changes the size of the given Evas object.
- Parameters:
-
[in] w in [in] h in
- Since :
- 2.3
- Examples:
- actionslider_example_01.c, bg_example_01.c, bg_example_02.c, bg_example_03.c, box_example_02.c, bubble_example_01.c, button_example_00.c, button_example_01.c, check_example_01.c, codegen_example.c, colorselector_example_01.c, combobox_example_01.c, conformant_example_01.c, conformant_example_02.c, ctxpopup_example_01.c, dayselector_example.c, diskselector_example_01.c, ecore_animator_example.c, ecore_evas_basics_example.c, ecore_evas_buffer_example_01.c, ecore_evas_buffer_example_02.c, ecore_evas_callbacks.c, ecore_evas_object_example.c, ecore_evas_window_sizes_example.c, ecore_imf_example.c, edje-basic.c, edje-box.c, edje-box2.c, edje-color-class.c, edje-drag.c, edje-perspective.c, edje-signals-messages.c, edje-swallow.c, edje-table.c, edje-text.c, efl_thread_1.c, efl_thread_2.c, efl_thread_3.c, efl_thread_4.c, efl_thread_5.c, efl_thread_6.c, eina_tiler_01.c, entry_example.c, evas-aspect-hints.c, evas-box.c, evas-buffer-simple.c, evas-events.c, evas-hints.c, evas-images.c, evas-images2.c, evas-map-utils.c, evas-object-manipulation.c, evas-smart-interface.c, evas-smart-object.c, evas-stacking.c, evas-table.c, evas-text.c, fileselector_button_example.c, fileselector_entry_example.c, fileselector_example.c, flip_example_01.c, frame_example_01.c, general_funcs_example.c, gengrid_example.c, genlist_example_01.c, genlist_example_02.c, genlist_example_03.c, genlist_example_04.c, genlist_example_05.c, glview_example_01.c, hover_example_01.c, hoversel_example_01.c, icon_example_01.c, image_example_01.c, index_example_01.c, index_example_02.c, inwin_example.c, label_example_01.c, layout_example_01.c, layout_example_02.c, layout_example_03.c, list_example_01.c, list_example_02.c, list_example_03.c, map_example_01.c, map_example_02.c, map_example_03.c, mapbuf_example.c, menu_example_01.c, naviframe_example.c, notify_example_01.c, panes_example.c, photocam_example_01.c, popup_example_01.c, popup_example_02.c, popup_example_03.c, prefs_example_01.c, prefs_example_02.c, prefs_example_03.c, relative_container_example_01.c, relative_container_example_02.c, scroller_example_01.c, slideshow_example.c, theme_example_01.c, theme_example_02.c, thumb_example_01.c, toolbar_example_01.c, toolbar_example_02.c, toolbar_example_03.c, track_example_01.c, transit_example_01.c, transit_example_02.c, transit_example_03.c, transit_example_04.c, web_example_02.c, and win_example.c.
double evas_object_scale_get | ( | const Evas_Object * | obj | ) |
Retrieves the scaling factor for the given Evas object.
- Parameters:
-
[in] obj The object.
- Returns:
- The scaling factor. 1.0 means no scaling, default size.
- Since :
- 2.3
void evas_object_scale_set | ( | Evas_Object * | obj, |
double | scale | ||
) |
Sets the scaling factor for an Evas object. Does not affect all objects.
This will multiply the object's dimension by the given factor, thus altering its geometry (width and height). Useful when you want scalable UI elements, possibly at run time.
- Note:
- Only text and textblock objects have scaling change handlers. Other objects won't change visually on this call.
- Parameters:
-
[in] obj The object. [in] scale The scaling factor. 1.0 means no scaling, default size.
- Since :
- 2.3
void evas_object_size_hint_align_get | ( | const Evas_Object * | obj, |
double * | x, | ||
double * | y | ||
) |
Retrieves the hints for on object's alignment.
This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
- Note:
- Use
null
pointers on the hint components you're not interested in: they'll be ignored by the function. -
If
obj
is invalid, then the hint components will be set with 0.5
- Parameters:
-
[out] x Double, ranging from 0.0 to 1.0 or with the special value #EVAS_HINT_FILL, to use as horizontal alignment hint. [out] y Double, ranging from 0.0 to 1.0 or with the special value #EVAS_HINT_FILL, to use as vertical alignment hint.
- Since :
- 2.3
- Examples:
- button_example_01.c, and evas-hints.c.
void evas_object_size_hint_align_set | ( | Evas_Object * | obj, |
double | x, | ||
double | y | ||
) |
Sets the hints for an object's alignment.
These are hints on how to align an object inside the boundaries of a container/manager. Accepted values are in the 0.0 to 1.0 range, with the special value #EVAS_HINT_FILL used to specify "justify" or "fill" by some users. In this case, maximum size hints should be enforced with higher priority, if they are set. Also, any padding hint set on objects should add up to the alignment space on the final scene composition.
See documentation of possible users: in Evas, they are the box and table smart objects.
For the horizontal component, 0.0 means to the left, 1.0 means to the right. Analogously, for the vertical component, 0.0 to the top, 1.0 means to the bottom.
This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
- Note:
- Default alignment hint values are 0.5, for both axis.
- Parameters:
-
[in] x Double, ranging from 0.0 to 1.0 or with the special value #EVAS_HINT_FILL, to use as horizontal alignment hint. [in] y Double, ranging from 0.0 to 1.0 or with the special value #EVAS_HINT_FILL, to use as vertical alignment hint.
- Since :
- 2.3
- Examples:
- actionslider_example_01.c, bg_example_03.c, box_example_02.c, button_example_01.c, calendar_example_04.c, calendar_example_06.c, codegen_example.c, colorselector_example_01.c, combobox_example_01.c, conformant_example_01.c, conformant_example_02.c, datetime_example.c, dayselector_example.c, diskselector_example_01.c, diskselector_example_02.c, entry_example.c, evas-hints.c, fileselector_entry_example.c, fileselector_example.c, general_funcs_example.c, gengrid_example.c, genlist_example_02.c, genlist_example_03.c, genlist_example_04.c, genlist_example_05.c, glview_example_01.c, index_example_01.c, inwin_example.c, layout_example_01.c, layout_example_03.c, list_example_01.c, list_example_03.c, map_example_03.c, mapbuf_example.c, panel_example_01.c, panes_example.c, prefs_example_01.c, prefs_example_02.c, progressbar_example.c, radio_example_01.c, relative_container_example_01.c, relative_container_example_02.c, separator_example_01.c, slider_example.c, spinner_example.c, toolbar_example_01.c, toolbar_example_02.c, toolbar_example_03.c, transit_example_03.c, transit_example_04.c, web_example_02.c, and win_example.c.
void evas_object_size_hint_aspect_get | ( | const Evas_Object * | obj, |
Evas_Aspect_Control * | aspect, | ||
Evas_Coord * | w, | ||
Evas_Coord * | h | ||
) |
Retrieves the hints for an object's aspect ratio.
The different aspect ratio policies are documented in the #Evas_Aspect_Control type. A container respecting these size hints would resize its children accordingly to those policies.
For any policy, if any of the given aspect ratio terms are 0, the object's container should ignore the aspect and scale obj
to occupy the whole available area. If they are both positive integers, that proportion will be respected, under each scaling policy.
- Note:
- Use
null
pointers on the hint components you're not interested in: they'll be ignored by the function.
- Parameters:
-
[out] aspect The policy/type of aspect ratio to apply to obj
.[out] w Integer to use as aspect width ratio term. [out] h Integer to use as aspect height ratio term.
- Since :
- 2.3
- Examples:
- evas-aspect-hints.c.
void evas_object_size_hint_aspect_set | ( | Evas_Object * | obj, |
Evas_Aspect_Control | aspect, | ||
Evas_Coord | w, | ||
Evas_Coord | h | ||
) |
Sets the hints for an object's aspect ratio.
This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
If any of the given aspect ratio terms are 0, the object's container will ignore the aspect and scale obj
to occupy the whole available area, for any given policy.
- Note:
- Smart objects(such as elementary) can have their own size hint policy. So calling this API may or may not affect the size of smart objects.
- Parameters:
-
[in] aspect The policy/type of aspect ratio to apply to obj
.[in] w Integer to use as aspect width ratio term. [in] h Integer to use as aspect height ratio term.
- Since :
- 2.3
Evas_Display_Mode evas_object_size_hint_display_mode_get | ( | const Evas_Object * | obj | ) |
Retrieves the hints for an object's display mode.
These are hints on the display mode obj
. This is not a size enforcement in any way, it's just a hint that can be used whenever appropriate. This mode can be used object's display mode like compress or expand.
- Returns:
- Display mode hint.
- Since :
- 2.3
void evas_object_size_hint_display_mode_set | ( | Evas_Object * | obj, |
Evas_Display_Mode | dispmode | ||
) |
Sets the hints for an object's disply mode,.
This is not a size enforcement in any way, it's just a hint that can be used whenever appropriate.
- Parameters:
-
[in] dispmode Display mode hint.
- Since :
- 2.3
void evas_object_size_hint_max_get | ( | const Evas_Object * | obj, |
Evas_Coord * | w, | ||
Evas_Coord * | h | ||
) |
Retrieves the hints for an object's maximum size.
These are hints on the maximum sizes obj
should have. This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
- Note:
- Use
null
pointers on the hint components you're not interested in: they'll be ignored by the function.
- Parameters:
-
[out] w Integer to use as the maximum width hint. [out] h Integer to use as the maximum height hint.
- Since :
- 2.3
- Examples:
- evas-hints.c.
void evas_object_size_hint_max_set | ( | Evas_Object * | obj, |
Evas_Coord | w, | ||
Evas_Coord | h | ||
) |
Sets the hints for an object's maximum size.
This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
Values -1 will be treated as unset hint components, when queried by managers.
- Note:
- Smart objects (such as elementary) can have their own size hint policy. So calling this API may or may not affect the size of smart objects.
- Parameters:
-
[in] w Integer to use as the maximum width hint. [in] h Integer to use as the maximum height hint.
- Since :
- 2.3
- Examples:
- evas-hints.c.
void evas_object_size_hint_min_get | ( | const Evas_Object * | obj, |
Evas_Coord * | w, | ||
Evas_Coord * | h | ||
) |
Retrieves the hints for an object's minimum size.
These are hints on the minimum sizes obj
should have. This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
- Note:
- Use
null
pointers on the hint components you're not interested in: they'll be ignored by the function.
- Parameters:
-
[out] w Integer to use as the minimum width hint. [out] h Integer to use as the minimum height hint.
- Since :
- 2.3
void evas_object_size_hint_min_set | ( | Evas_Object * | obj, |
Evas_Coord | w, | ||
Evas_Coord | h | ||
) |
Sets the hints for an object's minimum size.
This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
Values 0 will be treated as unset hint components, when queried by managers.
- Note:
- Smart objects(such as elementary) can have their own size hint policy. So calling this API may or may not affect the size of smart objects.
- Parameters:
-
[in] w Integer to use as the minimum width hint. [in] h Integer to use as the minimum height hint.
- Since :
- 2.3
void evas_object_size_hint_padding_get | ( | const Evas_Object * | obj, |
Evas_Coord * | l, | ||
Evas_Coord * | r, | ||
Evas_Coord * | t, | ||
Evas_Coord * | b | ||
) |
Retrieves the hints for an object's padding space.
Padding is extra space an object takes on each of its delimiting rectangle sides, in canvas units.
This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
- Note:
- Use
null
pointers on the hint components you're not interested in: they'll be ignored by the function.
- Parameters:
-
[out] l Integer to specify left padding. [out] r Integer to specify right padding. [out] t Integer to specify top padding. [out] b Integer to specify bottom padding.
- Since :
- 2.3
- Examples:
- evas-hints.c.
void evas_object_size_hint_padding_set | ( | Evas_Object * | obj, |
Evas_Coord | l, | ||
Evas_Coord | r, | ||
Evas_Coord | t, | ||
Evas_Coord | b | ||
) |
Sets the hints for an object's padding space.
This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
- Note:
- Smart objects(such as elementary) can have their own size hint policy. So calling this API may or may not affect the size of smart objects.
- Parameters:
-
[in] l Integer to specify left padding. [in] r Integer to specify right padding. [in] t Integer to specify top padding. [in] b Integer to specify bottom padding.
- Since :
- 2.3
- Examples:
- evas-hints.c.
void evas_object_size_hint_request_get | ( | const Evas_Object * | obj, |
Evas_Coord * | w, | ||
Evas_Coord * | h | ||
) |
Retrieves the hints for an object's optimum size.
These are hints on the optimum sizes obj
should have. This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
- Note:
- Use
null
pointers on the hint components you're not interested in: they'll be ignored by the function.
- Parameters:
-
[out] w Integer to use as the preferred width hint. [out] h Integer to use as the preferred height hint.
- Since :
- 3.0
void evas_object_size_hint_request_set | ( | Evas_Object * | obj, |
Evas_Coord | w, | ||
Evas_Coord | h | ||
) |
Sets the hints for an object's optimum size.
This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
Values 0 will be treated as unset hint components, when queried by managers.
- Note:
- Smart objects(such as elementary) can have their own size hint policy. So calling this API may or may not affect the size of smart objects.
- Parameters:
-
[in] w Integer to use as the preferred width hint. [in] h Integer to use as the preferred height hint.
- Since :
- 3.0
void evas_object_size_hint_weight_get | ( | const Evas_Object * | obj, |
double * | x, | ||
double * | y | ||
) |
Retrieves the hints for an object's weight.
Accepted values are zero or positive values. Some users might use this hint as a boolean, but some might consider it as a proportion, see documentation of possible users, which in Evas are the box and table smart objects.
This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
- Note:
- Use
null
pointers on the hint components you're not interested in: they'll be ignored by the function. -
If
obj
is invalid, then the hint components will be set with 0.0.
- Parameters:
-
[out] x Non-negative double value to use as horizontal weight hint. [out] y Non-negative double value to use as vertical weight hint.
- Since :
- 2.3
- Examples:
- evas-hints.c.
void evas_object_size_hint_weight_set | ( | Evas_Object * | obj, |
double | x, | ||
double | y | ||
) |
Sets the hints for an object's weight.
This is not a size enforcement in any way, it's just a hint that should be used whenever appropriate.
This is a hint on how a container object should resize a given child within its area. Containers may adhere to the simpler logic of just expanding the child object's dimensions to fit its own (see the #EVAS_HINT_EXPAND helper weight macro) or the complete one of taking each child's weight hint as real weights to how much of its size to allocate for them in each axis. A container is supposed to, after normalizing the weights of its children (with weight hints), distribute the space it has to layout them by those factors -- most weighted children get larger in this process than the least ones.
- Note:
- Default weight hint values are 0.0, for both axis.
- Parameters:
-
[in] x Non-negative double value to use as horizontal weight hint. [in] y Non-negative double value to use as vertical weight hint.
- Since :
- 2.3
- Examples:
- actionslider_example_01.c, bg_example_02.c, bg_example_03.c, box_example_02.c, button_example_01.c, calendar_example_01.c, calendar_example_02.c, calendar_example_03.c, calendar_example_04.c, calendar_example_05.c, calendar_example_06.c, clock_example.c, codegen_example.c, colorselector_example_01.c, combobox_example_01.c, conformant_example_01.c, conformant_example_02.c, ctxpopup_example_01.c, datetime_example.c, dayselector_example.c, diskselector_example_01.c, diskselector_example_02.c, edje-table.c, entry_example.c, evas-hints.c, fileselector_button_example.c, fileselector_entry_example.c, fileselector_example.c, flipselector_example.c, general_funcs_example.c, gengrid_example.c, genlist_example_01.c, genlist_example_02.c, genlist_example_03.c, genlist_example_04.c, genlist_example_05.c, glview_example_01.c, icon_example_01.c, image_example_01.c, index_example_01.c, index_example_02.c, inwin_example.c, layout_example_01.c, layout_example_02.c, layout_example_03.c, list_example_01.c, list_example_02.c, list_example_03.c, map_example_01.c, map_example_02.c, map_example_03.c, mapbuf_example.c, naviframe_example.c, notify_example_01.c, panel_example_01.c, panes_example.c, prefs_example_01.c, prefs_example_02.c, prefs_example_03.c, progressbar_example.c, radio_example_01.c, relative_container_example_01.c, relative_container_example_02.c, scroller_example_01.c, segment_control_example.c, separator_example_01.c, slider_example.c, slideshow_example.c, spinner_example.c, theme_example_01.c, theme_example_02.c, thumb_example_01.c, toolbar_example_01.c, toolbar_example_02.c, toolbar_example_03.c, track_example_01.c, transit_example_03.c, transit_example_04.c, web_example_02.c, and win_example.c.
Efl_Canvas_Object* evas_object_smart_parent_get | ( | const Efl_Canvas_Object * | obj | ) |
Gets the parent smart object of a given Evas object, if it has one.
This can be different from Efl::Object::parent because this one is used internally for rendering and the normal parent is what the user expects to be the parent.
- Parameters:
-
[in] obj The object.
- Returns:
- The parent smart object of
obj
ornull
.
- Since (EFL) :
- 1.18
- Since :
- 2.3
- Examples:
- evas-smart-interface.c, and evas-smart-object.c.
void evas_object_stack_above | ( | Evas_Object * | obj, |
Evas_Object * | above | ||
) |
Stack obj
immediately above above
Objects, in a given canvas, are stacked in the order they get added to it. This means that, if they overlap, the highest ones will cover the lowest ones, in that order. This function is a way to change the stacking order for the objects.
This function is intended to be used with objects belonging to the same layer in a given canvas, otherwise it will fail (and accomplish nothing).
If you have smart objects on your canvas and obj
is a member of one of them, then above
must also be a member of the same smart object.
Similarly, if obj
is not a member of a smart object, above
must not be either.
- Parameters:
-
[in] above the object above which to stack
- Since :
- 2.3
- Examples:
- evas-stacking.c.
void evas_object_stack_below | ( | Evas_Object * | obj, |
Evas_Object * | below | ||
) |
Stack obj
immediately below below
Objects, in a given canvas, are stacked in the order they get added to it. This means that, if they overlap, the highest ones will cover the lowest ones, in that order. This function is a way to change the stacking order for the objects.
This function is intended to be used with objects belonging to the same layer in a given canvas, otherwise it will fail (and accomplish nothing).
If you have smart objects on your canvas and obj
is a member of one of them, then below
must also be a member of the same smart object.
Similarly, if obj
is not a member of a smart object, below
must not be either.
- Parameters:
-
[in] below the object below which to stack
- Since :
- 2.3
- Examples:
- evas-stacking.c.
Eina_Bool evas_object_static_clip_get | ( | const Evas_Object * | obj | ) |
Get the "static clipper" hint flag for a given Evas object.
- Returns:
true
if it's to be used as a static clipper,false
otherwise.
- Since :
- 2.3
- Examples:
- evas-smart-interface.c, and evas-smart-object.c.
void evas_object_static_clip_set | ( | Evas_Object * | obj, |
Eina_Bool | is_static_clip | ||
) |
Set a hint flag on the given Evas object that it's used as a "static clipper".
This is a hint to Evas that this object is used as a big static clipper and shouldn't be moved with children and otherwise considered specially. The default value for new objects is false
.
- Parameters:
-
[in] is_static_clip true
if it's to be used as a static clipper,false
otherwise.
- Since :
- 2.3
Eina_Bool evas_object_visible_get | ( | const Evas_Object * | obj | ) |
Retrieves whether or not the given Evas object is visible.
- Since :
- 2.3
- Examples:
- evas-object-manipulation.c, and track_example_01.c.