1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.Combo</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.73.2"><link rel="start" 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-gtkcolorselectiondialog.html" title="gtk.ColorSelectionDialog"><link rel="next" href="class-gtkcombobox.html" title="gtk.ComboBox"></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.Combo</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkcolorselectiondialog.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkcombobox.html">Next</a></td></tr></table><hr></div><div class="refentry" lang="en"><a name="class-gtkcombo"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.Combo</h2><p>gtk.Combo — a text entry field with a dropdown list.</p></div><div class="refsect1" lang="en"><a name="id3455332"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.Combo</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkhbox.html" title="gtk.HBox">gtk.HBox</a></span></span>):
2
<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtkcombo.html#constructor-gtkcombo" title="Constructor">gtk.Combo</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--set-value-in-list" title="gtk.Combo.set_value_in_list">set_value_in_list</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>ok_if_empty</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--set-use-arrows" title="gtk.Combo.set_use_arrows">set_use_arrows</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--set-use-arrows-always" title="gtk.Combo.set_use_arrows_always">set_use_arrows_always</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--set-case-sensitive" title="gtk.Combo.set_case_sensitive">set_case_sensitive</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--set-item-string" title="gtk.Combo.set_item_string">set_item_string</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>item</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>item_value</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--set-popdown-strings" title="gtk.Combo.set_popdown_strings">set_popdown_strings</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>strings</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--disable-activate" title="gtk.Combo.disable_activate">disable_activate</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" lang="en"><a name="id3455560"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.Combo</title><link rel="stylesheet" href="style.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.1"><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-gtkcolorselectiondialog.html" title="gtk.ColorSelectionDialog"><link rel="next" href="class-gtkcombobox.html" title="gtk.ComboBox"></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.Combo</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkcolorselectiondialog.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkcombobox.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.Combo"><a name="class-gtkcombo"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.Combo</h2><p>gtk.Combo — a text entry field with a dropdown list.</p></div><div class="refsect1" title="Synopsis"><a name="id3764503"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.Combo</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkhbox.html" title="gtk.HBox">gtk.HBox</a></span></span>):
2
<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtkcombo.html#constructor-gtkcombo" title="Constructor">gtk.Combo</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--set-value-in-list" title="gtk.Combo.set_value_in_list">set_value_in_list</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>ok_if_empty</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--set-use-arrows" title="gtk.Combo.set_use_arrows">set_use_arrows</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--set-use-arrows-always" title="gtk.Combo.set_use_arrows_always">set_use_arrows_always</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--set-case-sensitive" title="gtk.Combo.set_case_sensitive">set_case_sensitive</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--set-item-string" title="gtk.Combo.set_item_string">set_item_string</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>item</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>item_value</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--set-popdown-strings" title="gtk.Combo.set_popdown_strings">set_popdown_strings</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>strings</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkcombo.html#method-gtkcombo--disable-activate" title="gtk.Combo.disable_activate">disable_activate</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id3764730"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
3
3
+-- <a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a>
4
4
+-- <a class="link" href="class-gtkwidget.html" title="gtk.Widget">gtk.Widget</a>
5
5
+-- <a class="link" href="class-gtkcontainer.html" title="gtk.Container">gtk.Container</a>
6
6
+-- <a class="link" href="class-gtkbox.html" title="gtk.Box">gtk.Box</a>
7
7
+-- <a class="link" href="class-gtkhbox.html" title="gtk.HBox">gtk.HBox</a>
8
8
+-- <a class="link" href="class-gtkcombo.html" title="gtk.Combo">gtk.Combo</a>
9
</pre></div><div class="refsect1" lang="en"><a name="id3455608"></a><h2>Implemented Interfaces</h2><p>
9
</pre></div><div class="refsect1" title="Implemented Interfaces"><a name="id3764778"></a><h2>Implemented Interfaces</h2><p>
10
10
<a class="link" href="class-gtkcombo.html" title="gtk.Combo"><code class="classname">gtk.Combo</code></a>
12
12
<a class="link" href="class-gtkbuildable.html" title="gtk.Buildable"><code class="classname">gtk.Buildable</code></a>
13
</p></div><div class="refsect1" lang="en"><a name="properties-gtkcombo"></a><h2>gtk.Combo 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><p><a class="link" href="class-gtkbox.html#properties-gtkbox" title="gtk.Box Properties">gtk.Box 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><col><col></colgroup><tbody><tr valign="top"><td valign="top">"allow-empty"</td><td valign="top">Read/Write</td><td valign="top">If <code class="literal">True</code>, an empty value may be entered
13
</p></div><div class="refsect1" title="gtk.Combo Properties"><a name="properties-gtkcombo"></a><h2>gtk.Combo 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><p><a class="link" href="class-gtkbox.html#properties-gtkbox" title="gtk.Box Properties">gtk.Box 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="3.5in"></colgroup><tbody><tr valign="top"><td valign="top">"allow-empty"</td><td valign="top">Read/Write</td><td valign="top">If <code class="literal">True</code>, an empty value may be entered
14
14
in this field</td></tr><tr valign="top"><td valign="top">"case-sensitive"</td><td valign="top">Read/Write</td><td valign="top">If <code class="literal">True</code>, list item matching is case
15
15
sensitive</td></tr><tr valign="top"><td valign="top">"enable-arrow-keys"</td><td valign="top">Read/Write</td><td valign="top">If <code class="literal">True</code>, the arrow keys move through the
16
16
list of items</td></tr><tr valign="top"><td valign="top">"enable-arrows-always"</td><td valign="top">Read/Write</td><td valign="top">If <code class="literal">True</code>, the arrow keys work, even if
17
17
the entry contents are not in the list</td></tr><tr valign="top"><td valign="top">"value-in-list"</td><td valign="top">Read/Write</td><td valign="top">If <code class="literal">True</code>, entered values must already be
18
present in the list</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" lang="en"><a name="style-properties-gtkcombo"></a><h2>gtk.Combo 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><div class="refsect1" lang="en"><a name="child-properties-gtkcombo"></a><h2>gtk.Combo Child Properties</h2><p><a class="link" href="class-gtkbox.html#child-properties-gtkbox" title="gtk.Box Child Properties">gtk.Box Child Properties</a></p></div><div class="refsect1" lang="en"><a name="id3455838"></a><h2>Attributes</h2><div class="blockquote"><table width="100%" border="0" bgcolor="#E0E0E0"><tr><td valign="top"><div class="informaltable"><table width="100%" border="0"><colgroup><col><col><col></colgroup><tbody><tr valign="top"><td valign="top">"entry"</td><td valign="top">Read</td><td valign="top">the text entry widget</td></tr><tr valign="top"><td valign="top">"list"</td><td valign="top">Read</td><td valign="top">the list shown in the drop-down window</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" lang="en"><a name="signal-prototypes-gtkcombo"></a><h2>gtk.Combo 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></div><div class="refsect1" lang="en"><a name="id3455947"></a><h2>Description</h2><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The <a class="link" href="class-gtkcombo.html" title="gtk.Combo"><code class="classname">gtk.Combo</code></a> is
18
present in the list</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.Combo Style Properties"><a name="style-properties-gtkcombo"></a><h2>gtk.Combo 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><div class="refsect1" title="gtk.Combo Child Properties"><a name="child-properties-gtkcombo"></a><h2>gtk.Combo Child Properties</h2><p><a class="link" href="class-gtkbox.html#child-properties-gtkbox" title="gtk.Box Child Properties">gtk.Box Child Properties</a></p></div><div class="refsect1" title="Attributes"><a name="id3765008"></a><h2>Attributes</h2><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="3.5in"></colgroup><tbody><tr valign="top"><td valign="top">"entry"</td><td valign="top">Read</td><td valign="top">the text entry widget</td></tr><tr valign="top"><td valign="top">"list"</td><td valign="top">Read</td><td valign="top">the list shown in the drop-down window</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.Combo Signal Prototypes"><a name="signal-prototypes-gtkcombo"></a><h2>gtk.Combo 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></div><div class="refsect1" title="Description"><a name="id3765117"></a><h2>Description</h2><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>The <a class="link" href="class-gtkcombo.html" title="gtk.Combo"><code class="classname">gtk.Combo</code></a> is
19
19
deprecated in GTK+ 2.4 and PyGTK 2.4 in favor of the <a class="link" href="class-gtkcombobox.html" title="gtk.ComboBox"><code class="classname">gtk.ComboBox</code></a>.</p></div><p>The <a class="link" href="class-gtkcombo.html" title="gtk.Combo"><code class="classname">gtk.Combo</code></a> widget
20
20
consists of a single-line text entry field and a drop-down list. The
21
21
drop-down list is displayed when the user clicks on a small arrow button to
38
38
the up or down arrow key will set the entry field to the last or first item
39
39
in the list, respectively.</p><p>Note the list attribute references a gtk.List which is a
40
40
deprecated widget so the combo widget may be changed or deprecated in the
41
future.</p></div><div class="refsect1" lang="en"><a name="constructor-gtkcombo"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.Combo</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 combo object*</td></tr></tbody></table><p>Creates an new <a class="link" href="class-gtkcombo.html" title="gtk.Combo"><code class="classname">gtk.Combo</code></a>
42
object.</p></div><div class="refsect1" lang="en"><a name="id3456090"></a><h2>Methods</h2><div class="refsect2" lang="en"><a name="method-gtkcombo--set-value-in-list"></a><h3>gtk.Combo.set_value_in_list</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_value_in_list</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>ok_if_empty</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>val</code></strong> :</span></p></td><td>If True the value entered must match one of the
41
future.</p></div><div class="refsect1" title="Constructor"><a name="constructor-gtkcombo"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.Combo</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 combo object*</td></tr></tbody></table><p>Creates an new <a class="link" href="class-gtkcombo.html" title="gtk.Combo"><code class="classname">gtk.Combo</code></a>
42
object.</p></div><div class="refsect1" title="Methods"><a name="id3765260"></a><h2>Methods</h2><div class="refsect2" title="gtk.Combo.set_value_in_list"><a name="method-gtkcombo--set-value-in-list"></a><h3>gtk.Combo.set_value_in_list</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_value_in_list</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>ok_if_empty</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>val</code></strong> :</span></p></td><td>If True the value entered must match one of the
43
43
values in the list.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>ok_if_empty</code></strong> :</span></p></td><td>If True an empty value is considered
44
44
valid.</td></tr></tbody></table><p>The <code class="methodname">set_value_in_list</code>() method
45
45
specifies whether the value entered in the text entry field must match one
48
48
the value of <em class="parameter"><code>ok_if_empty</code></em>.</p><p>If <em class="parameter"><code>val</code></em> is True the user will not be able
49
49
to perform any other action (the widget grabs the focus) until a valid value
50
50
has been entered. If <em class="parameter"><code>ok_if_empty</code></em> is True an empty
51
field is considered an acceptable value.</p></div><div class="refsect2" lang="en"><a name="method-gtkcombo--set-use-arrows"></a><h3>gtk.Combo.set_use_arrows</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_use_arrows</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</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>val</code></strong> :</span></p></td><td>If True can be used to navigate through the
51
field is considered an acceptable value.</p></div><div class="refsect2" title="gtk.Combo.set_use_arrows"><a name="method-gtkcombo--set-use-arrows"></a><h3>gtk.Combo.set_use_arrows</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_use_arrows</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</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>val</code></strong> :</span></p></td><td>If True can be used to navigate through the
52
52
list items</td></tr></tbody></table><p>The <code class="methodname">set_use_arrows</code>() method sets the
53
53
"enable-use-arrows" property to the value of <em class="parameter"><code>val</code></em>. If
54
54
<em class="parameter"><code>val</code></em> is True the arrows keys can be used to navigate
55
through the list items.</p></div><div class="refsect2" lang="en"><a name="method-gtkcombo--set-use-arrows-always"></a><h3>gtk.Combo.set_use_arrows_always</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_use_arrows_always</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</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>val</code></strong> :</span></p></td><td>If True the arrow keys will still work even if
55
through the list items.</p></div><div class="refsect2" title="gtk.Combo.set_use_arrows_always"><a name="method-gtkcombo--set-use-arrows-always"></a><h3>gtk.Combo.set_use_arrows_always</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_use_arrows_always</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</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>val</code></strong> :</span></p></td><td>If True the arrow keys will still work even if
56
56
the text entry field does not match any of the list
57
57
items.</td></tr></tbody></table><p>The <code class="methodname">set_use_arrows_always</code>() method sets
58
58
the "enable-arrows-always" property to the values of
59
59
<em class="parameter"><code>val</code></em>. If <em class="parameter"><code>val</code></em> is True the arrow
60
60
keys will work even if the text entry field does not match any of the list
61
items.</p></div><div class="refsect2" lang="en"><a name="method-gtkcombo--set-case-sensitive"></a><h3>gtk.Combo.set_case_sensitive</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_case_sensitive</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</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>val</code></strong> :</span></p></td><td>If True the text in the list items is case
61
items.</p></div><div class="refsect2" title="gtk.Combo.set_case_sensitive"><a name="method-gtkcombo--set-case-sensitive"></a><h3>gtk.Combo.set_case_sensitive</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_case_sensitive</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>val</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>val</code></strong> :</span></p></td><td>If True the text in the list items is case
62
62
sensitive.</td></tr></tbody></table><p>The <code class="methodname">set_case_sensitive</code>() method sets
63
63
the "case-sensitive" property to the value of <em class="parameter"><code>val</code></em>. If
64
64
<em class="parameter"><code>val</code></em> is True the text in the combo list items and the
65
65
text entry field are case sensitive. The default value of
66
"set-case-sensitive" is False.</p></div><div class="refsect2" lang="en"><a name="method-gtkcombo--set-item-string"></a><h3>gtk.Combo.set_item_string</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_item_string</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>item</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>item_value</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>item</code></strong> :</span></p></td><td>a list item</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>item_value</code></strong> :</span></p></td><td>a string to place in the entry field when
66
"set-case-sensitive" is False.</p></div><div class="refsect2" title="gtk.Combo.set_item_string"><a name="method-gtkcombo--set-item-string"></a><h3>gtk.Combo.set_item_string</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_item_string</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>item</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>item_value</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>item</code></strong> :</span></p></td><td>a list item</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>item_value</code></strong> :</span></p></td><td>a string to place in the entry field when
67
67
<em class="parameter"><code>item</code></em> is selected</td></tr></tbody></table><p>The <code class="methodname">set_item_string</code>() method sets the
68
68
string (from <em class="parameter"><code>item_value</code></em>) to place in the combo text
69
69
entry field when the <em class="parameter"><code>item</code></em> is selected. This method is
70
70
only needed if the list item is other than a simple label (e.g. a
71
pixmap).</p></div><div class="refsect2" lang="en"><a name="method-gtkcombo--set-popdown-strings"></a><h3>gtk.Combo.set_popdown_strings</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_popdown_strings</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>strings</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>strings</code></strong> :</span></p></td><td>a list of strings to populate the
71
pixmap).</p></div><div class="refsect2" title="gtk.Combo.set_popdown_strings"><a name="method-gtkcombo--set-popdown-strings"></a><h3>gtk.Combo.set_popdown_strings</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_popdown_strings</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>strings</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>strings</code></strong> :</span></p></td><td>a list of strings to populate the
72
72
list</td></tr></tbody></table><p>The <code class="methodname">set_popdown_strings</code>() method is a
73
73
convenience method that sets the strings used in the popdown list from.
74
<em class="parameter"><code>strings</code></em> (a Python list or tuple object).</p></div><div class="refsect2" lang="en"><a name="method-gtkcombo--disable-activate"></a><h3>gtk.Combo.disable_activate</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">disable_activate</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">disable_activate</code>() method prevents
74
<em class="parameter"><code>strings</code></em> (a Python list or tuple object).</p></div><div class="refsect2" title="gtk.Combo.disable_activate"><a name="method-gtkcombo--disable-activate"></a><h3>gtk.Combo.disable_activate</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">disable_activate</span>(<span class="methodparam"></span>)</code></pre><p>The <code class="methodname">disable_activate</code>() method prevents
75
75
the combo from showing the popup list when the entry emits the "activate"
76
76
signal, i.e. when the <span class="keycap"><strong>Return</strong></span> key is pressed. This may be
77
77
useful if, for example, you want the <span class="keycap"><strong>Return</strong></span> key to close a
added
removed
docs/html/class-gtkcombo.html
