![]() |
![]() |
![]() |
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_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_prepend_text (GtkComboBoxText *combo_box
,const gchar *text
); void gtk_combo_box_text_remove (GtkComboBoxText *combo_box
,gint position
); 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()
.
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_text (GtkComboBoxText *combo_box
,const gchar *text
);
Appends string
to the list of strings stored in combo_box
.
|
A GtkComboBoxText |
|
A string |
Since 2.24
void gtk_combo_box_text_insert_text (GtkComboBoxText *combo_box
,gint position
,const gchar *text
);
Inserts string
at position
in the list of strings stored in combo_box
.
|
A GtkComboBoxText |
|
An index to insert text
|
|
A string |
Since 2.24
void gtk_combo_box_text_prepend_text (GtkComboBoxText *combo_box
,const gchar *text
);
Prepends string
to the list of strings stored in combo_box
.
|
A GtkComboBox |
|
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
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.
|
A GtkComboBoxText |
Returns : |
a newly allocated string containing the currently active text.
Must be freed with g_free() .
|
Since 2.24