Box

Object Hierarchy:

Description:

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

Arranges child widgets into a single row or column.

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. 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 [enum@Gtk.AccessibleRole.group] role.

Starting from GTK 4.12, `GtkBox` uses the [enum@Gtk.AccessibleRole.generic] role.

All known sub-classes:

ShortcutsGroup

ShortcutsSection

Namespace: Gtk

Package: gtk4

Content:

Properties:

public int baseline_child { get; set; }
The position of the child that determines the baseline.
public BaselinePosition baseline_position { get; set; }
How to position 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 box.

Methods:

public void append (Widget child)
Adds a child at the end.
public int get_baseline_child ()
Gets the value set by [method@Gtk.
public BaselinePosition get_baseline_position ()
Gets the value set by [method@Gtk.
public bool get_homogeneous ()
Returns whether the box is homogeneous.
public int get_spacing ()
Gets the value set by [method@Gtk.
public void insert_child_after (Widget child, Widget? sibling)
Inserts a child at a specific position.
public void prepend (Widget child)
Adds a child at the beginning.
public void remove (Widget child)
Removes a child widget from the box.
public void reorder_child_after (Widget child, Widget? sibling)
Moves a child to a different position.
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 are given equal space in the box.
public void set_spacing (int spacing)
Sets the number of pixels to place between children.

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