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 [[email protected]:orientation] property. Within the other dimension, all children are allocated the same size. The [[email protected]:halign] and [[email protected]:valign] properties can be used on the children to influence their allocation.

Use repeated calls to [[email protected]] to pack widgets into a `GtkBox` from start to end. Use [[email protected]] to remove widgets from the `GtkBox`. [[email protected]_child_after] can be used to add a child at a particular position.

Use [[email protected]_homogeneous] to specify whether or not all children of the `GtkBox` are forced to get the same amount of space.

Use [[email protected]_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 [[email protected]_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 [[email protected]] role.

Starting from GTK 4.12, `GtkBox` uses the [[email protected]] 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