Widgets     Book  

---

Gtk::ComboBoxText Class Reference
[Widgets]

Inheritance diagram for Gtk::ComboBoxText:

[legend]List of all members.

---

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

(

)

Deprecated:

See clear_items(). Since 2.8.

Reimplemented from Gtk::CellLayout.

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:

• comboboxtext.h

---