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.Box(id=None, style=None, children=None)¶
Bases:
Widget
Create a new Box container widget.
- Parameters:
- property enabled: bool¶
Is the widget currently enabled? i.e., can the user interact with the widget?
Box widgets cannot be disabled; this property will always return True; any attempt to modify it will be ignored.
- focus()¶
No-op; Box cannot accept input focus.
- Return type:
None