:right-sidebar: True

CellAreaBox
===================================================================

.. currentmodule:: gi.repository.Gtk





.. deprecated:: 4.10

   List views use widgets for displaying their
   contents



.. class:: CellAreaBox(**properties: ~typing.Any)
   :no-contents-entry:


Superclasses: :class:`~gi.repository.Gtk.CellArea`, :class:`~gi.repository.GObject.InitiallyUnowned`, :class:`~gi.repository.GObject.Object`



Implemented Interfaces: :class:`~gi.repository.Gtk.Buildable`, :class:`~gi.repository.Gtk.CellLayout`, :class:`~gi.repository.Gtk.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 :const:`~gi.repository.Gtk.Orientation.VERTICAL`
orientation, the start is defined as the top of the box and the end is
defined as the bottom. In the :const:`~gi.repository.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 :func:`~gi.repository.Gtk.CellArea.cell_set_property` or by specifying the "align"
argument to :func:`~gi.repository.Gtk.CellAreaBox.pack_start` and :func:`~gi.repository.Gtk.CellAreaBox.pack_end`.



Constructors
------------

.. rst-class:: interim-class

.. class:: CellAreaBox
   :no-index:


   .. classmethod:: new() -> ~gi.repository.Gtk.CellArea

      Creates a new ``GtkCellAreaBox``.






      .. deprecated:: 4.10

         Please do not use it in newly written code











Methods
-------

.. rst-class:: interim-class

.. class:: CellAreaBox
   :no-index:


   .. method:: get_spacing() -> int

      Gets the spacing added between cell renderers.






      .. deprecated:: 4.10

         Please do not use it in newly written code







   .. method:: pack_end(renderer: ~gi.repository.Gtk.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:: 4.10

         Please do not use it in newly written code




      :param renderer: the ``GtkCellRenderer`` to add


      :param expand: whether ``renderer`` should receive extra space when the area receives
         more than its natural size


      :param align: whether ``renderer`` should be aligned in adjacent rows


      :param fixed: whether ``renderer`` should have the same size in all rows





   .. method:: pack_start(renderer: ~gi.repository.Gtk.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:: 4.10

         Please do not use it in newly written code




      :param renderer: the ``GtkCellRenderer`` to add


      :param expand: whether ``renderer`` should receive extra space when the area receives
         more than its natural size


      :param align: whether ``renderer`` should be aligned in adjacent rows


      :param fixed: whether ``renderer`` should have the same size in all rows





   .. method:: set_spacing(spacing: int) -> None

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






      .. deprecated:: 4.10

         Please do not use it in newly written code




      :param spacing: the space to add between ``GtkCellRenderer``'s









Properties
----------

.. rst-class:: interim-class

.. class:: CellAreaBox
   :no-index:
   

   .. attribute:: props.spacing
      :type: int

      The amount of space to reserve between cells.