Gtk::ComboBoxText Class Reference
[Widgets]

Detailed Description
This is a specialisation of the ComboBox which has one column of text (a simple list), and appropriate methods for setting and getting the text.Note that you can not use this class with Gnome::Glade::Xml::get_widget_derived() to wrap a GtkComboBox added in the Glade user interface designer, because Glade adds its own TreeModel instead of using the TreeModel from this class. You could use a normal Gtk::ComboBox instead, though you can not use Glade to add rows to a TreeModel that is defined in your C++ code.
Public Member Functions | |
void | append_text (const Glib::ustring& text) |
Add an item to the end of the drop-down list. | |
void | clear () |
void | clear_items () |
Remove all items from the drop-down menu. | |
ComboBoxText () | |
Glib::ustring | get_active_text () const |
Get the currently-chosen item. | |
void | insert_text (int position, const Glib::ustring& text) |
void | prepend_text (const Glib::ustring& text) |
Add an item to the beginning of the drop-down list. | |
void | remove_text (const Glib::ustring& text) |
Remove the specified item if it is in the drop-down menu. | |
void | set_active_text (const Glib::ustring& text) |
Set the currently-chosen item if it matches the specified text. | |
Protected Attributes | |
TextModelColumns | m_text_columns |
Classes | |
class | TextModelColumns |
Constructor & Destructor Documentation
Gtk::ComboBoxText::ComboBoxText | ( | ) |
Member Function Documentation
void Gtk::ComboBoxText::append_text | ( | const Glib::ustring & | text | ) |
Add an item to the end of the drop-down list.
- Parameters:
-
text The text for the item.
void Gtk::ComboBoxText::clear | ( | ) |
void Gtk::ComboBoxText::clear_items | ( | ) |
Remove all items from the drop-down menu.
Glib::ustring Gtk::ComboBoxText::get_active_text | ( | ) | const |
Get the currently-chosen item.
- Returns:
- The text of the active item.
void Gtk::ComboBoxText::insert_text | ( | int | position, | |
const Glib::ustring & | text | |||
) |
void Gtk::ComboBoxText::prepend_text | ( | const Glib::ustring & | text | ) |
Add an item to the beginning of the drop-down list.
- Parameters:
-
text The text for the item.
void Gtk::ComboBoxText::remove_text | ( | const Glib::ustring & | text | ) |
Remove the specified item if it is in the drop-down menu.
The text of the item that should be removed.
void Gtk::ComboBoxText::set_active_text | ( | const Glib::ustring & | text | ) |
Set the currently-chosen item if it matches the specified text.
The text of the item that should be selected.
Member Data Documentation
TextModelColumns Gtk::ComboBoxText::m_text_columns [protected] |
The documentation for this class was generated from the following file: