Description
A widget used to choose from a list of itemsMethods and Functions
gtkComboBoxNew(show = TRUE)
gtkComboBoxNewWithModel(model, show = TRUE)
gtkComboBoxGetWrapWidth(object)
gtkComboBoxSetWrapWidth(object, width)
gtkComboBoxGetRowSpanColumn(object)
gtkComboBoxSetRowSpanColumn(object, row.span)
gtkComboBoxGetColumnSpanColumn(object)
gtkComboBoxSetColumnSpanColumn(object, column.span)
gtkComboBoxGetActive(object)
gtkComboBoxSetActive(object, index)
gtkComboBoxGetActiveIter(object)
gtkComboBoxSetActiveIter(object, iter)
gtkComboBoxGetModel(object)
gtkComboBoxSetModel(object, model = NULL)
gtkComboBoxNewText()
gtkComboBoxAppendText(object, text)
gtkComboBoxInsertText(object, position, text)
gtkComboBoxPrependText(object, text)
gtkComboBoxRemoveText(object, position)
gtkComboBoxGetActiveText(object)
gtkComboBoxPopup(object)
gtkComboBoxPopdown(object)
gtkComboBoxGetPopupAccessible(object)
gtkComboBoxGetRowSeparatorFunc(object)
gtkComboBoxSetRowSeparatorFunc(object, func, data = NULL)
gtkComboBoxSetAddTearoffs(object, add.tearoffs)
gtkComboBoxGetAddTearoffs(object)
gtkComboBoxSetFocusOnClick(object, focus.on.click)
gtkComboBoxGetFocusOnClick(object)
gtkComboBox(model, show = TRUE)
Hierarchy
\link{GObject}
+----\link{GtkObject}
+----\link{GtkWidget}
+----\link{GtkContainer}
+----\link{GtkBin}
+----GtkComboBox
+----\link{GtkComboBoxEntry}Detailed Description
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 GtkOptionMenu
,
or similar to a Windows-style combo box.
Unlike its predecessors GtkCombo
and GtkOptionMenu
, 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.
In addition to the model-view API, GtkComboBox
offers a simple API which
is suitable for text-only combo boxes, and hides the complexity of managing
the data in a model. It consists of the functions gtkComboBoxNewText
,
gtkComboBoxAppendText
, gtkComboBoxInsertText
,
gtkComboBoxPrependText
, gtkComboBoxRemoveText
and
gtkComboBoxGetActiveText
.Convenient Construction
gtkComboBox
is the result of collapsing the constructors of GtkComboBox
(gtkComboBoxNew
, gtkComboBoxNewWithModel
) and accepts a subset of its arguments matching the required arguments of one of its delegate constructors.References
http://developer.gnome.org/doc/API/2.0/gtk/GtkComboBox.html