|  |  |  | GTK+ Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Implemented Interfaces | ||||
#include <gtk/gtk.h>
                    GtkComboBoxText;
GtkWidget*          gtk_combo_box_text_new              (void);
GtkWidget*          gtk_combo_box_text_new_with_entry   (void);
void                gtk_combo_box_text_append           (GtkComboBoxText *combo_box,
                                                         const gchar *id,
                                                         const gchar *text);
void                gtk_combo_box_text_prepend          (GtkComboBoxText *combo_box,
                                                         const gchar *id,
                                                         const gchar *text);
void                gtk_combo_box_text_insert           (GtkComboBoxText *combo_box,
                                                         gint position,
                                                         const gchar *id,
                                                         const gchar *text);
void                gtk_combo_box_text_append_text      (GtkComboBoxText *combo_box,
                                                         const gchar *text);
void                gtk_combo_box_text_prepend_text     (GtkComboBoxText *combo_box,
                                                         const gchar *text);
void                gtk_combo_box_text_insert_text      (GtkComboBoxText *combo_box,
                                                         gint position,
                                                         const gchar *text);
void                gtk_combo_box_text_remove           (GtkComboBoxText *combo_box,
                                                         gint position);
void                gtk_combo_box_text_remove_all       (GtkComboBoxText *combo_box);
gchar *             gtk_combo_box_text_get_active_text  (GtkComboBoxText *combo_box);
GObject +----GInitiallyUnowned +----GtkWidget +----GtkContainer +----GtkBin +----GtkComboBox +----GtkComboBoxText
GtkComboBoxText implements AtkImplementorIface, GtkBuildable, GtkCellLayout and GtkCellEditable.
A GtkComboBoxText is a simple variant of GtkComboBox that hides the model-view complexity for simple text-only use cases.
To create a GtkComboBoxText, use gtk_combo_box_text_new() or
gtk_combo_box_text_new_with_entry().
You can add items to a GtkComboBoxText with
gtk_combo_box_text_append_text(), gtk_combo_box_text_insert_text()
or gtk_combo_box_text_prepend_text() and remove options with
gtk_combo_box_text_remove().
If the GtkComboBoxText contains an entry (via the 'has-entry' property),
its contents can be retrieved using gtk_combo_box_text_get_active_text().
The entry itself can be accessed by calling gtk_bin_get_child() on the
combo box.
GtkWidget*          gtk_combo_box_text_new              (void);
Creates a new GtkComboBoxText, which is a GtkComboBox just displaying
strings. See gtk_combo_box_entry_new_with_text().
| Returns : | A new GtkComboBoxText | 
Since 2.24
GtkWidget*          gtk_combo_box_text_new_with_entry   (void);
Creates a new GtkComboBoxText, which is a GtkComboBox just displaying strings. The combo box created by this function has an entry.
| Returns : | a new GtkComboBoxText | 
Since 2.24
void gtk_combo_box_text_append (GtkComboBoxText *combo_box,const gchar *id,const gchar *text);
Appends text to the list of strings stored in combo_box.  If id is
non-NULL then it is used as the ID of the row.
This is the same as calling gtk_combo_box_text_insert() with a
position of -1.
| 
 | A GtkComboBoxText | 
| 
 | |
| 
 | A string | 
Since 2.24
void gtk_combo_box_text_prepend (GtkComboBoxText *combo_box,const gchar *id,const gchar *text);
Prepends text to the list of strings stored in combo_box.  If id
is non-NULL then it is used as the ID of the row.
This is the same as calling gtk_combo_box_text_insert() with a
position of 0.
| 
 | A GtkComboBox | 
| 
 | a string ID for this value, or NULL. [allow-none] | 
| 
 | a string | 
Since 2.24
void gtk_combo_box_text_insert (GtkComboBoxText *combo_box,gint position,const gchar *id,const gchar *text);
Inserts text at position in the list of strings stored in combo_box.
If id is non-NULL then it is used as the ID of the row.  See
"id-column".
If position is negative then text is appended.
| 
 | A GtkComboBoxText | 
| 
 | An index to insert text | 
| 
 | a string ID for this value, or NULL. [allow-none] | 
| 
 | A string to display | 
Since 3.0
void gtk_combo_box_text_append_text (GtkComboBoxText *combo_box,const gchar *text);
Appends text to the list of strings stored in combo_box.
This is the same as calling gtk_combo_box_text_insert_text() with a
position of -1.
| 
 | A GtkComboBoxText | 
| 
 | A string | 
Since 2.24
void gtk_combo_box_text_prepend_text (GtkComboBoxText *combo_box,const gchar *text);
Prepends text to the list of strings stored in combo_box.
This is the same as calling gtk_combo_box_text_insert_text() with a
position of 0.
| 
 | A GtkComboBox | 
| 
 | A string | 
Since 2.24
void gtk_combo_box_text_insert_text (GtkComboBoxText *combo_box,gint position,const gchar *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 gtk_combo_box_text_insert() with a NULL
ID string.
| 
 | A GtkComboBoxText | 
| 
 | An index to insert text | 
| 
 | A string | 
Since 2.24
void gtk_combo_box_text_remove (GtkComboBoxText *combo_box,gint position);
Removes the string at position from combo_box.
| 
 | A GtkComboBox | 
| 
 | Index of the item to remove | 
Since 2.24
void                gtk_combo_box_text_remove_all       (GtkComboBoxText *combo_box);
Removes all the text entries from the combo box.
| 
 | A GtkComboBoxText | 
Since 3.0
gchar *             gtk_combo_box_text_get_active_text  (GtkComboBoxText *combo_box);
Returns the currently active string in combo_box, or NULL 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).
| 
 | A GtkComboBoxText | 
| Returns : | a newly allocated string containing the currently active text.
    Must be freed with g_free(). | 
Since 2.24