Box

class Box(**properties: Any)

Superclasses: Widget, InitiallyUnowned, Object

Subclasses: ShortcutsGroup, ShortcutsSection

Implemented Interfaces: Accessible, Buildable, ConstraintTarget, Orientable

Constructors:

Box(**properties)
new(orientation:Gtk.Orientation, spacing:int) -> Gtk.Widget

Constructors

class Box

classmethod new(orientation: Orientation, spacing: int) → Widget

Creates a new GtkBox.

Parameters:

• orientation – the box’s orientation

• spacing – the number of pixels to place by default between children

Methods

class Box

append(child: Widget) → None

Adds child as the last child to box.

Parameters:

child – the GtkWidget to append

get_baseline_child() → int

Gets the value set by set_baseline_child().

Added in version 4.12.

get_baseline_position() → BaselinePosition

Gets the value set by set_baseline_position().

get_homogeneous() → bool

Returns whether the box is homogeneous (all children are the same size).

get_spacing() → int

Gets the value set by set_spacing().

insert_child_after(child: Widget, sibling: Widget | None = None) → None

Inserts child in the position after sibling in the list of box children.

If sibling is None, insert child at the first position.

Parameters:

• child – the GtkWidget to insert

• sibling – the sibling after which to insert child

prepend(child: Widget) → None

Adds child as the first child to box.

Parameters:

child – the GtkWidget to prepend

remove(child: Widget) → None

Removes a child widget from box.

The child must have been added before with append, prepend, or insert_child_after.

Parameters:

child – the child to remove

reorder_child_after(child: Widget, sibling: Widget | None = None) → None

Moves child to the position after sibling in the list of box children.

If sibling is None, move child to the first position.

Parameters:

• child – the GtkWidget to move, must be a child of box

• sibling – the sibling to move child after

set_baseline_child(child: int) → None

Sets the baseline child of a box.

This affects only vertical boxes.

Added in version 4.12.

Parameters:

child – a child, or -1

set_baseline_position(position: BaselinePosition) → None

Sets the baseline position of a box.

This affects only horizontal boxes with at least one baseline aligned child. If there is more vertical space available than requested, and the baseline is not allocated by the parent then position is used to allocate the baseline with respect to the extra space available.

Parameters:

position – a GtkBaselinePosition

set_homogeneous(homogeneous: bool) → None

Sets whether or not all children of box are given equal space in the box.

Parameters:

homogeneous – a boolean value, True to create equal allotments, False for variable allotments

set_spacing(spacing: int) → None

Sets the number of pixels to place between children of box.

Parameters:

spacing – the number of pixels to put between children

Properties

class Box

props.baseline_child: int

The child that determines the baseline, in vertical orientation.

Added in version 4.12.

props.baseline_position: BaselinePosition

The position of the baseline aligned widgets if extra space is available.

props.homogeneous: bool

Whether the children should all be the same size.

props.spacing: int

The amount of space between children.

Fields

class Box

parent_instance