ComboBoxText

Object Hierarchy:

Description:

[ CCode ( type_id = "gtk_combo_box_text_get_type ()" ) ]
[ Version ( deprecated = true , deprecated_since = "4.10" ) ]
public sealed class ComboBoxText : ComboBox, Accessible, Buildable, CellEditable, CellLayout, ConstraintTarget

Warning: ComboBoxText is deprecated since 4.10.

A `GtkComboBoxText` is a simple variant of `GtkComboBox` for text-only use cases.

Note:

Use [class@Gtk.DropDown] with a [class@Gtk.StringList] instead

![An example GtkComboBoxText](combo-box-text.png)

`GtkComboBoxText` hides the model-view complexity of `GtkComboBox`.

To create a `GtkComboBoxText`, use [ctor@Gtk.ComboBoxText.new] or [ctor@Gtk.ComboBoxText.new_with_entry].

You can add items to a `GtkComboBoxText` with [method@Gtk.ComboBoxText.append_text], [method@Gtk.ComboBoxText.insert_text] or [ method@Gtk.ComboBoxText.prepend_text] and remove options with [method@Gtk.ComboBoxText.remove].

If the `GtkComboBoxText` contains an entry (via the [property@Gtk.ComboBox:has-entry] property), its contents can be retrieved using [ method@Gtk.ComboBoxText.get_active_text].

You should not call [method@Gtk.ComboBox.set_model] or attempt to pack more cells into this combo box via its [iface@Gtk.CellLayout] interface.

GtkComboBoxText as GtkBuildable

The `GtkComboBoxText` implementation of the `GtkBuildable` interface supports adding items directly using the `<items>` element and specifying `<item>` elements for each item. Each `<item>` element can specify the “id” corresponding to the appended text and also supports the regular translation attributes “translatable”, “context” and “comments”.

Here is a UI definition fragment specifying `GtkComboBoxText` items: ```xml <object class="GtkComboBoxText"> <items> <item translatable="yes" id="factory">Factory</item> <item translatable="yes" id="home">Home</item> <item translatable="yes" id="subway">Subway</item> </items> </object> ```

CSS nodes

``` combobox ╰── box.linked ├── entry.combo ├── button.combo ╰── window.popup ```

`GtkComboBoxText` has a single CSS node with name combobox. It adds the style class .combo to the main CSS nodes of its entry and button children, and the .linked class to the node of its internal box.

Namespace: Gtk

Package: gtk4

Content:

Creation methods:

public ComboBoxText ()
Creates a new `GtkComboBoxText`.
public ComboBoxText.with_entry ()
Creates a new `GtkComboBoxText` with an entry.

Methods:

public void append (string? id, string text)
Appends text to the list of strings stored in this.
public void append_text (string text)
Appends text to the list of strings stored in this.
public string? get_active_text ()
Returns the currently active string in this .
public void insert (int position, string? id, string text)
Inserts text at position in the list of strings stored in this.
public void insert_text (int position, string text)
Inserts text at position in the list of strings stored in this.
public void prepend (string? id, string text)
Prepends text to the list of strings stored in this.
public void prepend_text (string text)
Prepends text to the list of strings stored in this.
public void remove (int position)
Removes the string at position from this.
public void remove_all ()
Removes all the text entries from the combo box.

Inherited Members:

All known members inherited from class Gtk.ComboBox

All known members inherited from class Gtk.Widget

All known members inherited from class GLib.Object

All known members inherited from interface Gtk.Accessible

All known members inherited from interface Gtk.Buildable

All known members inherited from interface Gtk.CellEditable

remove_widget

start_editing

All known members inherited from interface Gtk.CellLayout