### Class

# Gtk CellAreaBox

#### Description [src]

    final class Gtk.CellAreaBox : Gtk.CellArea {
      /* No available fields */
    }

A cell area that renders GtkCellRenderers into a row or a column

The `GtkCellAreaBox` renders cell renderers into a row or a column depending on its `GtkOrientation`.

GtkCellAreaBox uses a notion of packing. Packing refers to adding cell renderers with reference to a particular position in a `GtkCellAreaBox`. There are two reference positions: the start and the end of the box. When the `GtkCellAreaBox` is oriented in the `GTK_ORIENTATION_VERTICAL` orientation, the start is defined as the top of the box and the end is defined as the bottom. In the `GTK_ORIENTATION_HORIZONTAL` orientation start is defined as the left side and the end is defined as the right side.

Alignments of `GtkCellRenderer`s rendered in adjacent rows can be configured by configuring the `GtkCellAreaBox` align child cell property with gtk_cell_area_cell_set_property() or by specifying the “align” argument to gtk_cell_area_box_pack_start() and gtk_cell_area_box_pack_end().

#### Hierarchy

#### Ancestors

- GtkCellArea
- GInitiallyUnowned
- GObject

#### Implements

- GtkBuildable
- GtkCellLayout
- GtkOrientable

#### Constructors

###### gtk_cell_area_box_new

Creates a new `GtkCellAreaBox`.

#### Instance methods

###### gtk_cell_area_box_get_spacing

Gets the spacing added between cell renderers.

###### gtk_cell_area_box_pack_end

Adds `renderer` to `box`, packed with reference to the end of `box`.

###### gtk_cell_area_box_pack_start

Adds `renderer` to `box`, packed with reference to the start of `box`.

###### gtk_cell_area_box_set_spacing

Sets the spacing to add between cell renderers in `box`.

##### Methods inherited from GtkCellArea (44)

##### Methods inherited from GtkBuildable (1)

###### gtk_buildable_get_buildable_id

Gets the ID of the `buildable` object.

##### Methods inherited from GtkCellLayout (10)

###### gtk_cell_layout_add_attribute

Adds an attribute mapping to the list in `cell_layout`.

###### gtk_cell_layout_clear

Unsets all the mappings on all renderers on `cell_layout` and removes all renderers from `cell_layout`.

###### gtk_cell_layout_clear_attributes

Clears all existing attributes previously set with gtk_cell_layout_set_attributes().

###### gtk_cell_layout_get_area

Returns the underlying `GtkCellArea` which might be `cell_layout` if called on a `GtkCellArea` or might be `NULL` if no `GtkCellArea` is used by `cell_layout`.

###### gtk_cell_layout_get_cells

Returns the cell renderers which have been added to `cell_layout`.

###### gtk_cell_layout_pack_end

Adds the `cell` to the end of `cell_layout`. If `expand` is `FALSE`, then the `cell` is allocated no more space than it needs. Any unused space is divided evenly between cells for which `expand` is `TRUE`.

###### gtk_cell_layout_pack_start

Packs the `cell` into the beginning of `cell_layout`. If `expand` is `FALSE`, then the `cell` is allocated no more space than it needs. Any unused space is divided evenly between cells for which `expand` is `TRUE`.

###### gtk_cell_layout_reorder

Re-inserts `cell` at `position`.

###### gtk_cell_layout_set_attributes

Sets the attributes in the parameter list as the attributes of `cell_layout`.

###### gtk_cell_layout_set_cell_data_func

Sets the `GtkCellLayout`DataFunc to use for `cell_layout`.

##### Methods inherited from GtkOrientable (2)

###### gtk_orientable_get_orientation

Retrieves the orientation of the `orientable`.

###### gtk_orientable_set_orientation

Sets the orientation of the `orientable`.

#### Properties

###### Gtk.CellAreaBox:spacing

The amount of space to reserve between cells.

##### Properties inherited from GtkCellArea (3)

###### Gtk.CellArea:edit-widget

The widget currently editing the edited cell.

###### Gtk.CellArea:edited-cell

The cell in the area that is currently edited.

###### Gtk.CellArea:focus-cell

The cell in the area that currently has focus.

##### Properties inherited from GtkOrientable (1)

###### Gtk.Orientable:orientation

The orientation of the orientable.