### Class

# Gtk CellRendererCombo

deprecated: 4.10

#### Description [src]

    final class Gtk.CellRendererCombo : Gtk.CellRendererText
    {
      /* No available fields */
    }

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.

Deprecated since: 4.10

List views use widgets to display their contents. You should use `GtkDropDown` instead.

#### Ancestors

- GtkCellRendererText
- GtkCellRenderer
- GInitiallyUnowned
- GObject

#### Constructors

###### gtk_cell_renderer_combo_new

Creates a new `GtkCellRendererCombo`. Adjust how text is drawn using object properties. Object properties can be set globally (with g_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

#### Instance methods

##### Methods inherited from GtkCellRendererText (1)

###### gtk_cell_renderer_text_set_fixed_height_from_font

Sets the height of a renderer to explicitly be determined by the “font” and “y_pad” property set on it. Further changes in these properties do not affect the height, so they must be accompanied by a subsequent call to this function. Using this function is inflexible, and should really only be used if calculating the size of a cell is too slow (ie, a massive number of cells displayed). If `number_of_rows` is -1, then the fixed height is unset, and the height is determined by the properties again.

deprecated: 4.10

##### Methods inherited from GtkCellRenderer (27)

Please see GtkCellRenderer for a full list of methods.

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

Please see GObject for a full list of methods.

#### Properties

###### Gtk.CellRendererCombo:has-entry

If `TRUE`, the cell renderer will include an entry and allow to enter values other than the ones in the popup list.

###### Gtk.CellRendererCombo:model

Holds a tree model containing the possible values for the combo box. Use the text_column property to specify the column holding the values.

###### Gtk.CellRendererCombo:text-column

Specifies the model column which holds the possible values for the combo box.

##### Properties inherited from GtkCellRendererText (46)

###### Gtk.CellRendererText:align-set

No description available.

###### Gtk.CellRendererText:alignment

Specifies how to align the lines of text with respect to each other.

###### Gtk.CellRendererText:attributes

No description available.

###### Gtk.CellRendererText:background

No description available.

###### Gtk.CellRendererText:background-rgba

Background color as a `GdkRGBA`.

###### Gtk.CellRendererText:background-set

No description available.

###### Gtk.CellRendererText:editable

No description available.

###### Gtk.CellRendererText:editable-set

No description available.

###### Gtk.CellRendererText:ellipsize

Specifies the preferred place to ellipsize the string, if the cell renderer does not have enough room to display the entire string. Setting it to `PANGO_ELLIPSIZE_NONE` turns off ellipsizing. See the wrap-width property for another way of making the text fit into a given width.

###### Gtk.CellRendererText:ellipsize-set

No description available.

###### Gtk.CellRendererText:family

No description available.

###### Gtk.CellRendererText:family-set

No description available.

###### Gtk.CellRendererText:font

No description available.

###### Gtk.CellRendererText:font-desc

No description available.

###### Gtk.CellRendererText:foreground

No description available.

###### Gtk.CellRendererText:foreground-rgba

Foreground color as a `GdkRGBA`.

###### Gtk.CellRendererText:foreground-set

No description available.

###### Gtk.CellRendererText:language

No description available.

###### Gtk.CellRendererText:language-set

No description available.

###### Gtk.CellRendererText:markup

No description available.

###### Gtk.CellRendererText:max-width-chars

The desired maximum width of the cell, in characters. If this property is set to -1, the width will be calculated automatically.

###### Gtk.CellRendererText:placeholder-text

The text that will be displayed in the `GtkCellRenderer` if `GtkCellRendererText:editable` is `TRUE` and the cell is empty.

###### Gtk.CellRendererText:rise

No description available.

###### Gtk.CellRendererText:rise-set

No description available.

###### Gtk.CellRendererText:scale

No description available.

###### Gtk.CellRendererText:scale-set

No description available.

###### Gtk.CellRendererText:single-paragraph-mode

No description available.

###### Gtk.CellRendererText:size

No description available.

###### Gtk.CellRendererText:size-points

No description available.

###### Gtk.CellRendererText:size-set

No description available.

###### Gtk.CellRendererText:stretch

No description available.

###### Gtk.CellRendererText:stretch-set

No description available.

###### Gtk.CellRendererText:strikethrough

No description available.

###### Gtk.CellRendererText:strikethrough-set

No description available.

###### Gtk.CellRendererText:style

No description available.

###### Gtk.CellRendererText:style-set

No description available.

###### Gtk.CellRendererText:text

No description available.

###### Gtk.CellRendererText:underline

No description available.

###### Gtk.CellRendererText:underline-set

No description available.

###### Gtk.CellRendererText:variant

No description available.

###### Gtk.CellRendererText:variant-set

No description available.

###### Gtk.CellRendererText:weight

No description available.

###### Gtk.CellRendererText:weight-set

No description available.

###### Gtk.CellRendererText:width-chars

The desired width of the cell, in characters. If this property is set to -1, the width will be calculated automatically, otherwise the cell will request either 3 characters or the property value, whichever is greater.

###### Gtk.CellRendererText:wrap-mode

Specifies how to break the string into multiple lines, if the cell renderer does not have enough room to display the entire string. This property has no effect unless the wrap-width property is set.

###### Gtk.CellRendererText:wrap-width

Specifies the minimum width at which the text is wrapped. The wrap-mode property can be used to influence at what character positions the line breaks can be placed. Setting wrap-width to -1 turns wrapping off.

##### Properties inherited from GtkCellRenderer (15)

###### Gtk.CellRenderer:cell-background

No description available.

###### Gtk.CellRenderer:cell-background-rgba

Cell background as a `GdkRGBA`.

###### Gtk.CellRenderer:cell-background-set

No description available.

###### Gtk.CellRenderer:editing

No description available.

###### Gtk.CellRenderer:height

No description available.

###### Gtk.CellRenderer:is-expanded

No description available.

###### Gtk.CellRenderer:is-expander

No description available.

###### Gtk.CellRenderer:mode

No description available.

###### Gtk.CellRenderer:sensitive

No description available.

###### Gtk.CellRenderer:visible

No description available.

###### Gtk.CellRenderer:width

No description available.

###### Gtk.CellRenderer:xalign

No description available.

###### Gtk.CellRenderer:xpad

No description available.

###### Gtk.CellRenderer:yalign

No description available.

###### Gtk.CellRenderer:ypad

No description available.

#### Signals

###### Gtk.CellRendererCombo::changed

This signal is emitted each time after the user selected an item in the combo box, either by using the mouse or the arrow keys. Contrary to GtkComboBox, GtkCellRendererCombo::changed is not emitted for changes made to a selected item in the entry. The argument `new_iter` corresponds to the newly selected item in the combo box and it is relative to the GtkTreeModel set via the model property on GtkCellRendererCombo.

##### Signals inherited from GtkCellRendererText (1)

###### GtkCellRendererText::edited

This signal is emitted after `renderer` has been edited.

##### Signals inherited from GtkCellRenderer (2)

###### GtkCellRenderer::editing-canceled

This signal gets emitted when the user cancels the process of editing a cell. For example, an editable cell renderer could be written to cancel editing when the user presses Escape.

###### GtkCellRenderer::editing-started

This signal gets emitted when a cell starts to be edited. The intended use of this signal is to do special setup on `editable`, e.g. adding a `GtkEntryCompletion` or setting up additional columns in a `GtkComboBox`.

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