GtkComboBox {RGtk2}R Documentation

GtkComboBox

Description

A widget used to choose from a list of items

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)
gtkComboBoxSetTitle(object, title)
gtkComboBoxGetTitle(object)
gtkComboBoxSetFocusOnClick(object, focus.on.click)
gtkComboBoxGetFocusOnClick(object)
gtkComboBox(model, show = TRUE)

Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkComboBox
                                       +----GtkComboBoxEntry

Interfaces

GtkComboBox implements GtkBuildable, 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.

Structures

GtkComboBox
undocumented

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.

Signals

The (widget, user.data)
The changed signal is emitted when the active item is changed. The can be due to the user selecting a different item from the list, or due to a call to gtkComboBoxSetActiveIter. It will also be emitted while typing into a GtkComboBoxEntry, as well as when selecting an item from the GtkComboBoxEntry's list.

Since 2.4

widget
[GtkComboBox] the object which received the signal
user.data
[R object] user data set when the signal handler was connected.

The (combobox, arg1, user.data)
undocumented

combobox
[GtkComboBox] the object which received the signal.
arg1
[GtkScrollType]
user.data
[R object] user data set when the signal handler was connected.

The (combobox, user.data)
undocumented

combobox
[GtkComboBox] the object which received the signal.
user.data
[R object] user data set when the signal handler was connected.

The (combobox, user.data)
undocumented

combobox
[GtkComboBox] the object which received the signal.
user.data
[R object] user data set when the signal handler was connected.

Properties

active [integer : Read / Write]

The item which is currently active. If the model is a non-flat treemodel, and the active item is not an immediate child of the root of the tree, this property has the value gtk_tree_path_get_indices (path)[0], where path is the GtkTreePath of the active item.

Allowed values: >= -1 Default value: -1 Since 2.4

add-tearoffs [logical : Read / Write]

The add-tearoffs property controls whether generated menus have tearoff menu items.

Note that this only affects menu style combo boxes.

Default value: FALSE Since 2.6

column-span-column [integer : Read / Write]

If this is set to a non-negative value, it must be the index of a column of type G_TYPE_INT in the model.

The values of that column are used to determine how many columns a value in the list will span.

Allowed values: >= -1 Default value: -1 Since 2.4

focus-on-click [logical : Read / Write]

Whether the combo box grabs focus when it is clicked with the mouse. Default value: TRUE

has-frame [logical : Read / Write]

The has-frame property controls whether a frame is drawn around the entry.

Default value: TRUE Since 2.6

model [GtkTreeModel : Read / Write]

The model from which the combo box takes the values shown in the list.

Since 2.4

popup-shown [logical : Read]

Whether the combo boxes dropdown is popped up. Note that this property is mainly useful, because it allows you to connect to notify::popup-shown.

Default value: FALSE Since 2.10

row-span-column [integer : Read / Write]

If this is set to a non-negative value, it must be the index of a column of type G_TYPE_INT in the model.

The values of that column are used to determine how many rows a value in the list will span. Therefore, the values in the model column pointed to by this property must be greater than zero and not larger than wrap-width.

Allowed values: >= -1 Default value: -1 Since 2.4

tearoff-title [character : Read / Write]

A title that may be displayed by the window manager when the popup is torn-off.

Default value: "" Since 2.10

wrap-width [integer : Read / Write]

If wrap-width is set to a positive value, the list will be displayed in multiple columns, the number of columns is determined by wrap-width.

Allowed values: >= 0 Default value: 0 Since 2.4

Style Properties

appears-as-list [logical : Read]

Whether dropdowns should look like lists rather than menus. Default value: FALSE

arrow-size [integer : Read]

Sets the minimum size of the arrow in the combo box. Note that the arrow size is coupled to the font size, so in case a larger font is used, the arrow will be larger than set by arrow size.

Allowed values: >= 0 Default value: 15 Since 2.12

shadow-type [GtkShadowType : Read]

Which kind of shadow to draw around the combo box.

Default value: GTK_SHADOW_NONE Since 2.12

Author(s)

Derived by RGtkGen from GTK+ documentation

References

http://developer.gnome.org/doc/API/2.0/gtk/GtkComboBox.html

See Also

GtkComboBoxEntry GtkTreeModel GtkCellRenderer


[Package RGtk2 version 2.12.5-3 Index]