Learn R Programming

RGtk2 (version 2.8.8)

GtkComboBox: GtkComboBox

Description

A widget used to choose from a list of items

Arguments

Methods 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}

Interfaces

GtkComboBox implements AtkImplementorIface, GtkCellEditable and GtkCellLayout.

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

See Also

GtkComboBoxEntry GtkTreeModel GtkCellRenderer