Tizen Native API 5.5
A box arranges objects in a linear fashion, governed by a layout function that defines the details of this arrangement.
By default, the box will use an internal function to set the layout to a single row, either vertical or horizontal. This layout is affected by a number of parameters, such as the homogeneous flag set by elm_box_homogeneous_set(), the values given by elm_box_padding_set() and elm_box_align_set() and the hints set to each object in the box.
For this default layout, it's possible to change the orientation with elm_box_horizontal_set(). The box will start in the vertical orientation, placing its elements ordered from top to bottom. When horizontal is set, the order will go from left to right. If the box is set to be homogeneous, every object in it will be assigned the same space, that of the largest object. Padding can be used to set some spacing between the cell given to each object. The alignment of the box, set with elm_box_align_set(), determines how the bounding box of all the elements will be placed within the space given to the box widget itself.
The size hints of each object also affect how they are placed and sized within the box. evas_object_size_hint_min_set() will give the minimum size the object can have, and the box will use it as the basis for all latter calculations. Elementary widgets set their own minimum size as needed, so there's rarely any need to use it manually.
evas_object_size_hint_weight_set(), when not in homogeneous mode, is used to tell whether the object will be allocated the minimum size it needs or if the space given to it should be expanded. It's important to realize that expanding the size given to the object is not the same thing as resizing the object. It could very well end being a small widget floating in a much larger empty space. If not set, the weight for objects will normally be 0.0 for both axis, meaning the widget will not be expanded. To take as much space possible, set the weight to EVAS_HINT_EXPAND (defined to 1.0) for the desired axis to expand.
Besides how much space each object is allocated, it's possible to control how the widget will be placed within that space using evas_object_size_hint_align_set(). By default, this value will be 0.5 for both axis, meaning the object will be centered, but any value from 0.0 (left or top, for the
y axes, respectively) to 1.0 (right or bottom) can be used. The special value EVAS_HINT_FILL, which is -1.0, means the object will be resized to fill the entire space it was allocated.
In addition, customized functions to define the layout can be set, which allow the application developer to organize the objects within the box in any number of ways.
The special elm_box_layout_transition() function can be used to switch from one layout to another, animating the motion of the children of the box.
- Objects should not be added to box objects using _add() calls.
Some examples on how to use boxes follow:
|void||elm_box_layout_transition (Evas_Object *obj, Evas_Object_Box_Data *priv, void *data)|
|Elm_Box_Transition *||elm_box_transition_new (const double duration, Evas_Object_Box_Layout start_layout, void *start_layout_data, Ecore_Cb start_layout_free_data, Evas_Object_Box_Layout end_layout, void *end_layout_data, Ecore_Cb end_layout_free_data, Ecore_Cb transition_end_cb, void *transition_end_data)|
|void||elm_box_transition_free (void *data)|
|Evas_Object *||elm_box_add (Evas_Object *parent)|
|typedef struct _Elm_Box_Transition||Elm_Box_Transition|
Add a new box to the parent
By default, the box will be in vertical mode and non-homogeneous.
parent The parent object
- The new object or NULL if it cannot be created
- Since :
- actionslider_example_01.c, bg_example_03.c, box_example_02.c, button_example_01.c, calendar_example_04.c, calendar_example_06.c, clock_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, fileselector_button_example.c, fileselector_entry_example.c, fileselector_example.c, flipselector_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, list_example_01.c, list_example_03.c, map_example_01.c, map_example_02.c, map_example_03.c, mapbuf_example.c, notify_example_01.c, panel_example_01.c, progressbar_example.c, radio_example_01.c, separator_example_01.c, slider_example.c, slideshow_example.c, spinner_example.c, theme_example_01.c, theme_example_02.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.
Special layout function that animates the transition from one layout to another
obj The object. priv The smart object instance data. data Data will be passed to function.
Normally, when switching the layout function for a box, this will be reflected immediately on screen on the next render, but it's also possible to do this through an animated transition.
This is done by creating an Elm_Box_Transition and setting the box layout to this function.
Elm_Box_Transition *t = elm_box_transition_new(1.0, evas_object_box_layout_vertical, // start NULL, // data for initial layout NULL, // free function for initial data evas_object_box_layout_horizontal, // end NULL, // data for final layout NULL, // free function for final data anim_end, // will be called when animation ends NULL); // data for anim_end function elm_box_layout_set(box, elm_box_layout_transition, t, elm_box_transition_free);
- This function can only be used with elm_box_layout_set(). Calling it directly will not have the expected results.
- Since :
|void elm_box_transition_free||(||void *||data||)|
Free a Elm_Box_Transition instance created with elm_box_transition_new().
This function is mostly useful as the
free_data parameter in elm_box_layout_set() when elm_box_layout_transition().
data The Elm_Box_Transition instance to be freed.
- Since :
|Elm_Box_Transition* elm_box_transition_new||(||const double||duration,|
Create a new Elm_Box_Transition to animate the switch of layouts
If you want to animate the change from one layout to another, you need to set the layout function of the box to elm_box_layout_transition(), passing as user data to it an instance of Elm_Box_Transition with the necessary information to perform this animation. The free function to set for the layout is elm_box_transition_free().
The parameters to create an Elm_Box_Transition sum up to how long will it be, in seconds, a layout function to describe the initial point, another for the final position of the children and one function to be called when the whole animation ends. This last function is useful to set the definitive layout for the box, usually the same as the end layout for the animation, but could be used to start another transition.
duration The duration of the transition in seconds start_layout The layout function that will be used to start the animation start_layout_data The data to be passed the
start_layout_free_data Function to free
end_layout The layout function that will be used to end the animation end_layout_data Data param passed to
end_layout_free_data The data to be passed the
end_layout_free_data Function to free
transition_end_cb Callback function called when animation ends transition_end_data Data to be passed to
- An instance of Elm_Box_Transition
- Since :