Box#
A generic container for other widgets. Used to construct layouts.
Usage#
An empty Box can be constructed without any children, with children added to the box after construction:
import toga
box = toga.Box()
label1 = toga.Label('Hello')
label2 = toga.Label('World')
box.add(label1)
box.add(label2)
Alternatively, children can be specified at the time the box is constructed:
import toga
label1 = toga.Label('Hello')
label2 = toga.Label('World')
box = toga.Box(children=[label1, label2])
In most apps, a layout is constructed by building a tree of boxes inside boxes,
with concrete widgets (such as Label
or
Button
) forming the leaf nodes of the tree. Style
directives can be applied to enforce padding around the outside of the box,
direction of child stacking inside the box, and background color of the box.
Reference#
- class toga.widgets.box.Box(id=None, style=None, children=None)#
Create a new Box container widget.
Inherits from
Widget
.- Parameters:
text – The text to display on the button.
id – The ID for the widget.
style – A style object. If no style is provided, a default style will be applied to the widget.
children – An optional list of children for to add to the Box.