CellAreaBox

Deprecated since version 4.10: List views use widgets for displaying their contents

class CellAreaBox(**properties: Any)

Superclasses: CellArea, InitiallyUnowned, Object

Implemented Interfaces: Buildable, CellLayout, Orientable

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 VERTICAL orientation, the start is defined as the top of the box and the end is defined as the bottom. In the 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 cell_set_property() or by specifying the “align” argument to pack_start() and pack_end().

Constructors

class CellAreaBox
classmethod new() CellArea

Creates a new GtkCellAreaBox.

Deprecated since version 4.10: Please do not use it in newly written code

Methods

class CellAreaBox
get_spacing() int

Gets the spacing added between cell renderers.

Deprecated since version 4.10: Please do not use it in newly written code

pack_end(renderer: CellRenderer, expand: bool, align: bool, fixed: bool) None

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

The renderer is packed after (away from end of) any other GtkCellRenderer packed with reference to the end of box.

Deprecated since version 4.10: Please do not use it in newly written code

Parameters:
  • renderer – the GtkCellRenderer to add

  • expand – whether renderer should receive extra space when the area receives more than its natural size

  • align – whether renderer should be aligned in adjacent rows

  • fixed – whether renderer should have the same size in all rows

pack_start(renderer: CellRenderer, expand: bool, align: bool, fixed: bool) None

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

The renderer is packed after any other GtkCellRenderer packed with reference to the start of box.

Deprecated since version 4.10: Please do not use it in newly written code

Parameters:
  • renderer – the GtkCellRenderer to add

  • expand – whether renderer should receive extra space when the area receives more than its natural size

  • align – whether renderer should be aligned in adjacent rows

  • fixed – whether renderer should have the same size in all rows

set_spacing(spacing: int) None

Sets the spacing to add between cell renderers in box.

Deprecated since version 4.10: Please do not use it in newly written code

Parameters:

spacing – the space to add between GtkCellRenderer’s

Properties

class CellAreaBox
props.spacing: int

The amount of space to reserve between cells.