<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <title>gtkmm: Gtk::ComboBoxEntry Class Reference</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <link href="doxygen.css" rel="stylesheet" type="text/css"/> </head> <body> <!-- Generated by Doxygen 1.7.3 --> <div id="top"> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">gtkmm <span id="projectnumber">2.24.4</span></div> </td> </tr> </tbody> </table> </div> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li><a href="namespaces.html"><span>Namespaces</span></a></li> <li class="current"><a href="annotated.html"><span>Classes</span></a></li> </ul> </div> <div id="navrow2" class="tabs2"> <ul class="tablist"> <li><a href="annotated.html"><span>Class List</span></a></li> <li><a href="classes.html"><span>Class Index</span></a></li> <li><a href="inherits.html"><span>Class Hierarchy</span></a></li> <li><a href="functions.html"><span>Class Members</span></a></li> </ul> </div> <div id="nav-path" class="navpath"> <ul> <li class="navelem"><a class="el" href="namespaceGtk.html">Gtk</a> </li> <li class="navelem"><a class="el" href="classGtk_1_1ComboBoxEntry.html">ComboBoxEntry</a> </li> </ul> </div> </div> <div class="header"> <div class="summary"> <a href="#pub-methods">Public Member Functions</a> | <a href="#related">Related Functions</a> </div> <div class="headertitle"> <h1>Gtk::ComboBoxEntry Class Reference<div class="ingroups"><a class="el" href="group__Widgets.html">Widgets</a></div></h1> </div> </div> <div class="contents"> <!-- doxytag: class="Gtk::ComboBoxEntry" --><!-- doxytag: inherits="Gtk::ComboBox" --> <p>A text entry field with a dropdown list. <a href="#_details">More...</a></p> <div class="dynheader"> Inheritance diagram for Gtk::ComboBoxEntry:</div> <div class="dyncontent"> <div class="center"><img src="classGtk_1_1ComboBoxEntry__inherit__graph.png" border="0" usemap="#Gtk_1_1ComboBoxEntry_inherit__map" alt="Inheritance graph"/></div> <map name="Gtk_1_1ComboBoxEntry_inherit__map" id="Gtk_1_1ComboBoxEntry_inherit__map"> <area shape="rect" id="node26" href="classGtk_1_1ComboBoxEntryText.html" title="This is a specialisation of the ComboBoxEntry which has one column of text (a simple list)..." alt="" coords="151,701,329,731"/><area shape="rect" id="node2" href="classGtk_1_1ComboBox.html" title="A widget used to choose from a list of items." alt="" coords="179,547,301,576"/><area shape="rect" id="node4" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="160,469,232,499"/><area shape="rect" id="node6" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="124,392,239,421"/><area shape="rect" id="node8" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)" alt="" coords="117,315,211,344"/><area shape="rect" id="node10" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such as Gtk::Adjustme..." alt="" coords="5,237,99,267"/><area shape="rect" id="node12" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="63,160,156,189"/><area shape="rect" id="node14" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="124,83,249,112"/><area shape="rect" id="node22" href="../../../glibmm-2.4/reference/html/classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="209,160,319,189"/><area shape="rect" id="node16" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="129,5,244,35"/><area shape="rect" id="node18" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="123,237,256,267"/><area shape="rect" id="node20" href="classGtk_1_1CellLayout.html" title="An interface for packing cells." alt="" coords="235,315,352,344"/></map> <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div> <div class="dynheader"> Collaboration diagram for Gtk::ComboBoxEntry:</div> <div class="dyncontent"> <div class="center"><img src="classGtk_1_1ComboBoxEntry__coll__graph.png" border="0" usemap="#Gtk_1_1ComboBoxEntry_coll__map" alt="Collaboration graph"/></div> <map name="Gtk_1_1ComboBoxEntry_coll__map" id="Gtk_1_1ComboBoxEntry_coll__map"> <area shape="rect" id="node2" href="classGtk_1_1ComboBox.html" title="A widget used to choose from a list of items." alt="" coords="179,547,301,576"/><area shape="rect" id="node4" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="160,469,232,499"/><area shape="rect" id="node6" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="124,392,239,421"/><area shape="rect" id="node8" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)" alt="" coords="117,315,211,344"/><area shape="rect" id="node10" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such as Gtk::Adjustme..." alt="" coords="5,237,99,267"/><area shape="rect" id="node12" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="63,160,156,189"/><area shape="rect" id="node14" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="124,83,249,112"/><area shape="rect" id="node22" href="../../../glibmm-2.4/reference/html/classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="209,160,319,189"/><area shape="rect" id="node16" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="129,5,244,35"/><area shape="rect" id="node18" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="123,237,256,267"/><area shape="rect" id="node20" href="classGtk_1_1CellLayout.html" title="An interface for packing cells." alt="" coords="235,315,352,344"/></map> <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div> <p><a href="classGtk_1_1ComboBoxEntry-members.html">List of all members.</a></p> <table class="memberdecls"> <tr><td colspan="2"><h2><a name="pub-methods"></a> Public Member Functions</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a57afa8a837f45e3ba60878291b448a4b">~ComboBoxEntry</a> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top">GtkComboBoxEntry* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a56e85dfdf965ab78608f408f5cb1de64">gobj</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a56e85dfdf965ab78608f408f5cb1de64"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">const GtkComboBoxEntry* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#aaed72bc5a7cd255a0f6f6345f840d499">gobj</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#aaed72bc5a7cd255a0f6f6345f840d499"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a3584240ffbcecdffbdaabb27ab6eecd6">ComboBoxEntry</a> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a9e9d0fcc3b0320ef7e18d1e9c6b8bf4d">ComboBoxEntry</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1TreeModel.html">TreeModel</a> >& model, const <a class="el" href="classGtk_1_1TreeModelColumnBase.html">TreeModelColumnBase</a>& text_column)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new <a class="el" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list.">ComboBoxEntry</a> which has an <a class="el" href="classGtk_1_1Entry.html" title="A single line text entry field.">Entry</a> as child and a list of strings as popup. <a href="#a9e9d0fcc3b0320ef7e18d1e9c6b8bf4d"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a0132e13cb9ac60b377f6cb6850569136">ComboBoxEntry</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1TreeModel.html">TreeModel</a> >& model, int text_column=0)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Creates a new <a class="el" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list.">ComboBoxEntry</a> which has an <a class="el" href="classGtk_1_1Entry.html" title="A single line text entry field.">Entry</a> as child and a list of strings as popup. <a href="#a0132e13cb9ac60b377f6cb6850569136"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#afa2e958fe2a503113020eeb6902a838c">set_text_column</a> (const <a class="el" href="classGtk_1_1TreeModelColumnBase.html">TreeModelColumnBase</a>& text_column) const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the model column which <em>entry_box</em> should use to get strings from to be <em>text_column</em>. <a href="#afa2e958fe2a503113020eeb6902a838c"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a52133b01b4f7f0cc7c8d6e4e57847408">set_text_column</a> (int text_column) const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Sets the model column which <em>entry_box</em> should use to get strings from to be <em>text_column</em>. <a href="#a52133b01b4f7f0cc7c8d6e4e57847408"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a23d117cd30047c9bc291f1308e4fc579">get_text_column</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the column which <em>entry_box</em> is using to get the strings from. <a href="#a23d117cd30047c9bc291f1308e4fc579"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a3e04a274d621b3210209fd9b1c4f58a6">get_active_text</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the currently active string. <a href="#a3e04a274d621b3210209fd9b1c4f58a6"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Entry.html">Entry</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a8323c424114a5b3be5a31ce4346383dd">get_entry</a> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classGtk_1_1Entry.html">Entry</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a0fe8d234a129eda91f28bf4934e05e79">get_entry</a> () const </td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< int > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a11eef7ce27e47ab4569b1ec5a5e90abc">property_text_column</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">A column in the data source model to get the strings from. <a href="#a11eef7ce27e47ab4569b1ec5a5e90abc"></a><br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a>< int > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a79dfdb77c460742550bbe4ecb0e721b5">property_text_column</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">A column in the data source model to get the strings from. <a href="#a79dfdb77c460742550bbe4ecb0e721b5"></a><br/></td></tr> <tr><td colspan="2"><h2><a name="related"></a> Related Functions</h2></td></tr> <tr><td colspan="2">(Note that these are not member functions.) <br/></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1ComboBoxEntry.html">Gtk::ComboBoxEntry</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntry.html#a5b826be2808a06492d5ae56fcdd35345">wrap</a> (GtkComboBoxEntry* object, bool take_copy=false)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. <a href="#a5b826be2808a06492d5ae56fcdd35345"></a><br/></td></tr> </table> <hr/><a name="_details"></a><h2>Detailed Description</h2> <div class="textblock"><p>A text entry field with a dropdown list. </p> <p>A <a class="el" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list.">ComboBoxEntry</a> 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 <a class="el" href="classGtk_1_1ComboBox.html" title="A widget used to choose from a list of items.">ComboBox</a>, but it displays the selected value in an entry to allow modifying it.</p> <p>In contrast to a <a class="el" href="classGtk_1_1ComboBox.html" title="A widget used to choose from a list of items.">ComboBox</a>, the underlying model of a <a class="el" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list.">ComboBoxEntry</a> must always have a text column (see <a class="el" href="classGtk_1_1ComboBoxEntry.html#afa2e958fe2a503113020eeb6902a838c" title="Sets the model column which entry_box should use to get strings from to be text_column.">set_text_column()</a>), and the entry will show the content of the text column in the selected row. To get the text from the entry, use <a class="el" href="classGtk_1_1ComboBoxEntry.html#a3e04a274d621b3210209fd9b1c4f58a6" title="Returns the currently active string.">get_active_text()</a>.</p> <p>The changed signal will be emitted while typing into a <a class="el" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list.">ComboBoxEntry</a>, as well as when selecting an item from the ComboBoxEntry's list. Use <a class="el" href="classGtk_1_1ComboBox.html#a7580310c60bb21a632a57c09c749e6d2" title="Gets an iterator that points to the current active item, if it exists.">get_active()</a> to discover whether an item was actually selected from the list.</p> <p>See also <a class="el" href="classGtk_1_1ComboBoxEntryText.html" title="This is a specialisation of the ComboBoxEntry which has one column of text (a simple list)...">ComboBoxEntryText</a>, which is specialised for a single text column.</p> <p>To add and remove strings from the list, just modify the model using its data manipulation API. You can get the <a class="el" href="classGtk_1_1Entry.html" title="A single line text entry field.">Entry</a> by using <a class="el" href="classGtk_1_1Bin.html#a7afc2bbea00b279e85fbefacf6f51c97" title="Gets the child of the Gtk::Bin, or 0 if the bin contains no child widget.">get_child()</a>.</p> <p>If you have special needs that go beyond a simple entry (e.g. input validation), it is possible to replace the child entry by a different widget using <a class="el" href="classGtk_1_1Container.html#a9f31c07118f7bdc7a4e0651acf35abbc" title="Removes widget from container.">Gtk::Container::remove()</a> and <a class="el" href="classGtk_1_1Container.html#ae5f3b9c32b1b74e7613997843e91f4cc">Gtk::Container::add()</a>.</p> <p>The <a class="el" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list.">ComboBoxEntry</a> widget looks like this: </p> <div align="center"> <img src="comboboxentry1.png" alt="comboboxentry1.png"/> </div> <dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000037">Deprecated:</a></b></dt><dd>Instead use <a class="el" href="classGtk_1_1ComboBox.html" title="A widget used to choose from a list of items.">ComboBox</a> with has_entry = true. </dd></dl> </div><hr/><h2>Constructor & Destructor Documentation</h2> <a class="anchor" id="a57afa8a837f45e3ba60878291b448a4b"></a><!-- doxytag: member="Gtk::ComboBoxEntry::~ComboBoxEntry" ref="a57afa8a837f45e3ba60878291b448a4b" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">virtual Gtk::ComboBoxEntry::~ComboBoxEntry </td> <td>(</td> <td class="paramname"></td><td>)</td> <td><code> [virtual]</code></td> </tr> </table> </div> <div class="memdoc"> </div> </div> <a class="anchor" id="a3584240ffbcecdffbdaabb27ab6eecd6"></a><!-- doxytag: member="Gtk::ComboBoxEntry::ComboBoxEntry" ref="a3584240ffbcecdffbdaabb27ab6eecd6" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">Gtk::ComboBoxEntry::ComboBoxEntry </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> </div> </div> <a class="anchor" id="a9e9d0fcc3b0320ef7e18d1e9c6b8bf4d"></a><!-- doxytag: member="Gtk::ComboBoxEntry::ComboBoxEntry" ref="a9e9d0fcc3b0320ef7e18d1e9c6b8bf4d" args="(const Glib::RefPtr< TreeModel > &model, const TreeModelColumnBase &text_column)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">Gtk::ComboBoxEntry::ComboBoxEntry </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1TreeModel.html">TreeModel</a> >& </td> <td class="paramname"><em>model</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const <a class="el" href="classGtk_1_1TreeModelColumnBase.html">TreeModelColumnBase</a>& </td> <td class="paramname"><em>text_column</em> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td><code> [explicit]</code></td> </tr> </table> </div> <div class="memdoc"> <p>Creates a new <a class="el" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list.">ComboBoxEntry</a> which has an <a class="el" href="classGtk_1_1Entry.html" title="A single line text entry field.">Entry</a> as child and a list of strings as popup. </p> <p>You can get the <a class="el" href="classGtk_1_1Entry.html" title="A single line text entry field.">Entry</a> from a <a class="el" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list.">ComboBoxEntry</a> using <a class="el" href="classGtk_1_1ComboBoxEntry.html#a8323c424114a5b3be5a31ce4346383dd">get_entry()</a>. To add and remove strings from the list, just modify <em>model</em> using its data manipulation API.</p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">model</td><td>A <a class="el" href="classGtk_1_1TreeModel.html" title="This class defines a generic tree interface for use by the Gtk::TreeView widget.">TreeModel</a>. </td></tr> <tr><td class="paramname">text_column</td><td>A column in <em>model</em> to get the strings from. </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a0132e13cb9ac60b377f6cb6850569136"></a><!-- doxytag: member="Gtk::ComboBoxEntry::ComboBoxEntry" ref="a0132e13cb9ac60b377f6cb6850569136" args="(const Glib::RefPtr< TreeModel > &model, int text_column=0)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">Gtk::ComboBoxEntry::ComboBoxEntry </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1RefPtr.html">Glib::RefPtr</a>< <a class="el" href="classGtk_1_1TreeModel.html">TreeModel</a> >& </td> <td class="paramname"><em>model</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">int </td> <td class="paramname"><em>text_column</em> = <code>0</code> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td><code> [explicit]</code></td> </tr> </table> </div> <div class="memdoc"> <p>Creates a new <a class="el" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list.">ComboBoxEntry</a> which has an <a class="el" href="classGtk_1_1Entry.html" title="A single line text entry field.">Entry</a> as child and a list of strings as popup. </p> <p>You can get the <a class="el" href="classGtk_1_1Entry.html" title="A single line text entry field.">Entry</a> from a <a class="el" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list.">ComboBoxEntry</a> using <a class="el" href="classGtk_1_1ComboBoxEntry.html#a8323c424114a5b3be5a31ce4346383dd">get_entry()</a>. To add and remove strings from the list, just modify <em>model</em> using its data manipulation API.</p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">model</td><td>A <a class="el" href="classGtk_1_1TreeModel.html" title="This class defines a generic tree interface for use by the Gtk::TreeView widget.">TreeModel</a>. </td></tr> <tr><td class="paramname">text_column</td><td>A column in <em>model</em> to get the strings from. </td></tr> </table> </dd> </dl> </div> </div> <hr/><h2>Member Function Documentation</h2> <a class="anchor" id="a3e04a274d621b3210209fd9b1c4f58a6"></a><!-- doxytag: member="Gtk::ComboBoxEntry::get_active_text" ref="a3e04a274d621b3210209fd9b1c4f58a6" args="() const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> Gtk::ComboBoxEntry::get_active_text </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <p>Returns the currently active string. </p> <dl class="return"><dt><b>Returns:</b></dt><dd>The currently active text.</dd></dl> <dl class="since_2_14"><dt><b><a class="el" href="since_2_14.html#_since_2_14000049">Since gtkmm 2.14:</a></b></dt><dd></dd></dl> <p>Reimplemented in <a class="el" href="classGtk_1_1ComboBoxEntryText.html#a9995ea1325852746ee0a07717f1eb0bd">Gtk::ComboBoxEntryText</a>.</p> </div> </div> <a class="anchor" id="a0fe8d234a129eda91f28bf4934e05e79"></a><!-- doxytag: member="Gtk::ComboBoxEntry::get_entry" ref="a0fe8d234a129eda91f28bf4934e05e79" args="() const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">const <a class="el" href="classGtk_1_1Entry.html">Entry</a>* Gtk::ComboBoxEntry::get_entry </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classGtk_1_1Bin.html#a7afc2bbea00b279e85fbefacf6f51c97" title="Gets the child of the Gtk::Bin, or 0 if the bin contains no child widget.">Bin::get_child()</a>. </dd></dl> <p>Reimplemented from <a class="el" href="classGtk_1_1ComboBox.html#af698fe7e7bde80b4c395cc6cd09922eb">Gtk::ComboBox</a>.</p> </div> </div> <a class="anchor" id="a8323c424114a5b3be5a31ce4346383dd"></a><!-- doxytag: member="Gtk::ComboBoxEntry::get_entry" ref="a8323c424114a5b3be5a31ce4346383dd" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classGtk_1_1Entry.html">Entry</a>* Gtk::ComboBoxEntry::get_entry </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <dl class="see"><dt><b>See also:</b></dt><dd><a class="el" href="classGtk_1_1Bin.html#a7afc2bbea00b279e85fbefacf6f51c97" title="Gets the child of the Gtk::Bin, or 0 if the bin contains no child widget.">Bin::get_child()</a>. </dd></dl> <p>Reimplemented from <a class="el" href="classGtk_1_1ComboBox.html#aec3ac156771954edd9605258f0364483">Gtk::ComboBox</a>.</p> </div> </div> <a class="anchor" id="a23d117cd30047c9bc291f1308e4fc579"></a><!-- doxytag: member="Gtk::ComboBoxEntry::get_text_column" ref="a23d117cd30047c9bc291f1308e4fc579" args="() const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">int Gtk::ComboBoxEntry::get_text_column </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <p>Returns the column which <em>entry_box</em> is using to get the strings from. </p> <dl class="since_2_4"><dt><b><a class="el" href="since_2_4.html#_since_2_4000086">Since gtkmm 2.4:</a></b></dt><dd></dd></dl> <p>Deprecated: 2.24: Use <a class="el" href="classGtk_1_1ComboBox.html#a106c129a5681e234be54e43c669f9ef7" title="Returns the column which combo_box is using to get the strings from to display in the internal entry...">get_entry_text_column()</a> instead </p> <dl class="return"><dt><b>Returns:</b></dt><dd>A column in the data source model of <em>entry_box</em>. </dd></dl> </div> </div> <a class="anchor" id="a56e85dfdf965ab78608f408f5cb1de64"></a><!-- doxytag: member="Gtk::ComboBoxEntry::gobj" ref="a56e85dfdf965ab78608f408f5cb1de64" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">GtkComboBoxEntry* Gtk::ComboBoxEntry::gobj </td> <td>(</td> <td class="paramname"></td><td>)</td> <td><code> [inline]</code></td> </tr> </table> </div> <div class="memdoc"> <p>Provides access to the underlying C GtkObject. </p> <p>Reimplemented from <a class="el" href="classGtk_1_1ComboBox.html#a187397e3b51ed9bec9a156c608288b59">Gtk::ComboBox</a>.</p> </div> </div> <a class="anchor" id="aaed72bc5a7cd255a0f6f6345f840d499"></a><!-- doxytag: member="Gtk::ComboBoxEntry::gobj" ref="aaed72bc5a7cd255a0f6f6345f840d499" args="() const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">const GtkComboBoxEntry* Gtk::ComboBoxEntry::gobj </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const<code> [inline]</code></td> </tr> </table> </div> <div class="memdoc"> <p>Provides access to the underlying C GtkObject. </p> <p>Reimplemented from <a class="el" href="classGtk_1_1ComboBox.html#aee51ea71c25139d89c385cd6752358d2">Gtk::ComboBox</a>.</p> </div> </div> <a class="anchor" id="a79dfdb77c460742550bbe4ecb0e721b5"></a><!-- doxytag: member="Gtk::ComboBoxEntry::property_text_column" ref="a79dfdb77c460742550bbe4ecb0e721b5" args="() const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><int> Gtk::ComboBoxEntry::property_text_column </td> <td>(</td> <td class="paramname"></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <p>A column in the data source model to get the strings from. </p> <p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p> <dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl> </div> </div> <a class="anchor" id="a11eef7ce27e47ab4569b1ec5a5e90abc"></a><!-- doxytag: member="Gtk::ComboBoxEntry::property_text_column" ref="a11eef7ce27e47ab4569b1ec5a5e90abc" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><int> Gtk::ComboBoxEntry::property_text_column </td> <td>(</td> <td class="paramname"></td><td>)</td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>A column in the data source model to get the strings from. </p> <p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p> <dl class="return"><dt><b>Returns:</b></dt><dd>A PropertyProxy that allows you to get or set the property of the value, or receive notification when the value of the property changes. </dd></dl> </div> </div> <a class="anchor" id="afa2e958fe2a503113020eeb6902a838c"></a><!-- doxytag: member="Gtk::ComboBoxEntry::set_text_column" ref="afa2e958fe2a503113020eeb6902a838c" args="(const TreeModelColumnBase &text_column) const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::ComboBoxEntry::set_text_column </td> <td>(</td> <td class="paramtype">const <a class="el" href="classGtk_1_1TreeModelColumnBase.html">TreeModelColumnBase</a>& </td> <td class="paramname"><em>text_column</em></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <p>Sets the model column which <em>entry_box</em> should use to get strings from to be <em>text_column</em>. </p> <dl class="since_2_4"><dt><b><a class="el" href="since_2_4.html#_since_2_4000084">Since gtkmm 2.4:</a></b></dt><dd></dd></dl> <p>Deprecated: 2.24: Use <a class="el" href="classGtk_1_1ComboBox.html#a02b89bfdbde705a3aaf10f48636a55ec" title="Sets the model column which combo_box should use to get strings from to be text_column.">set_entry_text_column()</a> instead </p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">text_column</td><td>A column in <em>model</em> to get the strings from. </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a52133b01b4f7f0cc7c8d6e4e57847408"></a><!-- doxytag: member="Gtk::ComboBoxEntry::set_text_column" ref="a52133b01b4f7f0cc7c8d6e4e57847408" args="(int text_column) const " --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::ComboBoxEntry::set_text_column </td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"><em>text_column</em></td><td>)</td> <td> const</td> </tr> </table> </div> <div class="memdoc"> <p>Sets the model column which <em>entry_box</em> should use to get strings from to be <em>text_column</em>. </p> <dl class="since_2_4"><dt><b><a class="el" href="since_2_4.html#_since_2_4000085">Since gtkmm 2.4:</a></b></dt><dd></dd></dl> <p>Deprecated: 2.24: Use <a class="el" href="classGtk_1_1ComboBox.html#a02b89bfdbde705a3aaf10f48636a55ec" title="Sets the model column which combo_box should use to get strings from to be text_column.">set_entry_text_column()</a> instead </p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">text_column</td><td>A column in <em>model</em> to get the strings from. </td></tr> </table> </dd> </dl> </div> </div> <hr/><h2>Friends And Related Function Documentation</h2> <a class="anchor" id="a5b826be2808a06492d5ae56fcdd35345"></a><!-- doxytag: member="Gtk::ComboBoxEntry::wrap" ref="a5b826be2808a06492d5ae56fcdd35345" args="(GtkComboBoxEntry *object, bool take_copy=false)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classGtk_1_1ComboBoxEntry.html">Gtk::ComboBoxEntry</a>* wrap </td> <td>(</td> <td class="paramtype">GtkComboBoxEntry * </td> <td class="paramname"><em>object</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">bool </td> <td class="paramname"><em>take_copy</em> = <code>false</code> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td><code> [related]</code></td> </tr> </table> </div> <div class="memdoc"> <p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p> <dl><dt><b>Parameters:</b></dt><dd> <table class="params"> <tr><td class="paramname">object</td><td>The C instance. </td></tr> <tr><td class="paramname">take_copy</td><td>False if the result should take ownership of the C instance. True if it should take a new copy or ref. </td></tr> </table> </dd> </dl> <dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl> </div> </div> <hr/>The documentation for this class was generated from the following file:<ul> <li>gtkmm/comboboxentry.h</li> </ul> </div> <hr class="footer"/><address class="footer"><small>Generated on Tue Jun 25 2013 for gtkmm by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address> </body> </html>