gtk:widget, gobject:initially-unowned, gtk:accessible, gtk:buildable, gtk:constraint-target, gtk:orientable, gobject:object, common-lisp:standard-object, common-lisp:t

gtk:shortcuts-group, gtk:shortcuts-section

The gtk:box widget arranges child widgets into a single row or column.

Figure: GtkBox

Whether it is a row or column depends on the value of its orientation property. Within the other dimension, all children are allocated the same size. Of course, the halign and valign properties can be used on the children to influence their allocation.

Use repeated calls to the gtk:box-append function to pack widgets into a box from start to end. Use the gtk:box-remove function to remove widgets from the box. The gtk:box-insert-child-after function can be used to add a child widget at a particular position.

Use the gtk:box-homogeneous function to specify whether or not all children of the box are forced to get the same amount of space and the gtk:box-spacing function to determine how much space will be minimally placed between all children in the box. Note that spacing is added between the children.

Use the gtk:box-reorder-child-after function to move a child widget to a different place in the box. The gtk:box implementation uses a single CSS node with name box. Until GTK 4.10, the gtk:box implementation used the :group role of the gtk:accessible-role enumeration. Starting from GTK 4.12, the gtk:box implementation uses the :generic role.