RGtk2 (version 2.20.31)

GtkCellRendererCombo: GtkCellRendererCombo

Description

Renders a combobox in a cell

Arguments

Methods and Functions

gtkCellRendererComboNew() gtkCellRendererCombo()

Hierarchy

GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkCellRenderer
                     +----GtkCellRendererText
                           +----GtkCellRendererCombo

Detailed Description

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 or GtkComboBoxEntry widget to edit the text. The values to display in the combo box are taken from the tree model specified in the 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 text-column property. Further properties of the comnbo box can be set in a handler for the editing-started signal. The GtkCellRendererCombo cell renderer was added in GTK+ 2.6.

Structures

Convenient Construction

gtkCellRendererCombo is the equivalent of gtkCellRendererComboNew.

Signals

Properties

has-entry [logical : Read / Write]
If TRUE, the cell renderer will include an entry and allow to enter values other than the ones in the popup list. Default value: TRUE Since 2.6
model [GtkTreeModel : * : Read / Write]
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
text-column [integer : Read / Write]
Specifies the model column which holds the possible values for the combo box. Note that this refers to the model specified in the model property, not the model backing the tree view to which this cell renderer is attached. GtkCellRendererCombo automatically adds a text cell renderer for this column to its combo box. Allowed values: >= -1 Default value: -1 Since 2.6

References

http://library.gnome.org/devel//gtk/GtkCellRendererCombo.html