This is a simple variant of ComboBox that hides the model-view complexity for simple text-only use cases. More...

Inheritance diagram for Gtk::ComboBoxText:

Collaboration diagram for Gtk::ComboBoxText:

List of all members.

Public Member Functions
virtual	~ComboBoxText ()
GtkComboBoxText*	gobj ()
	Provides access to the underlying C GtkObject.
const GtkComboBoxText*	gobj () const
	Provides access to the underlying C GtkObject.
	ComboBoxText (bool has_entry=false)
	Creates a new empty ComboBoxText, optionally with an entry.
void	append (const Glib::ustring& text)
void	append (const Glib::ustring& id, const Glib::ustring& text)
void	insert (int position, const Glib::ustring& text)
void	insert (int position, const Glib::ustring& id, const Glib::ustring& text)
void	prepend (const Glib::ustring& text)
void	prepend (const Glib::ustring& id, const Glib::ustring& text)
void	remove_text (int position)
Glib::ustring	get_active_text () const
void	remove_all ()
void	set_active_text (const Glib::ustring& text)
Related Functions
(Note that these are not member functions.)
Gtk::ComboBoxText*	wrap (GtkComboBoxText* object, bool take_copy=false)
	A Glib::wrap() method for this object.

---

Detailed Description

This is a simple variant of ComboBox that hides the model-view complexity for simple text-only use cases.

You can add items to a ComboBoxText with append(), insert() or prepend() and remove items with remove_text().

If the ComboBoxText contains an entry (via the 'has_entry' property), its contents can be retrieved using get_active_text(). The entry itself can be accessed by calling ComboBox::get_entry() or ComboBox::get_entry_text().

You should not call set_model() or attempt to pack more cells into this combo box via its CellLayout base class.

---

Constructor & Destructor Documentation

virtual Gtk::ComboBoxText::~ComboBoxText

(

)

[virtual]

Gtk::ComboBoxText::ComboBoxText

(

bool

has_entry = false

)

[explicit]

Creates a new empty ComboBoxText, optionally with an entry.

Parameters:

has_entry

If this is true then this will have an Entry widget.

---

Member Function Documentation

void Gtk::ComboBoxText::append

(

const Glib::ustring &

text

)

void Gtk::ComboBoxText::append	(	const Glib::ustring &	id,
		const Glib::ustring &	text
	)

Glib::ustring Gtk::ComboBoxText::get_active_text

(

)

const

const GtkComboBoxText* Gtk::ComboBoxText::gobj

(

)

const [inline]

Provides access to the underlying C GtkObject.

Reimplemented from Gtk::ComboBox.

GtkComboBoxText* Gtk::ComboBoxText::gobj

(

)

[inline]

Provides access to the underlying C GtkObject.

Reimplemented from Gtk::ComboBox.

void Gtk::ComboBoxText::insert	(	int	position,
		const Glib::ustring &	text
	)

void Gtk::ComboBoxText::insert	(	int	position,
		const Glib::ustring &	id,
		const Glib::ustring &	text
	)

void Gtk::ComboBoxText::prepend	(	const Glib::ustring &	id,
		const Glib::ustring &	text
	)

void Gtk::ComboBoxText::prepend

(

const Glib::ustring &

text

)

void Gtk::ComboBoxText::remove_all

(

)

void Gtk::ComboBoxText::remove_text

(

int

position

)

void Gtk::ComboBoxText::set_active_text

(

const Glib::ustring &

text

)

---

Friends And Related Function Documentation

Gtk::ComboBoxText* wrap	(	GtkComboBoxText *	object,
		bool	take_copy = false
	)		[related]

A Glib::wrap() method for this object.

Parameters:

object	The C instance.
take_copy	False if the result should take ownership of the C instance. True if it should take a new copy or ref.

Returns:

A C++ instance that wraps this C instance.

---

The documentation for this class was generated from the following file:

• gtkmm/comboboxtext.h