1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
<html xmlns="http://www.w3.org/1999/xhtml">
4
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
5
<title>gtkmm: Gtk::Combo Class Reference</title>
6
<link href="tabs.css" rel="stylesheet" type="text/css"/>
7
<link href="doxygen.css" rel="stylesheet" type="text/css"/>
10
<!-- Generated by Doxygen 1.7.3 -->
13
<table cellspacing="0" cellpadding="0">
15
<tr style="height: 56px;">
16
<td style="padding-left: 0.5em;">
17
<div id="projectname">gtkmm <span id="projectnumber">2.24.2</span></div>
23
<div id="navrow1" class="tabs">
25
<li><a href="index.html"><span>Main Page</span></a></li>
26
<li><a href="pages.html"><span>Related Pages</span></a></li>
27
<li><a href="modules.html"><span>Modules</span></a></li>
28
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
29
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
32
<div id="navrow2" class="tabs2">
34
<li><a href="annotated.html"><span>Class List</span></a></li>
35
<li><a href="classes.html"><span>Class Index</span></a></li>
36
<li><a href="inherits.html"><span>Class Hierarchy</span></a></li>
37
<li><a href="functions.html"><span>Class Members</span></a></li>
40
<div id="nav-path" class="navpath">
42
<li class="navelem"><a class="el" href="namespaceGtk.html">Gtk</a> </li>
43
<li class="navelem"><a class="el" href="classGtk_1_1Combo.html">Combo</a> </li>
49
<a href="#pub-methods">Public Member Functions</a> |
50
<a href="#related">Related Functions</a> </div>
51
<div class="headertitle">
52
<h1>Gtk::Combo Class Reference</h1> </div>
54
<div class="contents">
55
<!-- doxytag: class="Gtk::Combo" --><!-- doxytag: inherits="Gtk::HBox" -->
56
<p>A text entry field with a dropdown list. <a href="#_details">More...</a></p>
57
<div class="dynheader">
58
Inheritance diagram for Gtk::Combo:</div>
59
<div class="dyncontent">
60
<div class="center"><img src="classGtk_1_1Combo__inherit__graph.png" border="0" usemap="#Gtk_1_1Combo_inherit__map" alt="Inheritance graph"/></div>
61
<map name="Gtk_1_1Combo_inherit__map" id="Gtk_1_1Combo_inherit__map">
62
<area shape="rect" id="node2" href="classGtk_1_1HBox.html" title="Horizontal Box for laying widgets in a horizontal row." alt="" coords="88,566,171,597"/><area shape="rect" id="node4" href="classGtk_1_1Box.html" title="A base class for box containers." alt="" coords="92,486,167,517"/><area shape="rect" id="node6" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="76,406,183,437"/><area shape="rect" id="node8" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)" alt="" coords="84,326,175,357"/><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="21,246,109,277"/><area shape="rect" id="node12" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="20,166,111,197"/><area shape="rect" id="node14" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,86,125,117"/><area shape="rect" id="node16" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="12,6,119,37"/><area shape="rect" id="node18" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="133,246,256,277"/></map>
63
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
64
<div class="dynheader">
65
Collaboration diagram for Gtk::Combo:</div>
66
<div class="dyncontent">
67
<div class="center"><img src="classGtk_1_1Combo__coll__graph.png" border="0" usemap="#Gtk_1_1Combo_coll__map" alt="Collaboration graph"/></div>
68
<map name="Gtk_1_1Combo_coll__map" id="Gtk_1_1Combo_coll__map">
69
<area shape="rect" id="node2" href="classGtk_1_1HBox.html" title="Horizontal Box for laying widgets in a horizontal row." alt="" coords="88,566,171,597"/><area shape="rect" id="node4" href="classGtk_1_1Box.html" title="A base class for box containers." alt="" coords="92,486,167,517"/><area shape="rect" id="node6" href="classGtk_1_1Container.html" title="Abstract container class." alt="" coords="76,406,183,437"/><area shape="rect" id="node8" href="classGtk_1_1Widget.html" title="Abstract Widget (Base class for all widgets)" alt="" coords="84,326,175,357"/><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="21,246,109,277"/><area shape="rect" id="node12" href="../../../glibmm-2.4/reference/html/classGlib_1_1Object.html" title="Glib::Object" alt="" coords="20,166,111,197"/><area shape="rect" id="node14" href="../../../glibmm-2.4/reference/html/classGlib_1_1ObjectBase.html" title="Glib::ObjectBase" alt="" coords="5,86,125,117"/><area shape="rect" id="node16" href="../../../libsigc++-2.0/reference/html/structsigc_1_1trackable.html" title="sigc::trackable" alt="" coords="12,6,119,37"/><area shape="rect" id="node18" href="classAtk_1_1Implementor.html" title="Atk::Implementor" alt="" coords="133,246,256,277"/></map>
70
<center><span class="legend">[<a href="graph_legend.html">legend</a>]</span></center></div>
72
<p><a href="classGtk_1_1Combo-members.html">List of all members.</a></p>
73
<table class="memberdecls">
74
<tr><td colspan="2"><h2><a name="pub-methods"></a>
75
Public Member Functions</h2></td></tr>
76
<tr><td class="memItemLeft" align="right" valign="top">virtual </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#aba7602f651eb2f02ad4d33b95a8da75e">~Combo</a> ()</td></tr>
77
<tr><td class="memItemLeft" align="right" valign="top">GtkCombo* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#a40ae8221d5645b7013ebc390a04b8b7a">gobj</a> ()</td></tr>
78
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#a40ae8221d5645b7013ebc390a04b8b7a"></a><br/></td></tr>
79
<tr><td class="memItemLeft" align="right" valign="top">const GtkCombo* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#ac6be6dd4f81a213a491112452fab1246">gobj</a> () const </td></tr>
80
<tr><td class="mdescLeft"> </td><td class="mdescRight">Provides access to the underlying C GtkObject. <a href="#ac6be6dd4f81a213a491112452fab1246"></a><br/></td></tr>
81
<tr><td class="memItemLeft" align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#af3f6def73139d3a0324230927e22deae">Combo</a> ()</td></tr>
82
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#a5d62d1cc190beb17e497bc33e748e4f3">set_value_in_list</a> (bool <a class="elRef" href="http://gcc.gnu.org/onlinedocs/libstdc++/latest-doxygen/a01580.html#ga1c9e781d8d15a3814a601f471797c825">value</a>=true, bool empty=false)</td></tr>
83
<tr><td class="mdescLeft"> </td><td class="mdescRight">Allow direct text entry Whether the text in the entry must be or not be in the list. <a href="#a5d62d1cc190beb17e497bc33e748e4f3"></a><br/></td></tr>
84
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#a7b56384ec4a38579bf849a700bddef48">set_use_arrows</a> (bool arrows_on=true)</td></tr>
85
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set arrows keys to change value Up and down will scroll through the list items. <a href="#a7b56384ec4a38579bf849a700bddef48"></a><br/></td></tr>
86
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#aae855898224e0643763f9816a1f7a28e">set_use_arrows_always</a> (bool arrows_always=true)</td></tr>
87
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set arrows keys to change if value not in list Up and down will scroll through the list items but only change the current value if the text does not match a list item. <a href="#aae855898224e0643763f9816a1f7a28e"></a><br/></td></tr>
88
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#af733b10fa4c4144a9c32b2740422f946">set_case_sensitive</a> (bool val=true)</td></tr>
89
<tr><td class="mdescLeft"> </td><td class="mdescRight">Sets list case sensitive Determines if the list items and text comparisons for <a class="el" href="classGtk_1_1Combo.html#aae855898224e0643763f9816a1f7a28e" title="Set arrows keys to change if value not in list Up and down will scroll through the list items but onl...">set_use_arrows_always()</a> should be case sensitive. <a href="#af733b10fa4c4144a9c32b2740422f946"></a><br/></td></tr>
90
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#ac3abc62c743847a4dc396aa2f2e8063d">set_item_string</a> (<a class="el" href="classGtk_1_1Item.html">Gtk::Item</a>& item, const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>& item_value)</td></tr>
91
<tr><td class="mdescLeft"> </td><td class="mdescRight">Set the current entry <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> Call this function on an item if it isn't a label or you want it to have a different value to be displayed in the entry. <a href="#ac3abc62c743847a4dc396aa2f2e8063d"></a><br/></td></tr>
92
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#aa9a3397381d69b8bc12c13d75250b678">remove_item_string</a> (<a class="el" href="classGtk_1_1Item.html">Gtk::Item</a>& item)</td></tr>
93
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#ae7b8af0710259db6b78b5aea05aece8f">set_popdown_strings</a> (const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ListHandle.html">Glib::ListHandle</a>< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> >& strings)</td></tr>
94
<tr><td class="mdescLeft"> </td><td class="mdescRight">Insert a list of items. <a href="#ae7b8af0710259db6b78b5aea05aece8f"></a><br/></td></tr>
95
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ListHandle.html">Glib::ListHandle</a>< <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_1Combo.html#a19aa703379de75ff38faf4ec95012cd6">get_popdown_strings</a> () const </td></tr>
96
<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#ae38ef926cf3fdf173b5b465f95c6a8a0">disable_activate</a> ()</td></tr>
97
<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_1Combo.html#a435bfaf9b5f6d7cc57747948395d3f4c">get_entry</a> ()</td></tr>
98
<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_1Combo.html#a25cebf3754354d0267bfc270206415cf">get_entry</a> () const </td></tr>
99
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1ComboDropDown.html">ComboDropDown</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#a91d83910eeb8852d3b6339a71edf1ce8">get_list</a> ()</td></tr>
100
<tr><td class="memItemLeft" align="right" valign="top">const <a class="el" href="classGtk_1_1ComboDropDown.html">ComboDropDown</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#aadf386361fbdac36ae2fb353838ddad4">get_list</a> () const </td></tr>
101
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#a6daaff9c3d28178588ac5e2416062d92">property_enable_arrow_keys</a> ()</td></tr>
102
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether the arrow keys move through the list of items. <a href="#a6daaff9c3d28178588ac5e2416062d92"></a><br/></td></tr>
103
<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><br class="typebreak"/>
104
< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#a46bb18c57bd36267888460e6ad9cc3ac">property_enable_arrow_keys</a> () const </td></tr>
105
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether the arrow keys move through the list of items. <a href="#a46bb18c57bd36267888460e6ad9cc3ac"></a><br/></td></tr>
106
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#a0f924351067b242388758c44f22cb228">property_enable_arrows_always</a> ()</td></tr>
107
<tr><td class="mdescLeft"> </td><td class="mdescRight">Obsolete property, ignored. <a href="#a0f924351067b242388758c44f22cb228"></a><br/></td></tr>
108
<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><br class="typebreak"/>
109
< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#ad5db17563f9901b578570032881f18af">property_enable_arrows_always</a> () const </td></tr>
110
<tr><td class="mdescLeft"> </td><td class="mdescRight">Obsolete property, ignored. <a href="#ad5db17563f9901b578570032881f18af"></a><br/></td></tr>
111
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#a1ff2622228b2f7a88bc1fc707a32d21c">property_case_sensitive</a> ()</td></tr>
112
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether list item matching is case sensitive. <a href="#a1ff2622228b2f7a88bc1fc707a32d21c"></a><br/></td></tr>
113
<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><br class="typebreak"/>
114
< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#ad21f6db4279d0994851fc8d60e80551e">property_case_sensitive</a> () const </td></tr>
115
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether list item matching is case sensitive. <a href="#ad21f6db4279d0994851fc8d60e80551e"></a><br/></td></tr>
116
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#af137b429e0fa20d44f08d50930829c3f">property_allow_empty</a> ()</td></tr>
117
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether an empty value may be entered in this field. <a href="#af137b429e0fa20d44f08d50930829c3f"></a><br/></td></tr>
118
<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><br class="typebreak"/>
119
< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#af4804624e6a1f08ca52e5364abecdabf">property_allow_empty</a> () const </td></tr>
120
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether an empty value may be entered in this field. <a href="#af4804624e6a1f08ca52e5364abecdabf"></a><br/></td></tr>
121
<tr><td class="memItemLeft" align="right" valign="top"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a>< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#a146a8caa56cdf63e1af62dbdc3125600">property_value_in_list</a> ()</td></tr>
122
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether entered values must already be present in the list. <a href="#a146a8caa56cdf63e1af62dbdc3125600"></a><br/></td></tr>
123
<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><br class="typebreak"/>
124
< bool > </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#a4bf8e77caa8aeba80c5fca64142b82e8">property_value_in_list</a> () const </td></tr>
125
<tr><td class="mdescLeft"> </td><td class="mdescRight">Whether entered values must already be present in the list. <a href="#a4bf8e77caa8aeba80c5fca64142b82e8"></a><br/></td></tr>
126
<tr><td colspan="2"><h2><a name="related"></a>
127
Related Functions</h2></td></tr>
128
<tr><td colspan="2">(Note that these are not member functions.) <br/></td></tr>
129
<tr><td class="memItemLeft" align="right" valign="top"><a class="el" href="classGtk_1_1Combo.html">Gtk::Combo</a>* </td><td class="memItemRight" valign="bottom"><a class="el" href="classGtk_1_1Combo.html#a9efe068eefbde9d01628dbcb8ea0893c">wrap</a> (GtkCombo* object, bool take_copy=false)</td></tr>
130
<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="#a9efe068eefbde9d01628dbcb8ea0893c"></a><br/></td></tr>
132
<hr/><a name="_details"></a><h2>Detailed Description</h2>
133
<div class="textblock"><p>A text entry field with a dropdown list. </p>
134
<p>A combo is a compound widget which crosses a text entry area and a pull down list. It may allow text entry or it may just allow list values depending on the settings.</p>
135
<p>Access members allow altering of the widget components.</p>
136
<dl class="deprecated"><dt><b><a class="el" href="deprecated.html#_deprecated000163">Deprecated:</a></b></dt><dd>Use the <a class="el" href="classGtk_1_1ComboBox.html" title="A widget used to choose from a list of items.">ComboBox</a> widget instead. </dd></dl>
137
</div><hr/><h2>Constructor & Destructor Documentation</h2>
138
<a class="anchor" id="aba7602f651eb2f02ad4d33b95a8da75e"></a><!-- doxytag: member="Gtk::Combo::~Combo" ref="aba7602f651eb2f02ad4d33b95a8da75e" args="()" -->
139
<div class="memitem">
140
<div class="memproto">
141
<table class="memname">
143
<td class="memname">virtual Gtk::Combo::~Combo </td>
145
<td class="paramname"></td><td>)</td>
146
<td><code> [virtual]</code></td>
154
<a class="anchor" id="af3f6def73139d3a0324230927e22deae"></a><!-- doxytag: member="Gtk::Combo::Combo" ref="af3f6def73139d3a0324230927e22deae" args="()" -->
155
<div class="memitem">
156
<div class="memproto">
157
<table class="memname">
159
<td class="memname">Gtk::Combo::Combo </td>
161
<td class="paramname"></td><td>)</td>
170
<hr/><h2>Member Function Documentation</h2>
171
<a class="anchor" id="ae38ef926cf3fdf173b5b465f95c6a8a0"></a><!-- doxytag: member="Gtk::Combo::disable_activate" ref="ae38ef926cf3fdf173b5b465f95c6a8a0" args="()" -->
172
<div class="memitem">
173
<div class="memproto">
174
<table class="memname">
176
<td class="memname">void Gtk::Combo::disable_activate </td>
178
<td class="paramname"></td><td>)</td>
187
<a class="anchor" id="a435bfaf9b5f6d7cc57747948395d3f4c"></a><!-- doxytag: member="Gtk::Combo::get_entry" ref="a435bfaf9b5f6d7cc57747948395d3f4c" args="()" -->
188
<div class="memitem">
189
<div class="memproto">
190
<table class="memname">
192
<td class="memname"><a class="el" href="classGtk_1_1Entry.html">Entry</a>* Gtk::Combo::get_entry </td>
194
<td class="paramname"></td><td>)</td>
203
<a class="anchor" id="a25cebf3754354d0267bfc270206415cf"></a><!-- doxytag: member="Gtk::Combo::get_entry" ref="a25cebf3754354d0267bfc270206415cf" args="() const " -->
204
<div class="memitem">
205
<div class="memproto">
206
<table class="memname">
208
<td class="memname">const <a class="el" href="classGtk_1_1Entry.html">Entry</a>* Gtk::Combo::get_entry </td>
210
<td class="paramname"></td><td>)</td>
219
<a class="anchor" id="a91d83910eeb8852d3b6339a71edf1ce8"></a><!-- doxytag: member="Gtk::Combo::get_list" ref="a91d83910eeb8852d3b6339a71edf1ce8" args="()" -->
220
<div class="memitem">
221
<div class="memproto">
222
<table class="memname">
224
<td class="memname"><a class="el" href="classGtk_1_1ComboDropDown.html">ComboDropDown</a>* Gtk::Combo::get_list </td>
226
<td class="paramname"></td><td>)</td>
235
<a class="anchor" id="aadf386361fbdac36ae2fb353838ddad4"></a><!-- doxytag: member="Gtk::Combo::get_list" ref="aadf386361fbdac36ae2fb353838ddad4" args="() const " -->
236
<div class="memitem">
237
<div class="memproto">
238
<table class="memname">
240
<td class="memname">const <a class="el" href="classGtk_1_1ComboDropDown.html">ComboDropDown</a>* Gtk::Combo::get_list </td>
242
<td class="paramname"></td><td>)</td>
251
<a class="anchor" id="a19aa703379de75ff38faf4ec95012cd6"></a><!-- doxytag: member="Gtk::Combo::get_popdown_strings" ref="a19aa703379de75ff38faf4ec95012cd6" args="() const " -->
252
<div class="memitem">
253
<div class="memproto">
254
<table class="memname">
256
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ListHandle.html">Glib::ListHandle</a><<a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a>> Gtk::Combo::get_popdown_strings </td>
258
<td class="paramname"></td><td>)</td>
267
<a class="anchor" id="a40ae8221d5645b7013ebc390a04b8b7a"></a><!-- doxytag: member="Gtk::Combo::gobj" ref="a40ae8221d5645b7013ebc390a04b8b7a" args="()" -->
268
<div class="memitem">
269
<div class="memproto">
270
<table class="memname">
272
<td class="memname">GtkCombo* Gtk::Combo::gobj </td>
274
<td class="paramname"></td><td>)</td>
275
<td><code> [inline]</code></td>
281
<p>Provides access to the underlying C GtkObject. </p>
283
<p>Reimplemented from <a class="el" href="classGtk_1_1HBox.html#a276c36213ef878a34ab3a16a6f2dc94b">Gtk::HBox</a>.</p>
287
<a class="anchor" id="ac6be6dd4f81a213a491112452fab1246"></a><!-- doxytag: member="Gtk::Combo::gobj" ref="ac6be6dd4f81a213a491112452fab1246" args="() const " -->
288
<div class="memitem">
289
<div class="memproto">
290
<table class="memname">
292
<td class="memname">const GtkCombo* Gtk::Combo::gobj </td>
294
<td class="paramname"></td><td>)</td>
295
<td> const<code> [inline]</code></td>
301
<p>Provides access to the underlying C GtkObject. </p>
303
<p>Reimplemented from <a class="el" href="classGtk_1_1HBox.html#a200e7083acf10d6075633a5bb2eef9d0">Gtk::HBox</a>.</p>
307
<a class="anchor" id="af137b429e0fa20d44f08d50930829c3f"></a><!-- doxytag: member="Gtk::Combo::property_allow_empty" ref="af137b429e0fa20d44f08d50930829c3f" args="()" -->
308
<div class="memitem">
309
<div class="memproto">
310
<table class="memname">
312
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><bool> Gtk::Combo::property_allow_empty </td>
314
<td class="paramname"></td><td>)</td>
321
<p>Whether an empty value may be entered in this field. </p>
322
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
323
<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>
327
<a class="anchor" id="af4804624e6a1f08ca52e5364abecdabf"></a><!-- doxytag: member="Gtk::Combo::property_allow_empty" ref="af4804624e6a1f08ca52e5364abecdabf" args="() const " -->
328
<div class="memitem">
329
<div class="memproto">
330
<table class="memname">
332
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><bool> Gtk::Combo::property_allow_empty </td>
334
<td class="paramname"></td><td>)</td>
341
<p>Whether an empty value may be entered in this field. </p>
342
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
343
<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>
347
<a class="anchor" id="a1ff2622228b2f7a88bc1fc707a32d21c"></a><!-- doxytag: member="Gtk::Combo::property_case_sensitive" ref="a1ff2622228b2f7a88bc1fc707a32d21c" args="()" -->
348
<div class="memitem">
349
<div class="memproto">
350
<table class="memname">
352
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><bool> Gtk::Combo::property_case_sensitive </td>
354
<td class="paramname"></td><td>)</td>
361
<p>Whether list item matching is case sensitive. </p>
362
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
363
<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>
367
<a class="anchor" id="ad21f6db4279d0994851fc8d60e80551e"></a><!-- doxytag: member="Gtk::Combo::property_case_sensitive" ref="ad21f6db4279d0994851fc8d60e80551e" args="() const " -->
368
<div class="memitem">
369
<div class="memproto">
370
<table class="memname">
372
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><bool> Gtk::Combo::property_case_sensitive </td>
374
<td class="paramname"></td><td>)</td>
381
<p>Whether list item matching is case sensitive. </p>
382
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
383
<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>
387
<a class="anchor" id="a6daaff9c3d28178588ac5e2416062d92"></a><!-- doxytag: member="Gtk::Combo::property_enable_arrow_keys" ref="a6daaff9c3d28178588ac5e2416062d92" args="()" -->
388
<div class="memitem">
389
<div class="memproto">
390
<table class="memname">
392
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><bool> Gtk::Combo::property_enable_arrow_keys </td>
394
<td class="paramname"></td><td>)</td>
401
<p>Whether the arrow keys move through the list of items. </p>
402
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
403
<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>
407
<a class="anchor" id="a46bb18c57bd36267888460e6ad9cc3ac"></a><!-- doxytag: member="Gtk::Combo::property_enable_arrow_keys" ref="a46bb18c57bd36267888460e6ad9cc3ac" args="() const " -->
408
<div class="memitem">
409
<div class="memproto">
410
<table class="memname">
412
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><bool> Gtk::Combo::property_enable_arrow_keys </td>
414
<td class="paramname"></td><td>)</td>
421
<p>Whether the arrow keys move through the list of items. </p>
422
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
423
<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>
427
<a class="anchor" id="a0f924351067b242388758c44f22cb228"></a><!-- doxytag: member="Gtk::Combo::property_enable_arrows_always" ref="a0f924351067b242388758c44f22cb228" args="()" -->
428
<div class="memitem">
429
<div class="memproto">
430
<table class="memname">
432
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><bool> Gtk::Combo::property_enable_arrows_always </td>
434
<td class="paramname"></td><td>)</td>
441
<p>Obsolete property, ignored. </p>
442
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
443
<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>
447
<a class="anchor" id="ad5db17563f9901b578570032881f18af"></a><!-- doxytag: member="Gtk::Combo::property_enable_arrows_always" ref="ad5db17563f9901b578570032881f18af" args="() const " -->
448
<div class="memitem">
449
<div class="memproto">
450
<table class="memname">
452
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><bool> Gtk::Combo::property_enable_arrows_always </td>
454
<td class="paramname"></td><td>)</td>
461
<p>Obsolete property, ignored. </p>
462
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
463
<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>
467
<a class="anchor" id="a4bf8e77caa8aeba80c5fca64142b82e8"></a><!-- doxytag: member="Gtk::Combo::property_value_in_list" ref="a4bf8e77caa8aeba80c5fca64142b82e8" args="() const " -->
468
<div class="memitem">
469
<div class="memproto">
470
<table class="memname">
472
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy__ReadOnly.html">Glib::PropertyProxy_ReadOnly</a><bool> Gtk::Combo::property_value_in_list </td>
474
<td class="paramname"></td><td>)</td>
481
<p>Whether entered values must already be present in the list. </p>
482
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
483
<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>
487
<a class="anchor" id="a146a8caa56cdf63e1af62dbdc3125600"></a><!-- doxytag: member="Gtk::Combo::property_value_in_list" ref="a146a8caa56cdf63e1af62dbdc3125600" args="()" -->
488
<div class="memitem">
489
<div class="memproto">
490
<table class="memname">
492
<td class="memname"><a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1PropertyProxy.html">Glib::PropertyProxy</a><bool> Gtk::Combo::property_value_in_list </td>
494
<td class="paramname"></td><td>)</td>
501
<p>Whether entered values must already be present in the list. </p>
502
<p>You rarely need to use properties because there are get_ and set_ methods for almost all of them. </p>
503
<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>
507
<a class="anchor" id="aa9a3397381d69b8bc12c13d75250b678"></a><!-- doxytag: member="Gtk::Combo::remove_item_string" ref="aa9a3397381d69b8bc12c13d75250b678" args="(Gtk::Item &item)" -->
508
<div class="memitem">
509
<div class="memproto">
510
<table class="memname">
512
<td class="memname">void Gtk::Combo::remove_item_string </td>
514
<td class="paramtype"><a class="el" href="classGtk_1_1Item.html">Gtk::Item</a>& </td>
515
<td class="paramname"><em>item</em></td><td>)</td>
524
<a class="anchor" id="af733b10fa4c4144a9c32b2740422f946"></a><!-- doxytag: member="Gtk::Combo::set_case_sensitive" ref="af733b10fa4c4144a9c32b2740422f946" args="(bool val=true)" -->
525
<div class="memitem">
526
<div class="memproto">
527
<table class="memname">
529
<td class="memname">void Gtk::Combo::set_case_sensitive </td>
531
<td class="paramtype">bool </td>
532
<td class="paramname"><em>val</em> = <code>true</code></td><td>)</td>
539
<p>Sets list case sensitive Determines if the list items and text comparisons for <a class="el" href="classGtk_1_1Combo.html#aae855898224e0643763f9816a1f7a28e" title="Set arrows keys to change if value not in list Up and down will scroll through the list items but onl...">set_use_arrows_always()</a> should be case sensitive. </p>
543
<a class="anchor" id="ac3abc62c743847a4dc396aa2f2e8063d"></a><!-- doxytag: member="Gtk::Combo::set_item_string" ref="ac3abc62c743847a4dc396aa2f2e8063d" args="(Gtk::Item &item, const Glib::ustring &item_value)" -->
544
<div class="memitem">
545
<div class="memproto">
546
<table class="memname">
548
<td class="memname">void Gtk::Combo::set_item_string </td>
550
<td class="paramtype"><a class="el" href="classGtk_1_1Item.html">Gtk::Item</a>& </td>
551
<td class="paramname"><em>item</em>, </td>
554
<td class="paramkey"></td>
556
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> & </td>
557
<td class="paramname"><em>item_value</em> </td>
568
<p>Set the current entry <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> Call this function on an item if it isn't a label or you want it to have a different value to be displayed in the entry. </p>
572
<a class="anchor" id="ae7b8af0710259db6b78b5aea05aece8f"></a><!-- doxytag: member="Gtk::Combo::set_popdown_strings" ref="ae7b8af0710259db6b78b5aea05aece8f" args="(const Glib::ListHandle< Glib::ustring > &strings)" -->
573
<div class="memitem">
574
<div class="memproto">
575
<table class="memname">
577
<td class="memname">void Gtk::Combo::set_popdown_strings </td>
579
<td class="paramtype">const <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ListHandle.html">Glib::ListHandle</a>< <a class="elRef" href="../../../glibmm-2.4/reference/html/classGlib_1_1ustring.html">Glib::ustring</a> > & </td>
580
<td class="paramname"><em>strings</em></td><td>)</td>
587
<p>Insert a list of items. </p>
591
<a class="anchor" id="a7b56384ec4a38579bf849a700bddef48"></a><!-- doxytag: member="Gtk::Combo::set_use_arrows" ref="a7b56384ec4a38579bf849a700bddef48" args="(bool arrows_on=true)" -->
592
<div class="memitem">
593
<div class="memproto">
594
<table class="memname">
596
<td class="memname">void Gtk::Combo::set_use_arrows </td>
598
<td class="paramtype">bool </td>
599
<td class="paramname"><em>arrows_on</em> = <code>true</code></td><td>)</td>
606
<p>Set arrows keys to change value Up and down will scroll through the list items. </p>
607
<p>Useful when there is a small list of value that the list must have.</p>
608
<dl><dt><b>Parameters:</b></dt><dd>
609
<table class="params">
610
<tr><td class="paramname">arrows_on</td><td>true indicates the arrow keys scroll. </td></tr>
617
<a class="anchor" id="aae855898224e0643763f9816a1f7a28e"></a><!-- doxytag: member="Gtk::Combo::set_use_arrows_always" ref="aae855898224e0643763f9816a1f7a28e" args="(bool arrows_always=true)" -->
618
<div class="memitem">
619
<div class="memproto">
620
<table class="memname">
622
<td class="memname">void Gtk::Combo::set_use_arrows_always </td>
624
<td class="paramtype">bool </td>
625
<td class="paramname"><em>arrows_always</em> = <code>true</code></td><td>)</td>
632
<p>Set arrows keys to change if value not in list Up and down will scroll through the list items but only change the current value if the text does not match a list item. </p>
633
<p>Useful when there is a small list of value that the list must have.</p>
634
<dl><dt><b>Parameters:</b></dt><dd>
635
<table class="params">
636
<tr><td class="paramname">arrows_always</td><td>true indicates the value will change. </td></tr>
643
<a class="anchor" id="a5d62d1cc190beb17e497bc33e748e4f3"></a><!-- doxytag: member="Gtk::Combo::set_value_in_list" ref="a5d62d1cc190beb17e497bc33e748e4f3" args="(bool value=true, bool empty=false)" -->
644
<div class="memitem">
645
<div class="memproto">
646
<table class="memname">
648
<td class="memname">void Gtk::Combo::set_value_in_list </td>
650
<td class="paramtype">bool </td>
651
<td class="paramname"><em>value</em> = <code>true</code>, </td>
654
<td class="paramkey"></td>
656
<td class="paramtype">bool </td>
657
<td class="paramname"><em>empty</em> = <code>false</code> </td>
668
<p>Allow direct text entry Whether the text in the entry must be or not be in the list. </p>
669
<dl><dt><b>Parameters:</b></dt><dd>
670
<table class="params">
671
<tr><td class="paramname">value</td><td>Set to true if the value must be in list. </td></tr>
672
<tr><td class="paramname">empty</td><td>Set to true if the text area is allowed to be empty. </td></tr>
679
<hr/><h2>Friends And Related Function Documentation</h2>
680
<a class="anchor" id="a9efe068eefbde9d01628dbcb8ea0893c"></a><!-- doxytag: member="Gtk::Combo::wrap" ref="a9efe068eefbde9d01628dbcb8ea0893c" args="(GtkCombo *object, bool take_copy=false)" -->
681
<div class="memitem">
682
<div class="memproto">
683
<table class="memname">
685
<td class="memname"><a class="el" href="classGtk_1_1Combo.html">Gtk::Combo</a>* wrap </td>
687
<td class="paramtype">GtkCombo * </td>
688
<td class="paramname"><em>object</em>, </td>
691
<td class="paramkey"></td>
693
<td class="paramtype">bool </td>
694
<td class="paramname"><em>take_copy</em> = <code>false</code> </td>
699
<td></td><td><code> [related]</code></td>
705
<p>A <a class="elRef" href="../../../glibmm-2.4/reference/html/namespaceGlib.html#a671306f4a3a0cae5ab4d7a9d54886592">Glib::wrap()</a> method for this object. </p>
706
<dl><dt><b>Parameters:</b></dt><dd>
707
<table class="params">
708
<tr><td class="paramname">object</td><td>The C instance. </td></tr>
709
<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>
713
<dl class="return"><dt><b>Returns:</b></dt><dd>A C++ instance that wraps this C instance. </dd></dl>
717
<hr/>The documentation for this class was generated from the following file:<ul>
718
<li>gtkmm/combo.h</li>
721
<hr class="footer"/><address class="footer"><small>Generated on Fri Jul 8 2011 13:31:49 for gtkmm by 
722
<a href="http://www.doxygen.org/index.html">
723
<img class="footer" src="doxygen.png" alt="doxygen"/></a> 1.7.3 </small></address>
added
removed
share/doc/gtkmm-2.4/reference/html/classGtk_1_1Combo.html
