g Atk.ImplementorIface Atk.ImplementorIface Gtk.Widget Gtk.Widget Atk.ImplementorIface->Gtk.Widget GObject.GInterface GObject.GInterface GObject.GInterface->Atk.ImplementorIface Gtk.Buildable Gtk.Buildable GObject.GInterface->Gtk.Buildable Gtk.Orientable Gtk.Orientable GObject.GInterface->Gtk.Orientable GObject.InitiallyUnowned GObject.InitiallyUnowned GObject.InitiallyUnowned->Gtk.Widget GObject.Object GObject.Object GObject.Object->GObject.InitiallyUnowned Gtk.Box Gtk.Box Gtk.VBox Gtk.VBox Gtk.Box->Gtk.VBox Gtk.Buildable->Gtk.Widget Gtk.Container Gtk.Container Gtk.Container->Gtk.Box Gtk.Orientable->Gtk.Box Gtk.Widget->Gtk.Container


Child Properties

Inherited:Gtk.Box (5)

Style Properties

Inherited:Gtk.Widget (17)


Inherited:Gtk.Container (4), Gtk.Widget (69), GObject.Object (1)
Name Type Access Description
box Gtk.Box r  

Class Details

class Gtk.VBox(*args, **kwargs)

A Gtk.VBox is a container that organizes child widgets into a single column.

Use the Gtk.Box packing interface to determine the arrangement, spacing, height, and alignment of Gtk.VBox children.

All children are allocated the same width.

Gtk.VBox has been deprecated. You can use Gtk.Box with a Gtk.Orientable :orientation set to Gtk.Orientation.VERTICAL instead when calling, which is a very quick and easy change.

If you have derived your own classes from Gtk.VBox, you can change the inheritance to derive directly from Gtk.Box, and set the Gtk.Orientable :orientation property to Gtk.Orientation.VERTICAL in your instance init function, with a call like:

gtk_orientable_set_orientation (GTK_ORIENTABLE (object),

If you have a grid-like layout composed of nested boxes, and you don’t need first-child or last-child styling, the recommendation is to switch to Gtk.Grid. For more information about migrating to Gtk.Grid, see Migrating from other containers to GtkGrid.

classmethod new(homogeneous, spacing)[source]
  • homogeneous (bool) – True if all children are to be given equal space allotments.
  • spacing (int) – the number of pixels to place by default between children.

a new Gtk.VBox.

Return type:


Creates a new Gtk.VBox.

Deprecated since version 3.2: You can use with Gtk.Orientation.VERTICAL instead, which is a quick and easy change. But the recommendation is to switch to Gtk.Grid, since Gtk.Box is going to go away eventually. See Migrating from other containers to GtkGrid.