.section Widgets
.topic widget.box
.title Box (VBox / HBox / Frame)
.toc 0 Layout Containers
.toc 0 Box (VBox / HBox / Frame)
.index VBox
.index HBox
.index Frame
.index wgtVBox
.index wgtHBox
.index wgtFrame
.index Layout

.h2 Box (VBox / HBox / Frame)

Container widgets that arrange their children in a vertical column (VBox), horizontal row (HBox), or a titled group box (Frame). These are the primary layout building blocks. Children are laid out using a flexbox-like algorithm with weight-based extra-space distribution.

Header: widgets/widgetBox.h

.h3 Creation

.table
  Macro                        Description
  -----                        -----------
  wgtVBox(parent)              Create a vertical box container. Children are stacked top to bottom.
  wgtHBox(parent)              Create a horizontal box container. Children are placed left to right.
  wgtFrame(parent, title)      Create a titled group box (a VBox with a border and label).
.endtable

.h3 Properties

Box containers use the common WidgetT fields for layout control:

.table
  Property     Description
  --------     -----------
  align        Main-axis alignment of children. HBox: Start=left, Center=center, End=right. VBox: Start=top, Center=center, End=bottom.
  spacing      Gap between children (tagged size).
  padding      Internal padding around children (tagged size).
  weight       Controls how the box itself stretches within its parent.
.endtable

.h3 Events

Containers use the common events only. No widget-specific events.
