gtk_box_pack_start ()

void
gtk_box_pack_start (GtkBox *box,
                    GtkWidget *child,
                    gboolean expand,
                    gboolean fill,
                    guint padding);

Adds child to box , packed with reference to the start of box . The child is packed after any other child packed with reference to the start of box .

gtk_box_pack_end ()

void
gtk_box_pack_end (GtkBox *box,
                  GtkWidget *child,
                  gboolean expand,
                  gboolean fill,
                  guint padding);

Adds child to box , packed with reference to the end of box . The child is packed after (away from end of) any other child packed with reference to the end of box .

gtk_box_pack_start_defaults ()

void
gtk_box_pack_start_defaults (GtkBox *box,
                             GtkWidget *widget);

Adds widget to box , packed with reference to the start of box . The child is packed after any other child packed with reference to the start of box .

Parameters for how to pack the child widget , “expand”, “fill” and “padding”, are given their default values, TRUE, TRUE, and 0, respectively.

gtk_box_pack_end_defaults ()

void
gtk_box_pack_end_defaults (GtkBox *box,
                           GtkWidget *widget);

Adds widget to box , packed with reference to the end of box . The child is packed after any other child packed with reference to the start of box .

Parameters for how to pack the child widget , “expand”, “fill” and “padding”, are given their default values, TRUE, TRUE, and 0, respectively.

gtk_box_get_homogeneous ()

gboolean
gtk_box_get_homogeneous (GtkBox *box);

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

gtk_box_set_homogeneous ()

void
gtk_box_set_homogeneous (GtkBox *box,
                         gboolean homogeneous);

Sets the “homogeneous” property of box , controlling whether or not all children of box are given equal space in the box.

gtk_box_get_spacing ()

gint
gtk_box_get_spacing (GtkBox *box);

Gets the value set by gtk_box_set_spacing().

gtk_box_set_spacing ()

void
gtk_box_set_spacing (GtkBox *box,
                     gint spacing);

Sets the “spacing” property of box , which is the number of pixels to place between children of box .

gtk_box_reorder_child ()

void
gtk_box_reorder_child (GtkBox *box,
                       GtkWidget *child,
                       gint position);

Moves child to a new position in the list of box children. The list is the children field of GtkBox, and contains both widgets packed GTK_PACK_START as well as widgets packed GTK_PACK_END, in the order that these widgets were added to box .

A widget's position in the box children list determines where the widget is packed into box . A child widget at some position in the list will be packed just after all other widgets of the same packing type that appear earlier in the list.

gtk_box_query_child_packing ()

void
gtk_box_query_child_packing (GtkBox *box,
                             GtkWidget *child,
                             gboolean *expand,
                             gboolean *fill,
                             guint *padding,
                             GtkPackType *pack_type);

Obtains information about how child is packed into box .

gtk_box_set_child_packing ()

void
gtk_box_set_child_packing (GtkBox *box,
                           GtkWidget *child,
                           gboolean expand,
                           gboolean fill,
                           guint padding,
                           GtkPackType pack_type);

Sets the way child is packed into box .

struct GtkBox

struct GtkBox {
  GList *GSEAL (children);
  gint16 GSEAL (spacing);
  guint GSEAL (homogeneous) : 1;
};

The GtkBox describes an instance of GtkBox and contains the following fields. (These fields should be considered read-only. They should never be set by an application.)

struct GtkBoxChild

struct GtkBoxChild {
  GtkWidget *widget;
  guint16 padding;
  guint expand : 1;
  guint fill : 1;
  guint pack : 1;
  guint is_secondary : 1;
};

The GtkBoxChild holds a child widget of GtkBox and describes how the child is to be packed into the GtkBox. All fields of this GtkBoxChild should be considered read-only and they should never be set directly by an application. Use gtk_box_query_child_packing() and gtk_box_set_child_packing() to query and set the GtkBoxChild.padding, GtkBoxChild.expand, GtkBoxChild.fill and GtkBoxChild.pack fields.

The GtkBoxChild holds a child widget of GtkBox and describes how the child is to be packed into the GtkBox. Use gtk_box_query_child_packing() and gtk_box_set_child_packing() to query and reset the padding, expand, fill, and pack fields.

GtkBoxChild contains the following fields. (These fields should be considered read-only. They should never be directly set by an application.)

The “homogeneous” property

  “homogeneous”              gboolean

Whether the children should all be the same size.

Flags: Read / Write

Default value: FALSE

The “spacing” property

  “spacing”                  gint

The amount of space between children.

Flags: Read / Write

Allowed values: >= 0

Default value: 0

The “expand” child property

  “expand”                   gboolean

Whether the child should receive extra space when the parent grows.

Flags: Read / Write

Default value: TRUE

The “fill” child property

  “fill”                     gboolean

Whether extra space given to the child should be allocated to the child or used as padding.

Flags: Read / Write

Default value: TRUE

The “pack-type” child property

  “pack-type”                GtkPackType

A GtkPackType indicating whether the child is packed with reference to the start or end of the parent.

Flags: Read / Write

Default value: GTK_PACK_START

The “padding” child property

  “padding”                  guint

Extra space to put between the child and its neighbors, in pixels.

Flags: Read / Write

Allowed values: <= G_MAXINT

Default value: 0

The “position” child property

  “position”                 gint

The index of the child in the parent.

Flags: Read / Write

Allowed values: >= -1

Default value: 0