Class
GtkCellRendererCombo
Description [src]
class Gtk.CellRendererCombo : Gtk.CellRendererText
{
/* No available fields */
}
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.
The GtkCellRendererCombo
cell renderer was added in GTK+ 2.6.
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
.
since: 2.6
Instance methods
Methods inherited from GtkCellRendererText (1)
Methods inherited from GtkCellRenderer (24)
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.
since: 2.6
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.
since: 2.6
Gtk.CellRendererCombo:text-column
Specifies the model column which holds the possible values for the combo box.
since: 2.6
Properties inherited from GtkCellRendererText (48)
Properties inherited from GtkCellRenderer (16)
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.
since: 2.14