Gtk.CellAreaBox
Description: Reference for Gtk.CellAreaBox

### Class

# GtkCellAreaBox

deprecated: 4.10

#### Description [src]

    final class Gtk.CellAreaBox : Gtk.CellArea
      implements Gtk.Buildable, Gtk.CellLayout, Gtk.Orientable {
      /* 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().

Deprecated since: 4.10

List views use widgets for displaying their contents.

#### Ancestors

- GtkCellArea
- GInitiallyUnowned
- GObject

#### Implements

- GtkBuildable
- GtkCellLayout
- GtkOrientable

#### Constructors

###### gtk_cell_area_box_new

Creates a new `GtkCellAreaBox`.

deprecated: 4.10

#### Instance methods

###### gtk_cell_area_box_get_spacing

Gets the spacing added between cell renderers.

deprecated: 4.10

###### gtk_cell_area_box_pack_end

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

deprecated: 4.10

###### gtk_cell_area_box_pack_start

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

deprecated: 4.10

###### gtk_cell_area_box_set_spacing

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

deprecated: 4.10

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

Please see GtkCellArea for a full list of methods.

##### Methods inherited from GObject (43)

Please see GObject for a full list of methods.

##### 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`.

deprecated: 4.10

###### gtk_cell_layout_clear

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

deprecated: 4.10

###### gtk_cell_layout_clear_attributes

Clears all existing attributes previously set with gtk_cell_layout_set_attributes().

deprecated: 4.10

###### 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`.

deprecated: 4.10

###### gtk_cell_layout_get_cells

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

deprecated: 4.10

###### 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`.

deprecated: 4.10

###### 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`.

deprecated: 4.10

###### gtk_cell_layout_reorder

Re-inserts `cell` at `position`.

deprecated: 4.10

###### gtk_cell_layout_set_attributes

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

deprecated: 4.10

###### gtk_cell_layout_set_cell_data_func

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

deprecated: 4.10

##### 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)

###### GtkOrientable:orientation

The orientation of the orientable.

#### Signals

##### Signals inherited from GtkCellArea (4)

###### GtkCellArea::add-editable

Indicates that editing has started on `renderer` and that `editable` should be added to the owning cell-layouting widget at `cell_area`.

###### GtkCellArea::apply-attributes

This signal is emitted whenever applying attributes to `area` from `model`.

###### GtkCellArea::focus-changed

Indicates that focus changed on this `area`. This signal is emitted either as a result of focus handling or event handling.

###### GtkCellArea::remove-editable

Indicates that editing finished on `renderer` and that `editable` should be removed from the owning cell-layouting widget.

##### Signals inherited from GObject (1)

###### GObject::notify

The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.