Box

Object Hierarchy:

Description:

[ CCode ( type_id = "gtk_box_get_type ()" ) ]
public class Box : Widget, Accessible, Buildable, ConstraintTarget, Orientable

The `GtkBox` widget arranges child widgets into a single row or column.

![An example GtkBox](box.png)

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

Use repeated calls to [method@Gtk.Box.append] to pack widgets into a `GtkBox` from start to end. Use [method@Gtk.Box.remove] to remove widgets from the `GtkBox`. [method@Gtk.Box.insert_child_after] can be used to add a child at a particular position.

Use [method@Gtk.Box.set_homogeneous] to specify whether or not all children of the `GtkBox` are forced to get the same amount of space.

Use [method@Gtk.Box.set_spacing] to determine how much space will be minimally placed between all children in the `GtkBox`. Note that spacing is added *between* the children.

Use [method@Gtk.Box.reorder_child_after] to move a child to a different place in the box.

CSS nodes

`GtkBox` uses a single CSS node with name box.

Accessibility

Until GTK 4.10, `GtkBox` used the `GTK_ACCESSIBLE_ROLE_GROUP` role.

Starting from GTK 4.12, `GtkBox` uses the `GTK_ACCESSIBLE_ROLE_GENERIC` role.

All known sub-classes:

ShortcutsGroup

ShortcutsSection

Namespace: Gtk

Package: gtk4

Content:

Properties:

public int baseline_child { get; set; }
The child that determines the baseline, in vertical orientation.
public BaselinePosition baseline_position { get; set; }
The position of the baseline aligned widgets if extra space is available.
public bool homogeneous { get; set; }
Whether the children should all be the same size.
public int spacing { get; set; }
The amount of space between children.

Creation methods:

public Box (Orientation orientation, int spacing)
Creates a new `GtkBox`.

Methods:

public void append (Widget child)
Adds child as the last child to this .
public int get_baseline_child ()
Gets the value set by set_baseline_child.
public BaselinePosition get_baseline_position ()
Gets the value set by set_baseline_position.
public bool get_homogeneous ()
Returns whether the box is homogeneous (all children are the same size).
public int get_spacing ()
Gets the value set by set_spacing.
public void insert_child_after (Widget child, Widget? sibling)
Inserts child in the position after sibling in the list of this children.
public void prepend (Widget child)
Adds child as the first child to this.
public void remove (Widget child)
Removes a child widget from this.
public void reorder_child_after (Widget child, Widget? sibling)
Moves child to the position after sibling in the list of this children.
public void set_baseline_child (int child)
Sets the baseline child of a box.
public void set_baseline_position (BaselinePosition position)
Sets the baseline position of a box.
public void set_homogeneous (bool homogeneous)
Sets whether or not all children of this are given equal space in the box.
public void set_spacing (int spacing)
Sets the number of pixels to place between children of this.

Inherited Members:

All known members inherited from class Gtk.Widget

All known members inherited from class GLib.Object

All known members inherited from interface Gtk.Accessible

All known members inherited from interface Gtk.Buildable

All known members inherited from interface Gtk.Orientable

get_orientation

orientation

set_orientation