Back to Seed Clases







Class Gtk.ComboBox

Import line: Gtk =;
GIR File: Gtk-3.0.gir
C documentation: GtkComboBox
Class : ComboBox
Implements: Atk.ImplementorIface, Gtk.Buildable, Gtk.CellEditable, Gtk.CellLayout
Subclasses: GWeather.TimezoneMenu, Gtk.AppChooserButton
Extends: Gtk.Bin
A GtkComboBox is a widget that allows the user to choose from a list of
valid choices. The GtkComboBox displays the selected choice. When
activated, the GtkComboBox displays a popup which allows the user to
make a new choice. The style in which the selected value is displayed,
and the style of the popup is determined by the current theme. It may
be similar to a Windows-style combo box.
The GtkComboBox uses the model-view pattern; the list of valid choices
is specified in the form of a tree model, and the display of the choices
can be adapted to the data in the model by using cell renderers, as you
would in a tree view. This is possible since GtkComboBox implements the
GtkCellLayout interface. The tree model holding the valid choices is
not restricted to a flat list, it can be a real tree, and the popup will
reflect the tree structure.
To allow the user to enter values not in the model, the 'has-entry'
property allows the GtkComboBox to contain a GtkEntry. This entry
can be accessed by calling gtk_bin_get_child() on the combo box.
For a simple list of textual choices, the model-view API of GtkComboBox
can be a bit overwhelming. In this case, GtkComboBoxText offers a
simple alternative. Both GtkComboBox and GtkComboBoxText can contain
an entry.
Properties Defined By
Methods / Constructors
Method / Constructor Defined By
new Gtk.ComboBox.with_entry () : Gtk.Widget
Create a new Gtk.ComboBox
Create a new Gtk.ComboBox
Gtk.Widget A new GtkComboBox.
Events - usage syntax: this.signals.EVENTNAME.connect( Function )
Event Defined By
Used by These Methods / Signals / Properties- Nowhere other than here
Documentation generated by Introspection Doc Generator Loosely Based on JsDoc Toolkit on Sat Apr 16 2011 17:12:26 GMT+0800 (HKT)