:right-sidebar: True

CellRendererCombo
===================================================================

.. currentmodule:: gi.repository.Gtk





.. deprecated:: 4.10

   List views use widgets to display their contents. You
     should use :obj:`~gi.repository.Gtk.DropDown` instead


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


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





Renders a combobox in a cell

``GtkCellRendererCombo`` renders text in a cell like ``GtkCellRendererText`` from
which it is derived. But while ``GtkCellRendererText`` offers a simple entry to
edit the text, ``GtkCellRendererCombo`` offers a ``GtkComboBox``
widget to edit the text. The values to display in the combo box are taken from
the tree model specified in the ``GtkCellRendererCombo``\:model property.

The combo cell renderer takes care of adding a text cell renderer to the combo
box and sets it to display the column specified by its
``GtkCellRendererCombo``\:text-column property. Further properties of the combo box
can be set in a handler for the ``GtkCellRenderer::editing-started`` signal.


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

.. rst-class:: interim-class

.. class:: CellRendererCombo
   :no-index:


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

      Creates a new ``GtkCellRendererCombo``\.
      Adjust how text is drawn using object properties.
      Object properties can be set globally (with :func:`~gi.repository.GObject.GObject.Object.set`).
      Also, with ``GtkTreeViewColumn``\, you can bind a property to a value
      in a ``GtkTreeModel``\. For example, you can bind the “text” property
      on the cell renderer to a string value in the model, thus rendering
      a different string in each row of the ``GtkTreeView``\.





      .. deprecated:: 4.10

         Please do not use it in newly written code












Properties
----------

.. rst-class:: interim-class

.. class:: CellRendererCombo
   :no-index:
   

   .. attribute:: props.has_entry
      :type: bool

      The type of the None singleton.







   .. attribute:: props.model
      :type: ~gi.repository.Gtk.TreeModel

      The type of the None singleton.







   .. attribute:: props.text_column
      :type: int

      The type of the None singleton.











Signals
-------

.. rst-class:: interim-class

.. class:: CellRendererCombo.signals
   :no-index:
   

   .. method:: changed(path_string: str, new_iter: ~gi.repository.Gtk.TreeIter) -> None

      The type of the None singleton.







      :param path_string: a string of the path identifying the edited cell
                       (relative to the tree view model)

      :param new_iter: the new iter selected in the combo box
                    (relative to the combo box model)