Tizen Native API
|
Functions | |
void | evas_object_size_hint_min_get (const Evas_Object *obj, Evas_Coord *w, Evas_Coord *h) |
Gets the hints for an object's minimum 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_size_hint_max_get (const Evas_Object *obj, Evas_Coord *w, Evas_Coord *h) |
Gets the hints for an object's maximum size. | |
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. | |
Evas_Display_Mode | evas_object_size_hint_display_mode_get (const Evas_Object *obj) |
Gets the hints for an object's display mode. | |
void | evas_object_size_hint_display_mode_set (Evas_Object *obj, Evas_Display_Mode dispmode) |
Sets the hints for an object's display mode. | |
void | evas_object_size_hint_aspect_get (const Evas_Object *obj, Evas_Aspect_Control *aspect, Evas_Coord *w, Evas_Coord *h) |
Gets the hints for an object's aspect ratio. | |
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_align_get (const Evas_Object *obj, double *x, double *y) |
Gets the hints for the object's alignment. | |
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_weight_get (const Evas_Object *obj, double *x, double *y) |
Gets the hints for an object's weight. | |
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_padding_get (const Evas_Object *obj, Evas_Coord *l, Evas_Coord *r, Evas_Coord *t, Evas_Coord *b) |
Gets the hints for an object's padding space. | |
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. | |
Defines | |
#define | evas_object_size_hint_fill_set evas_object_size_hint_align_set |
Convenience macro to make it easier to understand that align is also used for fill properties (as fill is mutually exclusive to align) | |
#define | evas_object_size_hint_fill_get evas_object_size_hint_align_get |
Convenience macro to make it easier to understand that align is also used for fill properties (as fill is mutually exclusive to align) | |
#define | evas_object_size_hint_expand_set evas_object_size_hint_weight_set |
Convenience macro to make it easier to understand that weight is also used for expand properties. | |
#define | evas_object_size_hint_expand_get evas_object_size_hint_weight_get |
Convenience macro to make it easier to understand that weight is also used for expand properties. |
This group provides functions for size hints.
Objects may carry hints, so that another object that acts as a manager (see Smart Object Functions) may know how to properly position and resize its subordinate objects. The Size Hints provide a common interface that is recommended as the protocol for such information.
For example, box objects use alignment hints to align its lines or columns inside its container, padding hints to set the padding between each individual child, and so on.
void evas_object_size_hint_align_get | ( | const Evas_Object * | obj, |
double * | x, | ||
double * | y | ||
) |
Gets the hints for the object's alignment.
NULL
pointers on the hint components that you are not interested in: they are ignored by the function. obj
is invalid, then the hint components are set with 0.5
[in] | obj | The given Evas object to query hints from |
[out] | x | The pointer to a double in which to store the horizontal alignment hint |
[out] | y | The pointer to a double in which to store the vertical alignment hint |
void evas_object_size_hint_align_set | ( | Evas_Object * | obj, |
double | x, | ||
double | y | ||
) |
Sets the hints for an object's alignment.
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.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.0.5
, for both axis.[in] | obj | The given Evas object to query hints from |
[in] | x | The horizontal alignment hint as double value ranging from 0.0 to 1.0 or with the special value EVAS_HINT_FILL |
[in] | y | The vertical alignment hint as double value ranging from 0.0 to 1.0 or with the special value EVAS_HINT_FILL |
void evas_object_size_hint_aspect_get | ( | const Evas_Object * | obj, |
Evas_Aspect_Control * | aspect, | ||
Evas_Coord * | w, | ||
Evas_Coord * | h | ||
) |
Gets the hints for an object's aspect ratio.
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 is respected, under each scaling policy.NULL
pointers on the hint components that you are not interested in: they are ignored by the function.[in] | obj | The given Evas object to query hints from |
[out] | aspect | The policy or type of aspect ratio applied to obj that is returned |
[out] | w | The pointer to an integer in which to store the aspect's width ratio term |
[out] | h | The pointer to an integer in which to store the aspect's height ratio term |
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.
0
, the object's container ignores the aspect and scale obj to occupy the whole available area, for any given policy.[in] | obj | The given Evas object to query hints from |
[in] | aspect | The policy or type of aspect ratio to apply to obj |
[in] | w | The integer to use as aspect width ratio term |
[in] | h | The integer to use as aspect height ratio term |
Evas_Display_Mode evas_object_size_hint_display_mode_get | ( | const Evas_Object * | obj | ) |
Gets the hints for an object's display mode.
[in] | obj | The given Evas object to query hints from |
void evas_object_size_hint_display_mode_set | ( | Evas_Object * | obj, |
Evas_Display_Mode | dispmode | ||
) |
Sets the hints for an object's display mode.
[in] | obj | The given Evas object to query hints from |
[in] | dispmode | The display mode hint |
void evas_object_size_hint_max_get | ( | const Evas_Object * | obj, |
Evas_Coord * | w, | ||
Evas_Coord * | h | ||
) |
Gets the hints for an object's maximum size.
NULL
pointers on the hint components that you are not interested in: they are ignored by the function.[in] | obj | The given Evas object to query hints from |
[out] | w | The pointer to an integer in which to store the maximum width |
[out] | h | The pointer to an integer in which to store the maximum height |
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.
-1
are treated as unset hint components, when queried by managers.[in] | obj | The given Evas object to query hints from |
[in] | w | The integer to use as the maximum width hint |
[in] | h | The integer to use as the maximum height hint |
void evas_object_size_hint_min_get | ( | const Evas_Object * | obj, |
Evas_Coord * | w, | ||
Evas_Coord * | h | ||
) |
Gets the hints for an object's minimum size.
NULL
pointers on the hint components that you are not interested in: they are ignored by the function.[in] | obj | The given Evas object to query hints from |
[out] | w | The pointer to an integer in which to store the minimum width |
[out] | h | The pointer to an integer in which to store the minimum height |
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.
0
are treated as unset hint components, when queried by managers.[in] | obj | The given Evas object to query hints from |
[in] | w | The integer to use as the minimum width hint |
[in] | h | The integer to use as the minimum height hint |
void evas_object_size_hint_padding_get | ( | const Evas_Object * | obj, |
Evas_Coord * | l, | ||
Evas_Coord * | r, | ||
Evas_Coord * | t, | ||
Evas_Coord * | b | ||
) |
Gets the hints for an object's padding space.
NULL
pointers on the hint components that you are not interested in: they are ignored by the function.[in] | obj | The given Evas object to query hints from |
[out] | l | The pointer to an integer in which to store left padding |
[out] | r | The pointer to an integer in which to store right padding |
[out] | t | The pointer to an integer in which to store top padding |
[out] | b | The pointer to an integer in which to store bottom padding |
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.
[in] | obj | The given Evas object to query hints from |
[in] | l | The integer to specify left padding |
[in] | r | The integer to specify right padding |
[in] | t | The integer to specify top padding |
[in] | b | The integer to specify bottom padding |
void evas_object_size_hint_weight_get | ( | const Evas_Object * | obj, |
double * | x, | ||
double * | y | ||
) |
Gets the hints for an object's weight.
0
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.NULL
pointers on the hint components that you are not interested in: they are ignored by the function. obj
is invalid, then the hint components are set with 0.0
[in] | obj | The given Evas object to query hints from |
[out] | x | The pointer to a double in which to store the horizontal weight |
[out] | y | The pointer to a double in which to store the vertical weight |
void evas_object_size_hint_weight_set | ( | Evas_Object * | obj, |
double | x, | ||
double | y | ||
) |
Sets the hints for an object's weight.
0.0
, for both axis.[in] | obj | The given Evas object to query hints from |
[in] | x | The non-negative double value to use as horizontal weight hint |
[in] | y | The non-negative double value to use as vertical weight hint |