![]() |
![]() |
A ComboBox is a widget that allows the user to choose from a list of valid choices. The ComboBox displays the selected choice. When activated, the ComboBox 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 OptionMenu, or similar to a Windows-style combo box.
The ComboBox 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 ComboBox implements the CellLayout 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.
See also ComboBoxText, which is specialised for a single text column.
Public Types | |
typedef TreeView::SlotRowSeparator | SlotRowSeparator |
Public Member Functions | |
ComboBox (const Glib::RefPtr<TreeModel>& model) | |
Creates a new ComboBox with the model initialized to model. | |
ComboBox () | |
TreeModel::const_iterator | get_active () const |
Gets an iterator that points to the current active item, if it exists. | |
TreeModel::iterator | get_active () |
Gets an iterator that points to the current active item, if it exists. | |
int | get_active_row_number () const |
Returns the index of the currently active item, or -1 if there's no active item. | |
bool | get_add_tearoffs () const |
Gets the current value of the :add-tearoffs property. | |
int | get_column_span_column () const |
Returns the column with column span information for combo_box . | |
bool | get_focus_on_click () const |
Returns whether the combo box grabs focus when it is clicked with the mouse. | |
Glib::RefPtr<const TreeModel> | get_model () const |
Returns the Gtk::TreeModel which is acting as data source for combo_box . | |
Glib::RefPtr<TreeModel> | get_model () |
Returns the Gtk::TreeModel which is acting as data source for combo_box . | |
Glib::RefPtr<const Atk::Object> | get_popup_accessible () const |
Gets the accessible object corresponding to the combo box's popup. | |
Glib::RefPtr<Atk::Object> | get_popup_accessible () |
Gets the accessible object corresponding to the combo box's popup. | |
int | get_row_span_column () const |
Returns the column with row span information for combo_box . | |
Glib::ustring | get_title () const |
int | get_wrap_width () const |
Returns the wrap width which is used to determine the number of columns for the popup menu. | |
const GtkComboBox* | gobj () const |
Provides access to the underlying C GtkObject. | |
GtkComboBox* | gobj () |
Provides access to the underlying C GtkObject. | |
void | popdown () |
Hides the menu or dropdown list of combo_box . | |
void | popup () |
Pops up the menu or dropdown list of combo_box . | |
Glib::PropertyProxy_ReadOnly< int > | property_active () const |
The item which is currently active. | |
Glib::PropertyProxy<int> | property_active () |
The item which is currently active. | |
Glib::PropertyProxy_ReadOnly< bool > | property_add_tearoffs () const |
Whether dropdowns should have a tearoff menu item. | |
Glib::PropertyProxy<bool> | property_add_tearoffs () |
Whether dropdowns should have a tearoff menu item. | |
Glib::PropertyProxy_ReadOnly< int > | property_column_span_column () const |
TreeModel column containing the column span values. | |
Glib::PropertyProxy<int> | property_column_span_column () |
TreeModel column containing the column span values. | |
Glib::PropertyProxy_ReadOnly< bool > | property_focus_on_click () const |
Whether the combo box grabs focus when it is clicked with the mouse. | |
Glib::PropertyProxy<bool> | property_focus_on_click () |
Whether the combo box grabs focus when it is clicked with the mouse. | |
Glib::PropertyProxy_ReadOnly< bool > | property_has_frame () const |
Whether the combo box draws a frame around the child. | |
Glib::PropertyProxy<bool> | property_has_frame () |
Whether the combo box draws a frame around the child. | |
Glib::PropertyProxy_ReadOnly< Glib::RefPtr<TreeModel >> | property_model () const |
The model for the combo box. | |
Glib::PropertyProxy< Glib::RefPtr< TreeModel > > | property_model () |
The model for the combo box. | |
Glib::PropertyProxy_ReadOnly< int > | property_row_span_column () const |
TreeModel column containing the row span values. | |
Glib::PropertyProxy<int> | property_row_span_column () |
TreeModel column containing the row span values. | |
Glib::PropertyProxy_ReadOnly< Glib::ustring > | property_tearoff_title () const |
A title that may be displayed by the window manager when the popup is torn-off. | |
Glib::PropertyProxy<Glib::ustring> | property_tearoff_title () |
A title that may be displayed by the window manager when the popup is torn-off. | |
Glib::PropertyProxy_ReadOnly< int > | property_wrap_width () const |
Wrap width for laying out the items in a grid. | |
Glib::PropertyProxy<int> | property_wrap_width () |
Wrap width for laying out the items in a grid. | |
void | set_active (const TreeModel::iterator& iter) |
Sets the current active item to be the one referenced by iter . | |
void | set_active (int index) |
Sets the active item of combo_box to be the item at index . | |
void | set_add_tearoffs (bool add_tearoffs=true) |
Sets whether the popup menu should have a tearoff menu item. | |
void | set_column_span_column (int column_span) |
Sets the column with column span information for combo_box to be column_span . | |
void | set_focus_on_click (bool focus_on_click=true) |
Sets whether the combo box will grab focus when it is clicked with the mouse. | |
void | set_model (const Glib::RefPtr<TreeModel>& model) |
Sets the model used by combo_box to be model . | |
void | set_row_separator_func (const SlotRowSeparator& slot) |
Sets the row separator function, which is used to determine whether a row should be drawn as a separator. | |
void | set_row_span_column (int row_span) |
Sets the column with row span information for combo_box to be row_span . | |
void | set_title (const Glib::ustring& title) |
void | set_wrap_width (int width) |
Sets the wrap width of combo_box to be width . | |
Glib::SignalProxy0<void> | signal_changed () |
The changed signal gets emitted when the active item is changed. | |
void | unset_active () |
Causes no item to be active. | |
void | unset_row_separator_func () |
Causes no separators to be drawn. | |
virtual | ~ComboBox () |
Protected Member Functions | |
virtual void | on_changed () |
Related Functions | |
(Note that these are not member functions.) | |
Gtk::ComboBox* | wrap (GtkComboBox* object, bool take_copy=false) |
|
|
|
|
|
|
|
Creates a new ComboBox with the model initialized to model.
|
|
Gets an iterator that points to the current active item, if it exists.
|
|
Gets an iterator that points to the current active item, if it exists.
|
|
Returns the index of the currently active item, or -1 if there's no active item.
If the model is a non-flat treemodel, and the active item is not an immediate child of the root of the tree, this function returns
|
|
Gets the current value of the :add-tearoffs property.
|
|
Returns the column with column span information for combo_box .
|
|
Returns whether the combo box grabs focus when it is clicked with the mouse. See set_focus_on_click().
|
|
Returns the Gtk::TreeModel which is acting as data source for combo_box .
|
|
Returns the Gtk::TreeModel which is acting as data source for combo_box .
|
|
Gets the accessible object corresponding to the combo box's popup. This function is mostly intended for use by accessibility technologies; applications should have little use for it.
|
|
Gets the accessible object corresponding to the combo box's popup. This function is mostly intended for use by accessibility technologies; applications should have little use for it.
|
|
Returns the column with row span information for combo_box .
|
|
|
|
Returns the wrap width which is used to determine the number of columns for the popup menu. If the wrap width is larger than 1, the combo box is in table mode.
|
|
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::Bin. Reimplemented in Gtk::ComboBoxEntry. |
|
Provides access to the underlying C GtkObject.
Reimplemented from Gtk::Bin. Reimplemented in Gtk::ComboBoxEntry. |
|
|
|
Hides the menu or dropdown list of combo_box . This function is mostly intended for use by accessibility technologies; applications should have little use for it.
|
|
Pops up the menu or dropdown list of combo_box . This function is mostly intended for use by accessibility technologies; applications should have little use for it.
|
|
The item which is currently active. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
The item which is currently active. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether dropdowns should have a tearoff menu item. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether dropdowns should have a tearoff menu item. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
TreeModel column containing the column span values. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
TreeModel column containing the column span values. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether the combo box grabs focus when it is clicked with the mouse. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether the combo box grabs focus when it is clicked with the mouse. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether the combo box draws a frame around the child. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Whether the combo box draws a frame around the child. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
The model for the combo box. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
The model for the combo box. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
TreeModel column containing the row span values. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
TreeModel column containing the row span values. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
A title that may be displayed by the window manager when the popup is torn-off. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
A title that may be displayed by the window manager when the popup is torn-off. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Wrap width for laying out the items in a grid. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Wrap width for laying out the items in a grid. You rarely need to use properties because there are get_ and set_ methods for almost all of them.
|
|
Sets the current active item to be the one referenced by iter . iter must correspond to a path of depth one.
|
|
Sets the active item of combo_box to be the item at index .
|
|
Sets whether the popup menu should have a tearoff menu item.
|
|
Sets the column with column span information for combo_box to be column_span . The column span column contains integers which indicate how many columns an item should span.
|
|
Sets whether the combo box will grab focus when it is clicked with the mouse. Making mouse clicks not grab focus is useful in places like toolbars where you don't want the keyboard focus removed from the main area of the application.
|
|
Sets the model used by combo_box to be model .
Will unset a previously set model (if applicable). If model is Note that this function does not clear the cell renderers, you have to call gtk_combo_box_cell_layout_clear() yourself if you need to set up different cell renderers for the new model.
|
|
Sets the row separator function, which is used to determine whether a row should be drawn as a separator. See also unset_row_separator_func().
|
|
Sets the column with row span information for combo_box to be row_span . The row span column contains integers which indicate how many rows an item should span.
|
|
|
|
Sets the wrap width of combo_box to be width . The wrap width is basically the preferred number of columns when you want the popup to be layed out in a table.
|
|
The changed signal gets emitted when the active item is changed. This can be due to the user selecting a different item from the list, or due to a call to set_active_iter(). |
|
Causes no item to be active. See also set_active(). |
|
Causes no separators to be drawn.
|
|
|