Gtk.CellAreaBox

g GObject.GInterface GObject.GInterface Gtk.Buildable Gtk.Buildable GObject.GInterface->Gtk.Buildable Gtk.CellLayout Gtk.CellLayout GObject.GInterface->Gtk.CellLayout Gtk.Orientable Gtk.Orientable GObject.GInterface->Gtk.Orientable GObject.InitiallyUnowned GObject.InitiallyUnowned Gtk.CellArea Gtk.CellArea GObject.InitiallyUnowned->Gtk.CellArea GObject.Object GObject.Object GObject.Object->GObject.InitiallyUnowned Gtk.Buildable->Gtk.CellArea Gtk.CellAreaBox Gtk.CellAreaBox Gtk.CellArea->Gtk.CellAreaBox Gtk.CellLayout->Gtk.CellArea Gtk.Orientable->Gtk.CellAreaBox

Subclasses:None

Methods

Inherited:Gtk.CellArea (42), GObject.Object (37), Gtk.Buildable (10), Gtk.CellLayout (9), Gtk.Orientable (2)
Structs:Gtk.CellAreaClass (3), GObject.ObjectClass (5)
class new ()
  get_spacing ()
  pack_end (renderer, expand, align, fixed)
  pack_start (renderer, expand, align, fixed)
  set_spacing (spacing)

Properties

Inherited:Gtk.CellArea (3), Gtk.Orientable (1)
Name Type Flags Short Description
spacing int r/w/en Space which is inserted between cells

Fields

Inherited:Gtk.CellArea (4), GObject.Object (1)
Name Type Access Description
parent_instance Gtk.CellArea r  
priv Gtk.CellAreaBoxPrivate r  

Class Details

class Gtk.CellAreaBox(**kwargs)
Bases:Gtk.CellArea, Gtk.Orientable
Abstract:No
Structure:Gtk.CellAreaBoxClass

The Gtk.CellAreaBox renders cell renderers into a row or a column depending on its Gtk.Orientation.

Gtk.CellAreaBox uses a notion of packing. Packing refers to adding cell renderers with reference to a particular position in a Gtk.CellAreaBox. There are two reference positions: the start and the end of the box. When the Gtk.CellAreaBox 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 Gtk.CellRenderers rendered in adjacent rows can be configured by configuring the Gtk.CellAreaBox align child cell property with Gtk.CellArea.cell_set_property() or by specifying the “align” argument to Gtk.CellAreaBox.pack_start() and Gtk.CellAreaBox.pack_end().

classmethod new()[source]
Returns:a newly created Gtk.CellAreaBox
Return type:Gtk.CellArea

Creates a new Gtk.CellAreaBox.

New in version 3.0.

get_spacing()[source]
Returns:the space added between cell renderers in self.
Return type:int

Gets the spacing added between cell renderers.

New in version 3.0.

pack_end(renderer, expand, align, fixed)[source]
Parameters:
  • renderer (Gtk.CellRenderer) – the Gtk.CellRenderer to add
  • expand (bool) – whether renderer should receive extra space when the area receives more than its natural size
  • align (bool) – whether renderer should be aligned in adjacent rows
  • fixed (bool) – whether renderer should have the same size in all rows

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

The renderer is packed after (away from end of) any other Gtk.CellRenderer packed with reference to the end of self.

New in version 3.0.

pack_start(renderer, expand, align, fixed)[source]
Parameters:
  • renderer (Gtk.CellRenderer) – the Gtk.CellRenderer to add
  • expand (bool) – whether renderer should receive extra space when the area receives more than its natural size
  • align (bool) – whether renderer should be aligned in adjacent rows
  • fixed (bool) – whether renderer should have the same size in all rows

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

The renderer is packed after any other Gtk.CellRenderer packed with reference to the start of self.

New in version 3.0.

set_spacing(spacing)[source]
Parameters:spacing (int) – the space to add between Gtk.CellRenderers

Sets the spacing to add between cell renderers in self.

New in version 3.0.

Property Details

Gtk.CellAreaBox.props.spacing
Name:spacing
Type:int
Default Value:0
Flags:READABLE, WRITABLE, EXPLICIT_NOTIFY

The amount of space to reserve between cells.

New in version 3.0.