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 a margin 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, **kwargs)¶
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