ComboBoxTextRef

public struct ComboBoxTextRef : ComboBoxTextProtocol, GWeakCapturing

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

An example GtkComboBoxText

GtkComboBoxText hides the model-view complexity of GtkComboBox.

To create a GtkComboBoxText, use [ctorGtk.ComboBoxText.new] or [ctorGtk.ComboBoxText.new_with_entry].

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

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

You should not call [methodGtk.ComboBox.set_model] or attempt to pack more cells into this combo box via its [ifaceGtk.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:

&lt;object class="GtkComboBoxText"&gt;
  &lt;items&gt;
    &lt;item translatable="yes" id="factory"&gt;Factory&lt;/item&gt;
    &lt;item translatable="yes" id="home"&gt;Home&lt;/item&gt;
    &lt;item translatable="yes" id="subway"&gt;Subway&lt;/item&gt;
  &lt;/items&gt;
&lt;/object&gt;

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.

The ComboBoxTextRef type acts as a lightweight Swift reference to an underlying GtkComboBoxText instance. It exposes methods that can operate on this data type through ComboBoxTextProtocol conformance. Use ComboBoxTextRef only as an unowned reference to an existing GtkComboBoxText instance.

Show on GitHub
  • ptr 
    Untyped pointer to the underlying `GtkComboBoxText` instance.

    For type-safe access, use the generated, typed pointer combo_box_text_ptr property instead.

    Declaration

    Swift

    public let ptr: UnsafeMutableRawPointer!
    Show on GitHub

ComboBoxText Class