Description

A Gnome::Gtk4::ComboBoxText is a simple variant of Gnome::Gtk4::ComboBox for text-only use cases.

Gnome::Gtk4::ComboBoxText hides the model-view complexity of Gnome::Gtk4::ComboBox.

To create a Gnome::Gtk4::ComboBoxText, use .newcomboboxtext() or .new-with-entry().

You can add items to a Gnome::Gtk4::ComboBoxText with .append-text(), .insert-text() or .prepend-text() and remove options with .remove().

If the Gnome::Gtk4::ComboBoxText contains an entry (via the has-entry defined in Gnome::Gtk4::ComboBox property), its contents can be retrieved using .get-active-text().

You should not call .set-model() in class Gnome::Gtk4::ComboBox or attempt to pack more cells into this combo box via its Gnome::Gtk4::R-CellLayout interface.

GtkComboBoxText as GtkBuildable

The Gnome::Gtk4::ComboBoxText implementation of the Gnome::Gtk4::R-Buildable 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 Gnome::Gtk4::ComboBoxText items:

CSS nodes

Gnome::Gtk4::ComboBoxText 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.

Class initialization

Note: The native version of this class is deprecated in gtk4-lib() since version 4.10

new

:native-object

Create an object using a native object from elsewhere. See also Gnome::N::TopLevelSupportClass.

multi method new ( N-Object :$native-object! )

new-comboboxtext

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

Creates a new Gnome::Gtk4::ComboBoxText.

method new-comboboxtext ( --> Gnome::Gtk4::ComboBoxText \)

new-with-entry

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

Creates a new Gnome::Gtk4::ComboBoxText with an entry.

method new-with-entry ( --> Gnome::Gtk4::ComboBoxText \)

Methods

append

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

Appends $text to the list of strings stored in $combo-box.

If $id is non-undefined then it is used as the ID of the row.

This is the same as calling .insert() with a position of -1.

method append ( Str $id, Str $text )

• $id; a string ID for this value.

• $text; A string.

append-text

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

Appends $text to the list of strings stored in $combo-box.

This is the same as calling .insert-text() with a position of -1.

method append-text ( Str $text )

• $text; A string.

get-active-text

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

Returns the currently active string in $combo-box.

If no row is currently selected, undefined is returned. If $combo-box contains an entry, this function will return its contents (which will not necessarily be an item from the list).

method get-active-text (--> Str )

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

insert

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

Inserts $text at $position in the list of strings stored in $combo-box.

If $id is non-undefined then it is used as the ID of the row. See id-column defined in Gnome::Gtk4::ComboBox.

If $position is negative then $text is appended.

method insert ( Int() $position, Str $id, Str $text )

• $position; An index to insert $text.

• $id; a string ID for this value.

• $text; A string to display.

insert-text

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

Inserts $text at $position in the list of strings stored in $combo-box.

If $position is negative then $text is appended.

This is the same as calling .insert() with a undefined ID string.

method insert-text ( Int() $position, Str $text )

• $position; An index to insert $text.

• $text; A string.

prepend

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

Prepends $text to the list of strings stored in $combo-box.

If $id is non-undefined then it is used as the ID of the row.

This is the same as calling .insert() with a position of 0.

method prepend ( Str $id, Str $text )

• $id; a string ID for this value.

• $text; a string.

prepend-text

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

Prepends $text to the list of strings stored in $combo-box.

This is the same as calling .insert-text() with a position of 0.

method prepend-text ( Str $text )

• $text; A string.

remove

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

Removes the string at $position from $combo-box.

method remove ( Int() $position )

• $position; Index of the item to remove.

remove-all

Note: The native version of this routine is deprecated in gtk4-lib() since version 4.10

Removes all the text entries from the combo box.

method remove-all ( )