gtkmm 3.1.16
|
This is a simple variant of ComboBox that hides the model-view complexity for simple text-only use cases. More...
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) |
Appends text to the list of strings stored in combo_box. | |
void | append (const Glib::ustring& id, const Glib::ustring& text) |
Appends text to the list of strings stored in combo_box. | |
void | insert (int position, const Glib::ustring& text) |
Inserts text at position in the list of strings stored in combo_box. | |
void | insert (int position, const Glib::ustring& id, const Glib::ustring& text) |
Inserts text at position in the list of strings stored in combo_box. | |
void | prepend (const Glib::ustring& text) |
Prepends text to the list of strings stored in combo_box. | |
void | prepend (const Glib::ustring& id, const Glib::ustring& text) |
Prepends text to the list of strings stored in combo_box. | |
void | remove_text (int position) |
Removes the string at position from combo_box. | |
Glib::ustring | get_active_text () const |
Returns the currently active string in combo_box, or 0 if none is selected. | |
void | remove_all () |
Removes all the text entries from the combo box. | |
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. |
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.
virtual Gtk::ComboBoxText::~ComboBoxText | ( | ) | [virtual] |
Gtk::ComboBoxText::ComboBoxText | ( | bool | has_entry = false | ) | [explicit] |
Creates a new empty ComboBoxText, optionally with an entry.
has_entry | If this is true then this will have an Entry widget. |
void Gtk::ComboBoxText::append | ( | const Glib::ustring & | text | ) |
Appends text to the list of strings stored in combo_box.
This is the same as calling insert_text() with a position of -1.
text | A string. |
void Gtk::ComboBoxText::append | ( | const Glib::ustring & | id, |
const Glib::ustring & | text | ||
) |
Appends text to the list of strings stored in combo_box.
If id is non-0
then it is used as the ID of the row.
This is the same as calling insert() with a position of -1.
id | A string ID for this value, or 0 . |
text | A string. |
Glib::ustring Gtk::ComboBoxText::get_active_text | ( | ) | const |
Returns the currently active string in combo_box, or 0
if none is selected.
If combo_box contains an entry, this function will return its contents (which will not necessarily be an item from the list).
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 | ||
) |
Inserts text at position in the list of strings stored in combo_box.
If position is negative then text is appended.
This is the same as calling insert() with a 0
ID string.
position | An index to insert text. |
text | A string. |
void Gtk::ComboBoxText::insert | ( | int | position, |
const Glib::ustring & | id, | ||
const Glib::ustring & | text | ||
) |
Inserts text at position in the list of strings stored in combo_box.
If id is non-0
then it is used as the ID of the row. See Gtk::ComboBox::id-column.
If position is negative then text is appended.
position | An index to insert text. |
id | A string ID for this value, or 0 . |
text | A string to display. |
void Gtk::ComboBoxText::prepend | ( | const Glib::ustring & | id, |
const Glib::ustring & | text | ||
) |
Prepends text to the list of strings stored in combo_box.
If id is non-0
then it is used as the ID of the row.
This is the same as calling insert() with a position of 0.
id | A string ID for this value, or 0 . |
text | A string. |
void Gtk::ComboBoxText::prepend | ( | const Glib::ustring & | text | ) |
Prepends text to the list of strings stored in combo_box.
This is the same as calling insert_text() with a position of 0.
text | A string. |
void Gtk::ComboBoxText::remove_all | ( | ) |
Removes all the text entries from the combo box.
void Gtk::ComboBoxText::remove_text | ( | int | position | ) |
Removes the string at position from combo_box.
position | Index of the item to remove. |
void Gtk::ComboBoxText::set_active_text | ( | const Glib::ustring & | text | ) |
Gtk::ComboBoxText* wrap | ( | GtkComboBoxText * | object, |
bool | take_copy = false |
||
) | [related] |
A Glib::wrap() method for this object.
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. |