.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Gtk2::ComboBoxEntry 3"
.TH Gtk2::ComboBoxEntry 3 2023-07-25 "perl v5.38.0" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Gtk2::ComboBoxEntry \- A text entry field with a dropdown list
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 5
\&  # 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;
.Ve
.SH DESCRIPTION
.IX Header "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.
.PP
The ComboBoxEntry has a Gtk2::Entry as its child.  To get or set the
currently-displayed text, just manipulate the entry normally.
.SH HIERARCHY
.IX Header "HIERARCHY"
.Vb 8
\&  Glib::Object
\&  +\-\-\-\-Glib::InitiallyUnowned
\&       +\-\-\-\-Gtk2::Object
\&            +\-\-\-\-Gtk2::Widget
\&                 +\-\-\-\-Gtk2::Container
\&                      +\-\-\-\-Gtk2::Bin
\&                           +\-\-\-\-Gtk2::ComboBox
\&                                +\-\-\-\-Gtk2::ComboBoxEntry
.Ve
.SH INTERFACES
.IX Header "INTERFACES"
.Vb 4
\&  Glib::Object::_Unregistered::AtkImplementorIface
\&  Gtk2::Buildable
\&  Gtk2::CellLayout
\&  Gtk2::CellEditable
.Ve
.SH METHODS
.IX Header "METHODS"
.ie n .SS "$entry = Gtk2::ComboBoxEntry\->\fBnew\fP"
.el .SS "\f(CW$entry\fP = Gtk2::ComboBoxEntry\->\fBnew\fP"
.IX Subsection "$entry = Gtk2::ComboBoxEntry->new"
.ie n .SS "$entry = Gtk2::ComboBoxEntry\->\fBnew\fP ($model, $text_column)"
.el .SS "\f(CW$entry\fP = Gtk2::ComboBoxEntry\->\fBnew\fP ($model, \f(CW$text_column\fP)"
.IX Subsection "$entry = Gtk2::ComboBoxEntry->new ($model, $text_column)"
.IP \(bu 4
\&\f(CW$text_column\fR (integer)
.IP \(bu 4
\&\f(CW$model\fR (Gtk2::TreeModel)
.SS "widget = Gtk2::ComboBoxEntry\->\fBnew_text\fP"
.IX Subsection "widget = Gtk2::ComboBoxEntry->new_text"
Since: gtk+ 2.4
.ie n .SS "$entry = Gtk2::ComboBoxEntry\->\fBnew_with_model\fP ($model, $text_column)"
.el .SS "\f(CW$entry\fP = Gtk2::ComboBoxEntry\->\fBnew_with_model\fP ($model, \f(CW$text_column\fP)"
.IX Subsection "$entry = Gtk2::ComboBoxEntry->new_with_model ($model, $text_column)"
.IP \(bu 4
\&\f(CW$text_column\fR (integer)
.IP \(bu 4
\&\f(CW$model\fR (Gtk2::TreeModel)
.PP
Alias for new, with two arguments.
.ie n .SS "integer = $entry_box\->\fBget_text_column\fP"
.el .SS "integer = \f(CW$entry_box\fP\->\fBget_text_column\fP"
.IX Subsection "integer = $entry_box->get_text_column"
.ie n .SS "$entry_box\->\fBset_text_column\fP ($text_column)"
.el .SS "\f(CW$entry_box\fP\->\fBset_text_column\fP ($text_column)"
.IX Subsection "$entry_box->set_text_column ($text_column)"
.IP \(bu 4
\&\f(CW$text_column\fR (integer)
.SH PROPERTIES
.IX Header "PROPERTIES"
.IP "'text\-column' (integer : default \-1 : readable / writable / private / static-nick / static-blurb)" 4
.IX Item "'text-column' (integer : default -1 : readable / writable / private / static-nick / static-blurb)"
A column in the data source model to get the strings from
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Gtk2, Glib::Object, Glib::InitiallyUnowned, Gtk2::Object, Gtk2::Widget, Gtk2::Container, Gtk2::Bin, Gtk2::ComboBox
.SH COPYRIGHT
.IX Header "COPYRIGHT"
Copyright (C) 2003\-2011 by the gtk2\-perl team.
.PP
This software is licensed under the LGPL.  See Gtk2 for a full notice.