ComboBoxText


Object Hierarchy:

Gtk.ComboBoxText Gtk.ComboBoxText Gtk.ComboBoxText Gtk.ComboBox Gtk.ComboBox Gtk.ComboBox->Gtk.ComboBoxText Gtk.Widget Gtk.Widget Gtk.Widget->Gtk.ComboBox GLib.InitiallyUnowned GLib.InitiallyUnowned GLib.InitiallyUnowned->Gtk.Widget GLib.Object GLib.Object GLib.Object->GLib.InitiallyUnowned Gtk.Accessible Gtk.Accessible Gtk.Accessible->Gtk.ComboBoxText Gtk.Accessible->Gtk.ComboBox Gtk.Accessible->Gtk.Widget Gtk.Buildable Gtk.Buildable Gtk.Buildable->Gtk.ComboBoxText Gtk.Buildable->Gtk.ComboBox Gtk.Buildable->Gtk.Widget Gtk.ConstraintTarget Gtk.ConstraintTarget Gtk.ConstraintTarget->Gtk.ComboBoxText Gtk.ConstraintTarget->Gtk.ComboBox Gtk.ConstraintTarget->Gtk.Widget Gtk.CellEditable Gtk.CellEditable Gtk.CellEditable->Gtk.ComboBoxText Gtk.CellEditable->Gtk.ComboBox Gtk.CellLayout Gtk.CellLayout Gtk.CellLayout->Gtk.ComboBoxText Gtk.CellLayout->Gtk.ComboBox

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:

Methods:

Inherited Members:

All known members inherited from class Gtk.Widget
All known members inherited from interface Gtk.CellEditable