/usr/share/gtk-doc/html/pygtk/class-gtkcombobox.html is in python-gtk2-doc 2.24.0-5.1ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.ComboBox</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="PyGTK 2.0 Reference Manual"><link rel="up" href="gtk-class-reference.html" title="The gtk Class Reference"><link rel="prev" href="class-gtkcombo.html" title="gtk.Combo"><link rel="next" href="class-gtkcomboboxentry.html" title="gtk.ComboBoxEntry"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">gtk.ComboBox</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkcombo.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkcomboboxentry.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.ComboBox"><a name="class-gtkcombobox"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.ComboBox</h2><p>gtk.ComboBox — a widget used to choose from
a list of items (new in PyGTK 2.4)</p></div><div class="refsect1" title="Synopsis"><a name="id3651498"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.ComboBox</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkbin.html" title="gtk.Bin">gtk.Bin</a></span></span>, <span class="ooclass"><span class="classname"><a class="link" href="class-gtkcelllayout.html" title="gtk.CellLayout">gtk.CellLayout</a></span></span>):
<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtkcombobox.html#constructor-gtkcombobox" title="Constructor">gtk.ComboBox</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-has-entry" title="gtk.ComboBox.get_has_entry">get_has_entry</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-entry-text-column" title="gtk.ComboBox.get_entry_text_column">get_entry_text_column</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-entry-text-column" title="gtk.ComboBox.set_entry_text_column">set_entry_text_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text_column</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-wrap-width" title="gtk.ComboBox.get_wrap_width">get_wrap_width</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-wrap-width" title="gtk.ComboBox.set_wrap_width">set_wrap_width</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>width</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-row-span-column" title="gtk.ComboBox.get_row_span_column">get_row_span_column</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-row-span-column" title="gtk.ComboBox.set_row_span_column">set_row_span_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>row_span</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-column-span-column" title="gtk.ComboBox.get_column_span_column">get_column_span_column</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-column-span-column" title="gtk.ComboBox.set_column_span_column">set_column_span_column</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column_span</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-button-sensitivity" title="gtk.ComboBox.get_button_sensitivity">get_button_sensitivity</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-button-sensitivity" title="gtk.ComboBox.set_button_sensitivity">set_button_sensitivity</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>sensitivity</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-active" title="gtk.ComboBox.get_active">get_active</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-active" title="gtk.ComboBox.set_active">set_active</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>index</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-active-iter" title="gtk.ComboBox.get_active_iter">get_active_iter</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-active-iter" title="gtk.ComboBox.set_active_iter">set_active_iter</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-model" title="gtk.ComboBox.set_model">set_model</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-model" title="gtk.ComboBox.get_model">get_model</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--append-text" title="gtk.ComboBox.append_text">append_text</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--insert-text" title="gtk.ComboBox.insert_text">insert_text</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--prepend-text" title="gtk.ComboBox.prepend_text">prepend_text</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--remove-text" title="gtk.ComboBox.remove_text">remove_text</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-active-text" title="gtk.ComboBox.get_active_text">get_active_text</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--popup" title="gtk.ComboBox.popup">popup</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--popdown" title="gtk.ComboBox.popdown">popdown</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-popup-accessible" title="gtk.ComboBox.get_popup_accessible">get_popup_accessible</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-row-separator-func" title="gtk.ComboBox.set_row_separator_func">set_row_separator_func</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-add-tearoffs" title="gtk.ComboBox.get_add_tearoffs">get_add_tearoffs</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-add-tearoffs" title="gtk.ComboBox.set_add_tearoffs">set_add_tearoffs</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>add_tearoffs</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-focus-on-click" title="gtk.ComboBox.get_focus_on_click">get_focus_on_click</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-focus-on-click" title="gtk.ComboBox.set_focus_on_click">set_focus_on_click</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus_on_click</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--get-title" title="gtk.ComboBox.get_title">get_title</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-title" title="gtk.ComboBox.set_title">set_title</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code><br></pre></td></tr></table><pre class="programlisting">
<span class="bold"><strong>Functions</strong></span>
<code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombobox.html#function-gtk--combo-box-new-text" title="gtk.combo_box_new_text">gtk.combo_box_new_text</a></span>(<span class="methodparam"></span>)</code></pre></div><div class="refsect1" title="Ancestry"><a name="id3652282"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
+-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
+-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
+-- <a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
+-- <a class="link" href="class-gtkbin.html" title="gtk.Bin">gtk.Bin</a>
+-- <a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox">gtk.ComboBox</a>
</pre></div><div class="refsect1" title="Implemented Interfaces"><a name="id3652325"></a><h2>Implemented Interfaces</h2><p>
<a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a>
implements
<a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>
<a class="link" href="class-atkimplementor.html" title="atk.Implementor"><code class="classname">atk.ImplementorIFace</code></a>
<a class="link" href="class-gtkcelleditable.html" title="gtk.CellEditable"><code class="classname">gtk.CellEditable</code></a>
<a class="link" href="class-gtkcelllayout.html" title="gtk.CellLayout"><code class="classname">gtk.CellLayout</code></a>
</p></div><div class="refsect1" title="gtk.ComboBox Properties"><a name="properties-gtkcombobox"></a><h2>gtk.ComboBox Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p><p><a class="link" href="class-gtkwidget.html#properties-gtkwidget" title="gtk.Widget Properties">gtk.Widget Properties</a></p><p><a class="link" href="class-gtkcontainer.html#properties-gtkcontainer" title="gtk.Container Properties">gtk.Container Properties</a></p><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"active"</td><td valign="top">Read-Write</td><td valign="top">The index of the item that is currently active.. If the
model is a non-flat treemodel, and the active item is not an
immediate child of the root of the tree, this property has the
value of the first index of the path of the item. This
property is available in GTK+ 2.4 and above.</td></tr><tr valign="top"><td valign="top">"add-tearoffs"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> generated menus have tearoff
menu items. Note that this only affects menu style combo
boxes. Default value: <code class="literal">False</code>. Available in
GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"button-sensitivity"</td><td valign="top">Read-Write</td><td valign="top">Whether the dropdown button is sensitive when the model is empty.
Default value: gtk.SENSITIVITY_AUTO. Available in
GTK+ 2.14 and above.</td></tr><tr valign="top"><td valign="top">"column-span-column"</td><td valign="top">Read-Write</td><td valign="top">The TreeModel column containing the column span values.
This property is available in GTK+ 2.4 and above</td></tr><tr valign="top"><td valign="top">"entry-text-column"</td><td valign="top">Read-Write</td><td valign="top">The column in the combo box's model to associate with strings from
the entry if the combo was created with "has-entry" = <code class="literal">True</code>.
This property is available in GTK+ 2.24 and above</td></tr><tr valign="top"><td valign="top">"focus-on-click"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> the combo box grabs focus
when it is clicked with the mouse. Default value:
<code class="literal">True</code></td></tr><tr valign="top"><td valign="top">"has-entry"</td><td valign="top">Read-Write-Construct Only</td><td valign="top">Whether the combo box has an entry. Default value: <code class="literal">False</code>.
This property is available in GTK+ 2.24 and above</td></tr><tr valign="top"><td valign="top">"has-frame"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> the combo box grabs focus
when it is clicked with the mouse. Default value:
<code class="literal">True</code>. Available in GTK+ 2.6 and
above.</td></tr><tr valign="top"><td valign="top">"model"</td><td valign="top">Read-Write</td><td valign="top">The TreeModel for the combo box. This property is
available in GTK+ 2.4 and above.</td></tr><tr valign="top"><td valign="top">"popup-shown"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code> the dropdown menu of the
combobox is popped up. Note that this property is mainly
useful, because it allows you to connect to the
"notify::popup-shown" signal. Available in GTK+ 2.10 and
above.</td></tr><tr valign="top"><td valign="top">"row-span-column"</td><td valign="top">Read-Write</td><td valign="top">The TreeModel column containing the row span
values. This property is available in GTK+ 2.4 and
above.</td></tr><tr valign="top"><td valign="top">"tearoff-title"</td><td valign="top">Read-Write</td><td valign="top">A title that may be displayed by the window manager
when the popup is torn-off. Default value: "". Available in
GTK+ 2.10 and above</td></tr><tr valign="top"><td valign="top">"wrap-width"</td><td valign="top">Read-Write</td><td valign="top">The number of columns to use to lay out the popup
items. This property is available in GTK+ 2.4 and
above.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.ComboBox Style Properties"><a name="style-properties-gtkcombobox"></a><h2>gtk.ComboBox Style Properties</h2><p><a class="link" href="class-gtkwidget.html#style-properties-gtkwidget" title="gtk.Widget Style Properties">gtk.Widget Style Properties</a></p><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col width="1in"><col width="1in"><col width="4in"></colgroup><tbody><tr valign="top"><td valign="top">"appears-as-list"</td><td valign="top">Read-Write</td><td valign="top">If <code class="literal">True</code>, the combo box dropdowns
should look like lists rather than menus.</td></tr><tr valign="top"><td valign="top">"arrow-size"</td><td valign="top">Read-Write</td><td valign="top">Sets the minimum size of the arrow in the combo box. Note that
the arrow size is coupled to the font size, so in case a larger font
is used, the arrow will be larger than set by arrow size.
Allowed values: >= 0. Default value: 15. Available in
GTK+ 2.12 and above.</td></tr><tr valign="top"><td valign="top">"shadow-type"</td><td valign="top">Read-Write</td><td valign="top">Which kind of shadow to draw around the combo box.
Default value: gtk.SHADOW_NONE.
This property is available in GTK+ 2.12 and above.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.ComboBox Signal Prototypes"><a name="signal-prototypes-gtkcombobox"></a><h2>gtk.ComboBox Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></p><p><a class="link" href="class-gtkobject.html#signal-prototypes-gtkobject" title="gtk.Object Signal Prototypes">gtk.Object Signal Prototypes</a></p><p><a class="link" href="class-gtkwidget.html#signal-prototypes-gtkwidget" title="gtk.Widget Signal Prototypes">gtk.Widget Signal Prototypes</a></p><p><a class="link" href="class-gtkcontainer.html#signal-prototypes-gtkcontainer" title="gtk.Container Signal Prototypes">gtk.Container Signal Prototypes</a></p><p><a class="link" href="class-gtkcelleditable.html#signal-prototypes-gtkcelleditable" title="gtk.CellEditable Signal Prototypes">gtk.CellEditable Signal Prototypes</a></p><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term">"<a class="link" href="class-gtkcombobox.html#signal-gtkcombobox--changed" title='The "changed" gtk.ComboBox Signal'>changed</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>combobox</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkcombobox.html#signal-gtkcombobox--move-active" title='The "move-active" gtk.ComboBox Signal'>move-active</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>combobox</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>scroll_type</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkcombobox.html#signal-gtkcombobox--popdown" title='The "popdown" gtk.ComboBox Signal'>popdown</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>combobox</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr><tr><td><p><span class="term">"<a class="link" href="class-gtkcombobox.html#signal-gtkcombobox--popup" title='The "popup" gtk.ComboBox Signal'>popup</a>"</span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>combobox</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></td></tr></tbody></table></div><div class="refsect1" title="Description"><a name="id3653081"></a><h2>Description</h2><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This widget is available in GTK+ 2.4 and PyGTK 2.4 and above.</p></div><p>The <a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a>
is a replacement for the <a class="link" href="class-gtkoptionmenu.html" title="gtk.OptionMenu"><code class="classname">gtk.OptionMenu</code></a>. The
<a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a>
implements the <a class="link" href="class-gtkcelllayout.html" title="gtk.CellLayout"><code class="classname">gtk.CellLayout</code></a>
interface that provides a number of useful methods for managing the
contents. A <a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a>
is created with the <a class="link" href="class-gtkcombobox.html#constructor-gtkcombobox" title="Constructor">gtk.ComboBox()</a> constructor that
is associated with the optional <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>. If
no <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>
is specified it can be added later with the <a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-model" title="gtk.ComboBox.set_model"><code class="methodname">set_model</code>()</a>
method.</p><p>Alternatively, the <a class="link" href="class-gtkcombobox.html#function-gtk--combo-box-new-text" title="gtk.combo_box_new_text"><code class="function">gtk.combo_box_new_text</code>()</a>
function creates a simple <a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a>
and associated <a class="link" href="class-gtkliststore.html" title="gtk.ListStore"><code class="classname">gtk.ListStore</code></a>
model. A <a class="link" href="class-gtkcellrenderertext.html" title="gtk.CellRendererText"><code class="classname">gtk.CellRendererText</code></a>
is also created and packed in the new combo box. In this simple combo
box each list item is a text string that can be selected. The
convenience methods <a class="link" href="class-gtkcombobox.html#method-gtkcombobox--append-text" title="gtk.ComboBox.append_text"><code class="methodname">append_text</code>()</a>,
<a class="link" href="class-gtkcombobox.html#method-gtkcombobox--prepend-text" title="gtk.ComboBox.prepend_text"><code class="methodname">prepend_text</code>()</a>,
<a class="link" href="class-gtkcombobox.html#method-gtkcombobox--insert-text" title="gtk.ComboBox.insert_text"><code class="methodname">insert_text</code>()</a>
and <a class="link" href="class-gtkcombobox.html#method-gtkcombobox--remove-text" title="gtk.ComboBox.remove_text"><code class="methodname">remove_text</code>()</a>
can be used to manage the contents of the <a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a>. Using
the <a class="link" href="class-gtkcombobox.html#function-gtk--combo-box-new-text" title="gtk.combo_box_new_text"><code class="function">gtk.combo_box_new_text</code>()</a>
function is equivalent to:</p><pre class="programlisting">
liststore = gtk.ListStore(gobject.TYPE_STRING)
combobox = gtk.ComboBox(liststore)
cell = gtk.CellRendererText()
combobox.pack_start(cell, True)
combobox.add_attribute(cell, 'text', 0)
</pre></div><div class="refsect1" title="Constructor"><a name="constructor-gtkcombobox"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.ComboBox</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span><span class="initializer">=None</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>model</code></strong> :</span></p></td><td>A valid <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>.</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A new <a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This constructor is available in PyGTK 2.4 and above.</p></div><p>Creates a new <a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a>
associated with the optional <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>
specified by <em class="parameter"><code>model</code></em>. If
<em class="parameter"><code>model</code></em> is not specified the combo box will not
have an associated tree model.</p></div><div class="refsect1" title="Methods"><a name="id3653362"></a><h2>Methods</h2><div class="refsect2" title="gtk.ComboBox.get_has_entry"><a name="method-gtkcombobox--get-has-entry"></a><h3>gtk.ComboBox.get_has_entry</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_has_entry</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>Whether there is an entry in the combo box.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.24 and above.</p></div><p>The <code class="methodname">get_has_entry</code>() method returns
whether the combo box has an entry.</p></div><div class="refsect2" title="gtk.ComboBox.get_entry_text_column"><a name="method-gtkcombobox--get-entry-text-column"></a><h3>gtk.ComboBox.get_entry_text_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_entry_text_column</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A column in the data source model of the combo box.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.24 and above.</p></div><p>The <code class="methodname">get_entry_text_column</code>() method returns
the columns which the combo box is using to get the strings
from to display in the internal entry.</p></div><div class="refsect2" title="gtk.ComboBox.set_entry_text_column"><a name="method-gtkcombobox--set-entry-text-column"></a><h3>gtk.ComboBox.set_entry_text_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_entry_text_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text_column</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>text_column</code></strong> :</span></p></td><td>A column in the data source model to get the strings from for the internal entry.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.24 and above.</p></div><p>The <code class="methodname">set_entry_text_column</code>() method sets the model column
which the combo box should use to get strings from to be text_column. The column text_column
in the model of combo box must be of type G_TYPE_STRING.</p></div><div class="refsect2" title="gtk.ComboBox.get_wrap_width"><a name="method-gtkcombobox--get-wrap-width"></a><h3>gtk.ComboBox.get_wrap_width</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_wrap_width</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The wrap width.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_wrap_width</code>() method returns the
value of the "wrap-width" property of the combo box as set by the <a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-wrap-width" title="gtk.ComboBox.set_wrap_width"><code class="methodname">set_wrap_width</code>()</a>
method. The wrap width is basically the preferred number of columns to use
to lay out the popup i.e. lays out the popup items in a table with
<em class="parameter"><code>width</code></em> columns.</p></div><div class="refsect2" title="gtk.ComboBox.set_wrap_width"><a name="method-gtkcombobox--set-wrap-width"></a><h3>gtk.ComboBox.set_wrap_width</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_wrap_width</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>width</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>width</code></strong> :</span></p></td><td>The preferred number of columns of
width.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">set_wrap_width</code>() method sets the
wrap width (and the "wrap-width" property) of the combo box to the value
specified by <em class="parameter"><code>width</code></em>. The wrap width is basically the
preferred number of columns to use to lay out the popup i.e. lays out the
popup items in a table with <em class="parameter"><code>width</code></em> columns.</p></div><div class="refsect2" title="gtk.ComboBox.get_row_span_column"><a name="method-gtkcombobox--get-row-span-column"></a><h3>gtk.ComboBox.get_row_span_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_row_span_column</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The row span column.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_row_span_column</code>() method
returns the value of the "row-span-column" property. The "row-span-column"
property indicates the column in the associated <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a> row
that contains an integer that indicates how many rows the item should
span.</p></div><div class="refsect2" title="gtk.ComboBox.set_row_span_column"><a name="method-gtkcombobox--set-row-span-column"></a><h3>gtk.ComboBox.set_row_span_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_row_span_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>row_span</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>row_span</code></strong> :</span></p></td><td>A column in the model passed during construction.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">set_row_span_column</code>() method sets
the "row-span-column" property to the value specified by
<em class="parameter"><code>row_span</code></em>. The "row-span-column" property indicates
the column in the associated <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a> row
that contains an integer that indicates how many rows the item should
span.</p></div><div class="refsect2" title="gtk.ComboBox.get_column_span_column"><a name="method-gtkcombobox--get-column-span-column"></a><h3>gtk.ComboBox.get_column_span_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_column_span_column</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The column span column.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_column_span_column</code>() method
returns the value of the "column-span-column" property. The
"column-span-column" property indicates the column in the associated <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a> row
that contains an integer that indicates how many columns the item should
span.</p></div><div class="refsect2" title="gtk.ComboBox.set_column_span_column"><a name="method-gtkcombobox--set-column-span-column"></a><h3>gtk.ComboBox.set_column_span_column</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_column_span_column</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>column_span</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>column_span</code></strong> :</span></p></td><td>A column in the model passed during construction.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">set_column_span_column</code>() method
sets the "column-span-column" property to the value specified by
<em class="parameter"><code>column_span</code></em>. The "column-span-column" property
indicates the column in the associated <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a> row
that contains an integer that indicates how many columns the item should
span.</p></div><div class="refsect2" title="gtk.ComboBox.get_button_sensitivity"><a name="method-gtkcombobox--get-button-sensitivity"></a><h3>gtk.ComboBox.get_button_sensitivity</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_button_sensitivity</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>gtk.SENSITIVITY_ON if the dropdown button is sensitive when
the model is empty, gtk.SENSITIVITY_OFF if the button is always insensitive
or gtk.SENSITIVITY_AUTO if it is only sensitive as long as the model
has one item to be selected.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.14 and above.</p></div><p>
The <code class="methodname">get_button_sensitivity</code>() method returns whether
the combo box sets the dropdown button sensitive or not when there are no items in the model.
</p></div><div class="refsect2" title="gtk.ComboBox.set_button_sensitivity"><a name="method-gtkcombobox--set-button-sensitivity"></a><h3>gtk.ComboBox.set_button_sensitivity</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_button_sensitivity</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>sensitivity</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>sensitivity</code></strong> :</span></p></td><td>specify the sensitivity of the dropdown button.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.14 and above.</p></div><p>
The <code class="methodname">set_button_sensitivity</code>() method sets whether the
dropdown button of the combo box should be always sensitive (gtk.SENSITIVITY_ON),
never sensitive (gtk.SENSITIVITY_OFF) or only if there is at least one item to
display (gtk.SENSITIVITY_AUTO).
</p></div><div class="refsect2" title="gtk.ComboBox.get_active"><a name="method-gtkcombobox--get-active"></a><h3>gtk.ComboBox.get_active</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_active</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>An integer which is the model index of the
currently active item, or -1 if there's no active
item.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">get_active</code>() method returns the
value of the "active" property which is the index in the model of the
currently active item, or -1 if there's no active item. If the model
is a non-flat treemodel, and the active item is not an immediate child
of the root of the tree, this method returns the first path index of
the active item. For example if the path of the active item is (1, 0,
2) this method will return 1.</p></div><div class="refsect2" title="gtk.ComboBox.set_active"><a name="method-gtkcombobox--set-active"></a><h3>gtk.ComboBox.set_active</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_active</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>index</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>index</code></strong> :</span></p></td><td>An index in the model passed during
construction, or -1 to have no active item.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">set_active</code>() method sets the active
item of the combo_box to the item with the model index specified by
<em class="parameter"><code>index</code></em>. If <em class="parameter"><code>index</code></em> is -1 the
combo box will have no active item. The "active" property is also set to the
value of <em class="parameter"><code>index</code></em>.</p></div><div class="refsect2" title="gtk.ComboBox.get_active_iter"><a name="method-gtkcombobox--get-active-iter"></a><h3>gtk.ComboBox.get_active_iter</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_active_iter</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A <a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a>
that points at the active item or <code class="literal">None</code> if there
is no active item.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">get_active_iter</code>() method returns a
<a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a>
that points to the current active item or <code class="literal">None</code> if
there is no active item.</p></div><div class="refsect2" title="gtk.ComboBox.set_active_iter"><a name="method-gtkcombobox--set-active-iter"></a><h3>gtk.ComboBox.set_active_iter</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_active_iter</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>iter</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>iter</code></strong> :</span></p></td><td>A valid <a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a>
pointing at an item in the associated <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">set_active_iter</code>() method sets the
current active item to be the one referenced by <em class="parameter"><code>iter</code></em>
in the associated <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>.
<em class="parameter"><code>iter</code></em> must correspond to a path of depth one. The
"active" property is also set by this method.</p></div><div class="refsect2" title="gtk.ComboBox.set_model"><a name="method-gtkcombobox--set-model"></a><h3>gtk.ComboBox.set_model</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_model</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>model</code></strong></span><span class="initializer">=None</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>model</code></strong> :</span></p></td><td>A <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">set_model</code>() method sets the model
used by the combo box to the value specified by
<em class="parameter"><code>model</code></em>. The "model" property will also be set to the
value of <em class="parameter"><code>model</code></em>. A previously set model will be
unset. If <em class="parameter"><code>model</code></em> is <code class="literal">None</code> or not
specified, the old model will be unset.</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>In PyGTK 2.4.0 the model could not be <code class="literal">None</code>
and did not default to <code class="literal">None</code>.</p></div></div><div class="refsect2" title="gtk.ComboBox.get_model"><a name="method-gtkcombobox--get-model"></a><h3>gtk.ComboBox.get_model</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_model</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>
or <code class="literal">None</code>.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">get_model</code>() method returns the
value of the "model" property which contains the <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>
that is acting as data source for the combo_box or <code class="literal">None</code>
if no <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a> is
associated with the combo box.</p></div><div class="refsect2" title="gtk.ComboBox.append_text"><a name="method-gtkcombobox--append-text"></a><h3>gtk.ComboBox.append_text</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">append_text</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>text</code></strong> :</span></p></td><td>A string.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>This method is deprecated since PyGTK 2.24 and should not be used in newly-written code.
Use <a class="link" href="class-gtkcomboboxtext.html" title="gtk.ComboBoxText"><code class="classname">gtk.ComboBoxText</code></a>
instead.</p></div><p>The <code class="methodname">append_text</code>() method appends the
string specified by <em class="parameter"><code>text</code></em> to the list of strings
stored in the combo box <a class="link" href="class-gtkliststore.html" title="gtk.ListStore"><code class="classname">gtk.ListStore</code></a>. Note
that you can only use this method with combo boxes constructed with the
<a class="link" href="class-gtkcombobox.html#function-gtk--combo-box-new-text" title="gtk.combo_box_new_text"><code class="function">gtk.combo_box_new_text</code>()</a>
function.</p></div><div class="refsect2" title="gtk.ComboBox.insert_text"><a name="method-gtkcombobox--insert-text"></a><h3>gtk.ComboBox.insert_text</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">insert_text</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>position</code></strong> :</span></p></td><td>A model index where the
<em class="parameter"><code>text</code></em> should be
inserted.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>text</code></strong> :</span></p></td><td>A string.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>This method is deprecated since PyGTK 2.24 and should not be used in newly-written code.
Use <a class="link" href="class-gtkcomboboxtext.html" title="gtk.ComboBoxText"><code class="classname">gtk.ComboBoxText</code></a>
instead.</p></div><p>The <code class="methodname">insert_text</code>() method inserts the
string specified by <em class="parameter"><code>text</code></em> in the combo box <a class="link" href="class-gtkliststore.html" title="gtk.ListStore"><code class="classname">gtk.ListStore</code></a> at
the index specified by <em class="parameter"><code>position</code></em>. Note that you can
only use this method with combo boxes constructed with the <a class="link" href="class-gtkcombobox.html#function-gtk--combo-box-new-text" title="gtk.combo_box_new_text"><code class="function">gtk.combo_box_new_text</code>()</a>
function.</p></div><div class="refsect2" title="gtk.ComboBox.prepend_text"><a name="method-gtkcombobox--prepend-text"></a><h3>gtk.ComboBox.prepend_text</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">prepend_text</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>text</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>text</code></strong> :</span></p></td><td>A string.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>This method is deprecated since PyGTK 2.24 and should not be used in newly-written code.
Use <a class="link" href="class-gtkcomboboxtext.html" title="gtk.ComboBoxText"><code class="classname">gtk.ComboBoxText</code></a>
instead.</p></div><p>The <code class="methodname">prepend_text</code>() method prepends the
string specified by <em class="parameter"><code>text</code></em> to the list of strings
stored in the <a class="link" href="class-gtkliststore.html" title="gtk.ListStore"><code class="classname">gtk.ListStore</code></a>
associated with the combo_box. Note that you can only use this method with
combo boxes constructed with the <a class="link" href="class-gtkcombobox.html#function-gtk--combo-box-new-text" title="gtk.combo_box_new_text"><code class="function">gtk.combo_box_new_text</code>()</a>
function.</p></div><div class="refsect2" title="gtk.ComboBox.remove_text"><a name="method-gtkcombobox--remove-text"></a><h3>gtk.ComboBox.remove_text</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">remove_text</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>position</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>position</code></strong> :</span></p></td><td>Index of the item to remove.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>This method is deprecated since PyGTK 2.24 and should not be used in newly-written code.
Use <a class="link" href="class-gtkcomboboxtext.html" title="gtk.ComboBoxText"><code class="classname">gtk.ComboBoxText</code></a>
instead.</p></div><p>The <code class="methodname">remove_text</code>() method removes the
string at the index specified by <em class="parameter"><code>position</code></em> in the
associated <a class="link" href="class-gtkliststore.html" title="gtk.ListStore"><code class="classname">gtk.ListStore</code></a>. Note
that you can only use this function with combo boxes constructed with the
<a class="link" href="class-gtkcombobox.html#function-gtk--combo-box-new-text" title="gtk.combo_box_new_text"><code class="function">gtk.combo_box_new_text</code>()</a>
function.</p></div><div class="refsect2" title="gtk.ComboBox.get_active_text"><a name="method-gtkcombobox--get-active-text"></a><h3>gtk.ComboBox.get_active_text</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_active_text</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>The currently active text.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>This method is deprecated since PyGTK 2.24 and should not be used in newly-written code.
Use <a class="link" href="class-gtkcomboboxtext.html" title="gtk.ComboBoxText"><code class="classname">gtk.ComboBoxText</code></a>
instead.</p></div><p>The <code class="methodname">get_active_text</code>() method returns
the currently active string or <code class="literal">None</code> if no entry is
selected. Note that you can only use this function with combo boxes
constructed with the <a class="link" href="class-gtkcombobox.html#function-gtk--combo-box-new-text" title="gtk.combo_box_new_text"><code class="function">gtk.combo_box_new_text</code>()</a>
function.</p></div><div class="refsect2" title="gtk.ComboBox.popup"><a name="method-gtkcombobox--popup"></a><h3>gtk.ComboBox.popup</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">popup</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">popup</code>() method pops up the menu or
dropdown list of the combo box. This method is mostly intended for use
by accessibility technologies; applications should have little use for
it.</p></div><div class="refsect2" title="gtk.ComboBox.popdown"><a name="method-gtkcombobox--popdown"></a><h3>gtk.ComboBox.popdown</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">popdown</span>(<span class="methodparam"></span>)</code></pre><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.4 and above.</p></div><p>The <code class="methodname">popdown</code>() method hides the menu or
dropdown list of the combo box. This method is mostly intended for use by
accessibility technologies; applications should have little use for
it.</p></div><div class="refsect2" title="gtk.ComboBox.get_popup_accessible"><a name="method-gtkcombobox--get-popup-accessible"></a><h3>gtk.ComboBox.get_popup_accessible</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_popup_accessible</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the accessible object corresponding to the
popup.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_popup_accessible</code>() method gets
the accessible object corresponding to the popup. This method is mostly
intended for use by accessibility technologies; applications should have
little use for it.</p></div><div class="refsect2" title="gtk.ComboBox.set_row_separator_func"><a name="method-gtkcombobox--set-row-separator-func"></a><h3>gtk.ComboBox.set_row_separator_func</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_row_separator_func</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span><span class="initializer">=None</span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span><span class="initializer">=None</span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>func</code></strong> :</span></p></td><td>a function or
<code class="literal">None</code></td></tr><tr><td><p><span class="term"><strong class="parameter"><code>data</code></strong> :</span></p></td><td>user data to pass to
<em class="parameter"><code>func</code></em></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_row_separator_func</code>() method
sets the row separator function to <em class="parameter"><code>func</code></em>, which is
used to determine if a row should be drawn as a separator. If func is
<code class="literal">None</code>, no separators are drawn. This is the default
value.</p><p>The signature of <em class="parameter"><code>func</code></em> is:</p><pre class="programlisting">
def func(model, iter, user_data):
</pre><p>where <em class="parameter"><code>model</code></em> is the <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>
used by the combo box, <em class="parameter"><code>iter</code></em> is a <a class="link" href="class-gtktreeiter.html" title="gtk.TreeIter"><code class="classname">gtk.TreeIter</code></a>
pointing at a row in <em class="parameter"><code>model</code></em> and
<em class="parameter"><code>user_data</code></em> is
<em class="parameter"><code>data</code></em>. <em class="parameter"><code>func</code></em> returns
<code class="literal">True</code> if the row is a separator. A common way to implement
<em class="parameter"><code>func</code></em> is to have a boolean column in
<em class="parameter"><code>model</code></em>, that indicates if the row is a
separator.</p></div><div class="refsect2" title="gtk.ComboBox.get_add_tearoffs"><a name="method-gtkcombobox--get-add-tearoffs"></a><h3>gtk.ComboBox.get_add_tearoffs</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_add_tearoffs</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if menus should have a
tearoff menuitem.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_add_tearoffs</code>() method returns the
value of the "add-tearoffs" property.</p></div><div class="refsect2" title="gtk.ComboBox.set_add_tearoffs"><a name="method-gtkcombobox--set-add-tearoffs"></a><h3>gtk.ComboBox.set_add_tearoffs</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_add_tearoffs</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>add_tearoffs</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>add_tearoffs</code></strong> :</span></p></td><td>if <code class="literal">True</code> add tearoff menu items</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_add_tearoffs</code>() method sets the
"add-tearoffs" property to the value of
<em class="parameter"><code>add_tearoffs</code></em>. If <em class="parameter"><code>add_tearoffs</code></em>
is <code class="literal">True</code>, the popup menu should have a tearoff menu
item.</p></div><div class="refsect2" title="gtk.ComboBox.get_focus_on_click"><a name="method-gtkcombobox--get-focus-on-click"></a><h3>gtk.ComboBox.get_focus_on_click</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_focus_on_click</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the combo box grabs
focus when it is clicked with the mouse.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">get_focus_on_click</code>() method returns
the value of the "focus-on-click" property.</p></div><div class="refsect2" title="gtk.ComboBox.set_focus_on_click"><a name="method-gtkcombobox--set-focus-on-click"></a><h3>gtk.ComboBox.set_focus_on_click</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_focus_on_click</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>focus_on_click</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>focus_on_click</code></strong> :</span></p></td><td>if <code class="literal">True</code> the combo box grabs
focus when clicked with the mouse.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.6 and above.</p></div><p>The <code class="methodname">set_focus_on_click</code>() method sets the
value of the "focus-on-click" property to the value of
<em class="parameter"><code>focus_on_click</code></em>. If
<em class="parameter"><code>focus_on_click</code></em> is <code class="literal">True</code> the combo
box grabs focus when clicked with the mouse.</p></div><div class="refsect2" title="gtk.ComboBox.get_title"><a name="method-gtkcombobox--get-title"></a><h3>gtk.ComboBox.get_title</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_title</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>the menu's title in tearoff
mode..</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">get_title</code>() method returns the
value of the "tearoff-title" property that contains the current title
of the menu in tearoff mode. See the <a class="link" href="class-gtkcombobox.html#method-gtkcombobox--set-add-tearoffs" title="gtk.ComboBox.set_add_tearoffs"><code class="methodname">set_add_tearoffs()</code></a>
method for more information.</p></div><div class="refsect2" title="gtk.ComboBox.set_title"><a name="method-gtkcombobox--set-title"></a><h3>gtk.ComboBox.set_title</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_title</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>title</code></strong></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><strong class="parameter"><code>title</code></strong> :</span></p></td><td>a title for the menu in tearoff
mode.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>The <code class="methodname">set_title</code>() method sets the
"tearoff-title" property to the value of
<em class="parameter"><code>title</code></em>. The "tearoff-title" property contains
the menu's title in tearoff mode.</p></div></div><div class="refsect1" title="Functions"><a name="id3656013"></a><h2>Functions</h2><div class="refsect2" title="gtk.combo_box_new_text"><a name="function-gtk--combo-box-new-text"></a><h3>gtk.combo_box_new_text</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.combo_box_new_text</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A new <a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a>
for text items.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.4 and above.</p></div><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>This function is deprecated since PyGTK 2.24 and should not be used in newly-written code.
Use <a class="link" href="class-gtkcomboboxtext.html" title="gtk.ComboBoxText"><code class="classname">gtk.ComboBoxText</code></a>
instead.</p></div><p>The <code class="function">gtk.combo_box_new_text</code>() function is a
convenience function that constructs a new text combo box, which is a <a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a> just
displaying strings. If you use this function to create a text combo box, you
should only manipulate its data source with the following convenience
methods: <a class="link" href="class-gtkcombobox.html#method-gtkcombobox--append-text" title="gtk.ComboBox.append_text"><code class="methodname">append_text</code>()</a>,
<a class="link" href="class-gtkcombobox.html#method-gtkcombobox--insert-text" title="gtk.ComboBox.insert_text"><code class="methodname">insert_text</code>()</a>,
<a class="link" href="class-gtkcombobox.html#method-gtkcombobox--prepend-text" title="gtk.ComboBox.prepend_text"><code class="methodname">prepend_text</code>()</a>
and <a class="link" href="class-gtkcombobox.html#method-gtkcombobox--remove-text" title="gtk.ComboBox.remove_text"><code class="methodname">remove_text</code>()</a>.</p></div></div><div class="refsect1" title="Signals"><a name="id3656138"></a><h2>Signals</h2><div class="refsect2" title='The "changed" gtk.ComboBox Signal'><a name="signal-gtkcombobox--changed"></a><h3>The "changed" gtk.ComboBox Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>combobox</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>combobox</code></em> :</span></p></td><td>the combo box that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if
any)</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This signal is available in PyGTK 2.4 and above.</p></div><p>The "changed" signal is emitted when a new item in the combo box
is selected.</p></div><div class="refsect2" title='The "move-active" gtk.ComboBox Signal'><a name="signal-gtkcombobox--move-active"></a><h3>The "move-active" gtk.ComboBox Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>combobox</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>scroll_type</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>combobox</code></em> :</span></p></td><td>the combo box that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>scroll_type</code></em> :</span></p></td><td>a
<a class="xref" href="gtk-constants.html#gtk-scroll-type-constants" title="GTK Scroll Type Constants">GTK Scroll Type Constants</a>
</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if any)</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This signal is available in PyGTK 2.12 and above.</p></div><p>The "move-active" signal is a keybinding signal which gets emitted to move the active selection.</p></div><div class="refsect2" title='The "popdown" gtk.ComboBox Signal'><a name="signal-gtkcombobox--popdown"></a><h3>The "popdown" gtk.ComboBox Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>combobox</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>combobox</code></em> :</span></p></td><td>the combo box that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if any)</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This signal is available in PyGTK 2.12 and above.</p></div><p>The "popdown" signal is a keybinding signal which gets emitted to popdown
the combo box list. The default bindings for this signal are Alt+Up and Escape.</p></div><div class="refsect2" title='The "popup" gtk.ComboBox Signal'><a name="signal-gtkcombobox--popup"></a><h3>The "popup" gtk.ComboBox Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>combobox</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>user_param1</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>...</code></em></span></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><em class="parameter"><code>combobox</code></em> :</span></p></td><td>the combo box that received the
signal</td></tr><tr><td><p><span class="term"><em class="parameter"><code>user_param1</code></em> :</span></p></td><td>the first user parameter (if any) specified
with the <PYGTKDOCLINK HREF="method-gobject--connect"><code class="methodname">connect</code>()</PYGTKDOCLINK>
method</td></tr><tr><td><p><span class="term"><em class="parameter"><code>...</code></em> :</span></p></td><td>additional user parameters (if any)</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This signal is available in PyGTK 2.12 and above.</p></div><p>The "popup" signal is a keybinding signal which gets emitted to popup
the combo box list. The default bindings for this signal are Alt+Down.</p></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-gtkcombo.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="gtk-class-reference.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="class-gtkcomboboxentry.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.Combo </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.ComboBoxEntry</td></tr></table></div></body></html>
|