---
name: "Gtk2::ComboBoxEntry"
section: "3pm"
platform: "linux"
package: "libgtk2-perl-doc"
version: "2:1.24992-1"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/Gtk2::ComboBoxEntry"
---

# Gtk2::ComboBoxEntry(3pm)

A text entry field with a dropdown list

## NAME

Gtk2::ComboBoxEntry - A text entry field with a dropdown list

## SYNOPSIS

```
  # the easy way
  $combo_box_entry = Gtk2::ComboBoxEntry->new_text;
  foreach (qw(one two three four five)) {
      $combo_box_entry->append_text ($_);
  }
  # or the powerful way.  there always has to be at least
  # one text column in the model, but you can have anything
  # else in it that you want, just like Gtk2::ComboBox.
  $combo_box_entry = Gtk2::ComboBoxEntry->new ($model, $text_index);
  # to mess with with entry directly, get the child:
  $current_text = $combo_box_entry->child->get_text;
```

## DESCRIPTION

A ComboBoxEntry is a widget that allows the user to choose from a list of valid choices or enter a different value.  It is very similar to a ComboBox, but displays the selected value in an entry to allow modifying it.

The ComboBoxEntry has a Gtk2::Entry as its child.  To get or set the currently-displayed text, just manipulate the entry normally.

## HIERARCHY

```
  Glib::Object
  +----Glib::InitiallyUnowned
       +----Gtk2::Object
            +----Gtk2::Widget
                 +----Gtk2::Container
                      +----Gtk2::Bin
                           +----Gtk2::ComboBox
                                +----Gtk2::ComboBoxEntry
```

## INTERFACES

```
  Glib::Object::_Unregistered::AtkImplementorIface
  Gtk2::Buildable
  Gtk2::CellLayout
  Gtk2::CellEditable
```

## METHODS

### $entry = Gtk2::ComboBoxEntry-\>new

### $entry = Gtk2::ComboBoxEntry-\>new ($model, $text\_column)

- •

  `$text_column` (integer)

- •

  `$model` (Gtk2::TreeModel)

### widget = Gtk2::ComboBoxEntry-\>new\_text

Since: gtk+ 2.4

### $entry = Gtk2::ComboBoxEntry-\>new\_with\_model ($model, $text\_column)

- •

  `$text_column` (integer)

- •

  `$model` (Gtk2::TreeModel)

Alias for new, with two arguments.

### integer = $entry\_box-\>get\_text\_column

### $entry\_box-\>set\_text\_column ($text\_column)

- •

  `$text_column` (integer)

## PROPERTIES

- 'text-column' (integer : default -1 : readable / writable / private)

  A column in the data source model to get the strings from

## SEE ALSO

Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Bin, Gtk2::ComboBox

## COPYRIGHT

Copyright (C) 2003-2011 by the gtk2-perl team.

This software is licensed under the LGPL.  See Gtk2 for a full notice.
