GtkComboBoxText

GtkComboBoxText — A simple, text-only combo box

Synopsis

#include <gtk/gtk.h>

struct              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);
gchar *             gtk_combo_box_text_get_active_text  (GtkComboBoxText *combo_box);

Object Hierarchy

  GObject
   +----GInitiallyUnowned
         +----GtkObject
               +----GtkWidget
                     +----GtkContainer
                           +----GtkBin
                                 +----GtkComboBox
                                       +----GtkComboBoxText

Implemented Interfaces

GtkComboBoxText implements AtkImplementorIface, GtkBuildable, GtkCellLayout and GtkCellEditable.

Description

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_text().

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.

GtkComboBoxText as GtkBuildable

The GtkComboBoxText implementation of the GtkBuildable interface supports adding items directly using the <items&gt element and specifying <item&gt elements for each item. Each <item&gt element supports the regular translation attributes "translatable", "context" and "comments".

Example 30. A UI definition fragment specifying GtkComboBoxText items

1
2
3
4
5
6
7
<object class="GtkComboBoxText">
  <items>
    <item translatable="yes">Factory</item>
    <item translatable="yes">Home</item>
    <item translatable="yes">Subway</item>
  </items>
</object>

Details

struct GtkComboBoxText

struct GtkComboBoxText;


gtk_combo_box_text_new ()

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


gtk_combo_box_text_new_with_entry ()

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


gtk_combo_box_text_append_text ()

void                gtk_combo_box_text_append_text      (GtkComboBoxText *combo_box,
                                                         const gchar *text);

Appends string to the list of strings stored in combo_box.

combo_box :

A GtkComboBoxText

text :

A string

Since 2.24


gtk_combo_box_text_insert_text ()

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.

combo_box :

A GtkComboBoxText

position :

An index to insert text

text :

A string

Since 2.24


gtk_combo_box_text_prepend_text ()

void                gtk_combo_box_text_prepend_text     (GtkComboBoxText *combo_box,
                                                         const gchar *text);

Prepends string to the list of strings stored in combo_box.

combo_box :

A GtkComboBox

text :

A string

Since 2.24


gtk_combo_box_text_get_active_text ()

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).

combo_box :

A GtkComboBoxText

Returns :

a newly allocated string containing the currently active text. Must be freed with g_free().

Since 2.24

See Also

GtkComboBox