<!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::ComboBoxEntryText 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.6.1 --> <div class="navigation" id="top"> <div class="tabs"> <ul> <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 class="tabs"> <ul> <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="hierarchy.html"><span>Class Hierarchy</span></a></li> <li><a href="functions.html"><span>Class Members</span></a></li> </ul> </div> <div class="navpath"><a class="el" href="namespaceGtk.html">Gtk</a>::<a class="el" href="classGtk_1_1ComboBoxEntryText.html">ComboBoxEntryText</a> </div> </div> <div class="contents"> <h1>Gtk::ComboBoxEntryText Class Reference<br/> <small> [<a class="el" href="group__Widgets.html">Widgets</a>]</small> </h1><!-- doxytag: class="Gtk::ComboBoxEntryText" --><!-- doxytag: inherits="Gtk::ComboBoxEntry" --> <p>This is a specialisation of the <a class="el" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list.">ComboBoxEntry</a> which has one column of text (a simple list), and appropriate methods for setting and getting the text. <a href="#_details">More...</a></p> <p>Inherits <a class="el" href="classGtk_1_1ComboBoxEntry.html">Gtk::ComboBoxEntry</a>.</p> <div class="dynheader"> Collaboration diagram for Gtk::ComboBoxEntryText:</div> <div class="dynsection"> <div class="center"><img src="classGtk_1_1ComboBoxEntryText__coll__graph.png" border="0" usemap="#Gtk_1_1ComboBoxEntryText_coll__map" alt="Collaboration graph"/></div> <map name="Gtk_1_1ComboBoxEntryText_coll__map" id="Gtk_1_1ComboBoxEntryText_coll__map"> <area shape="rect" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list." alt="" coords="2093,121,2237,151"/><area shape="rect" href="classGtk_1_1ComboBox.html" title="A widget used to choose from a list of items." alt="" coords="1731,111,1845,140"/><area shape="rect" href="classGtk_1_1Bin.html" title="A container with just one child." alt="" coords="1392,59,1461,88"/><area shape="rect" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="1077,59,1181,88"/><area shape="rect" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)." alt="" coords="833,59,924,88"/><area shape="rect" href="classGtk_1_1Object.html" title="Gtk::Object is the base class for all widgets, and for a few non-widget objects such..." alt="" coords="505,5,593,35"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="340,5,431,35"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="163,31,283,60"/><area shape="rect" href="../../../glibmm-2.4/reference/html/classGlib_1_1Interface.html" title="Glib::Interface" alt="" coords="333,59,437,88"/><area shape="rect" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="5,31,112,60"/><area shape="rect" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="489,59,609,88"/><area shape="rect" href="classGtk_1_1CellLayout.html" title="An interface for packing cells." alt="" coords="635,111,747,140"/><area shape="rect" href="classGtk_1_1ComboBoxEntryText_1_1TextModelColumns.html" title="Gtk::ComboBoxEntryText::TextModelColumns" alt="" coords="2021,177,2309,207"/><area shape="rect" href="classGtk_1_1TreeModelColumnRecord.html" title="Typedefed as TreeModel::ColumnRecord." alt="" coords="1687,177,1889,207"/><area shape="rect" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00716.html" title="std::vector\< GType \>" alt="" coords="1355,177,1499,207"/><area shape="rect" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a00716.html" title="std::vector\< _Tp, _Alloc \>" alt="" coords="1043,213,1216,243"/><area shape="rect" href="classGtk_1_1TreeModelColumn.html" title="Gtk::TreeModelColumn\< Glib::ustring \>" alt="" coords="1664,244,1912,273"/><area shape="rect" href="classGtk_1_1TreeModelColumnBase.html" title="Base class of TreeModelColumn templates." alt="" coords="1037,276,1221,305"/><area shape="rect" href="classGtk_1_1TreeModelColumn.html" title="A Gtk::TreeModelColumn describes the C++ type of the data in a model column, and..." alt="" coords="1333,296,1520,325"/></map> <center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div> <p><a href="classGtk_1_1ComboBoxEntryText-members.html">List of all members.</a></p> <table border="0" cellpadding="0" cellspacing="0"> <tr><td colspan="2"><h2>Classes</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top">class </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntryText_1_1TextModelColumns.html">TextModelColumns</a></td></tr> <tr><td colspan="2"><h2>Public Member Functions</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntryText.html#add8836cb474d7d49e7e0db974678611a">ComboBoxEntryText</a> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntryText.html#a9a9d9779f9ace589924a2399d35c371e">append_text</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& text)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Add an item to the end of the drop-down list. <a href="#a9a9d9779f9ace589924a2399d35c371e"></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_1ComboBoxEntryText.html#a9bf819020740e33033096aa96c81c14e">insert_text</a> (int position, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& text)</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntryText.html#a72ab993ada0ce630115d7c5536f13c3b">prepend_text</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& text)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Add an item to the beginning of the drop-down list. <a href="#a72ab993ada0ce630115d7c5536f13c3b"></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_1ComboBoxEntryText.html#a9995ea1325852746ee0a07717f1eb0bd">get_active_text</a> () const </td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Returns the currently active string. <a href="#a9995ea1325852746ee0a07717f1eb0bd"></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_1ComboBoxEntryText.html#a20c9a16bd0d3e8562c26a8d944747631">set_active_text</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& text)</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntryText.html#a52e3bc91e1153c36aa046ec249880022">clear</a> ()</td></tr> <tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntryText.html#a6ef6dac71b28dfb8fa76cf7e64caff7f">clear_items</a> ()</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Remove all items from the drop-down menu. <a href="#a6ef6dac71b28dfb8fa76cf7e64caff7f"></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_1ComboBoxEntryText.html#a6c722ee9aa96169117c8b6b71b3e8879">remove_text</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& text)</td></tr> <tr><td class="mdescLeft"> </td><td class="mdescRight">Remove the specified item if it is in the drop-down menu. <a href="#a6c722ee9aa96169117c8b6b71b3e8879"></a><br/></td></tr> <tr><td colspan="2"><h2>Protected Attributes</h2></td></tr> <tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1ComboBoxEntryText_1_1TextModelColumns.html">TextModelColumns</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1ComboBoxEntryText.html#aea3abc4a6da6a199555b86cca93f17e6">m_text_columns</a></td></tr> </table> <hr/><a name="_details"></a><h2>Detailed Description</h2> <p>This is a specialisation of the <a class="el" href="classGtk_1_1ComboBoxEntry.html" title="A text entry field with a dropdown list.">ComboBoxEntry</a> which has one column of text (a simple list), and appropriate methods for setting and getting the text. </p> <hr/><h2>Constructor & Destructor Documentation</h2> <a class="anchor" id="add8836cb474d7d49e7e0db974678611a"></a><!-- doxytag: member="Gtk::ComboBoxEntryText::ComboBoxEntryText" ref="add8836cb474d7d49e7e0db974678611a" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">Gtk::ComboBoxEntryText::ComboBoxEntryText </td> <td>(</td> <td class="paramname"></td> <td> ) </td> <td></td> </tr> </table> </div> <div class="memdoc"> </div> </div> <hr/><h2>Member Function Documentation</h2> <a class="anchor" id="a9a9d9779f9ace589924a2399d35c371e"></a><!-- doxytag: member="Gtk::ComboBoxEntryText::append_text" ref="a9a9d9779f9ace589924a2399d35c371e" args="(const Glib::ustring &text)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::ComboBoxEntryText::append_text </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"> <em>text</em></td> <td> ) </td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Add an item to the end of the drop-down list. </p> <dl><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"></td><td valign="top"><em>text</em> </td><td>The text for the item. </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a52e3bc91e1153c36aa046ec249880022"></a><!-- doxytag: member="Gtk::ComboBoxEntryText::clear" ref="a52e3bc91e1153c36aa046ec249880022" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::ComboBoxEntryText::clear </td> <td>(</td> <td class="paramname"></td> <td> ) </td> <td></td> </tr> </table> </div> <div class="memdoc"> <dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000116">Deprecated:</a></b></dt><dd>See <a class="el" href="classGtk_1_1ComboBoxEntryText.html#a6ef6dac71b28dfb8fa76cf7e64caff7f" title="Remove all items from the drop-down menu.">clear_items()</a>. Since 2.8. </dd></dl> <p>Reimplemented from <a class="el" href="classGtk_1_1CellLayout.html#ab87faf407763c4df8985ac7ff985fad8">Gtk::CellLayout</a>.</p> </div> </div> <a class="anchor" id="a6ef6dac71b28dfb8fa76cf7e64caff7f"></a><!-- doxytag: member="Gtk::ComboBoxEntryText::clear_items" ref="a6ef6dac71b28dfb8fa76cf7e64caff7f" args="()" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::ComboBoxEntryText::clear_items </td> <td>(</td> <td class="paramname"></td> <td> ) </td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Remove all items from the drop-down menu. </p> </div> </div> <a class="anchor" id="a9995ea1325852746ee0a07717f1eb0bd"></a><!-- doxytag: member="Gtk::ComboBoxEntryText::get_active_text" ref="a9995ea1325852746ee0a07717f1eb0bd" 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::ComboBoxEntryText::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 from <a class="el" href="classGtk_1_1ComboBoxEntry.html#a3e04a274d621b3210209fd9b1c4f58a6">Gtk::ComboBoxEntry</a>.</p> </div> </div> <a class="anchor" id="a9bf819020740e33033096aa96c81c14e"></a><!-- doxytag: member="Gtk::ComboBoxEntryText::insert_text" ref="a9bf819020740e33033096aa96c81c14e" args="(int position, const Glib::ustring &text)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::ComboBoxEntryText::insert_text </td> <td>(</td> <td class="paramtype">int </td> <td class="paramname"> <em>position</em>, </td> </tr> <tr> <td class="paramkey"></td> <td></td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"> <em>text</em></td><td> </td> </tr> <tr> <td></td> <td>)</td> <td></td><td></td><td></td> </tr> </table> </div> <div class="memdoc"> </div> </div> <a class="anchor" id="a72ab993ada0ce630115d7c5536f13c3b"></a><!-- doxytag: member="Gtk::ComboBoxEntryText::prepend_text" ref="a72ab993ada0ce630115d7c5536f13c3b" args="(const Glib::ustring &text)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::ComboBoxEntryText::prepend_text </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"> <em>text</em></td> <td> ) </td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Add an item to the beginning of the drop-down list. </p> <dl><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td valign="top"></td><td valign="top"><em>text</em> </td><td>The text for the item. </td></tr> </table> </dd> </dl> </div> </div> <a class="anchor" id="a6c722ee9aa96169117c8b6b71b3e8879"></a><!-- doxytag: member="Gtk::ComboBoxEntryText::remove_text" ref="a6c722ee9aa96169117c8b6b71b3e8879" args="(const Glib::ustring &text)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::ComboBoxEntryText::remove_text </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"> <em>text</em></td> <td> ) </td> <td></td> </tr> </table> </div> <div class="memdoc"> <p>Remove the specified item if it is in the drop-down menu. </p> <p>The text of the item that should be removed. </p> </div> </div> <a class="anchor" id="a20c9a16bd0d3e8562c26a8d944747631"></a><!-- doxytag: member="Gtk::ComboBoxEntryText::set_active_text" ref="a20c9a16bd0d3e8562c26a8d944747631" args="(const Glib::ustring &text)" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname">void Gtk::ComboBoxEntryText::set_active_text </td> <td>(</td> <td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td> <td class="paramname"> <em>text</em></td> <td> ) </td> <td></td> </tr> </table> </div> <div class="memdoc"> </div> </div> <hr/><h2>Member Data Documentation</h2> <a class="anchor" id="aea3abc4a6da6a199555b86cca93f17e6"></a><!-- doxytag: member="Gtk::ComboBoxEntryText::m_text_columns" ref="aea3abc4a6da6a199555b86cca93f17e6" args="" --> <div class="memitem"> <div class="memproto"> <table class="memname"> <tr> <td class="memname"><a class="el" href="classGtk_1_1ComboBoxEntryText_1_1TextModelColumns.html">TextModelColumns</a> <a class="el" href="classGtk_1_1ComboBoxEntryText.html#aea3abc4a6da6a199555b86cca93f17e6">Gtk::ComboBoxEntryText::m_text_columns</a><code> [protected]</code></td> </tr> </table> </div> <div class="memdoc"> </div> </div> <hr/>The documentation for this class was generated from the following file:<ul> <li>gtkmm/comboboxentrytext.h</li> </ul> </div> <hr size="1"/><address style="text-align: right;"><small>Generated on Tue May 4 13:22:10 2010 for gtkmm by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.6.1 </small></address> </body> </html>