/usr/share/gtk-doc/html/pygtk/class-gtkcellrenderercombo.html is in python-gtk2-doc 2.24.0-4ubuntu1.
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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.CellRendererCombo</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-gtkcellrendereraccel.html" title="gtk.CellRendererAccel"><link rel="next" href="class-gtkcellrendererpixbuf.html" title="gtk.CellRendererPixbuf"></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.CellRendererCombo</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkcellrendereraccel.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkcellrendererpixbuf.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.CellRendererCombo"><a name="class-gtkcellrenderercombo"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.CellRendererCombo</h2><p>gtk.CellRendererCombo — an object that
renders a <a class="link" href="class-gtkcomboboxentry.html" title="gtk.ComboBoxEntry"><code class="classname">gtk.ComboBoxEntry</code></a>
into a <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>
cell (new in PyGTK 2.6)</p></div><div class="refsect1" title="Synopsis"><a name="id3632895"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.CellRendererCombo</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkcellrenderertext.html" title="gtk.CellRendererText">gtk.CellRendererText</a></span></span>):
<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtkcellrenderercombo.html#constructor-gtkcellrenderercombo" title="Constructor">gtk.CellRendererCombo</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id3632938"></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-gtkcellrenderer.html" title="gtk.CellRenderer">gtk.CellRenderer</a>
+-- <a class="link" href="class-gtkcellrenderertext.html" title="gtk.CellRendererText">gtk.CellRendererText</a>
+-- <a class="link" href="class-gtkcellrenderercombo.html" title="gtk.CellRendererCombo">gtk.CellRendererCombo</a>
</pre></div><div class="refsect1" title="gtk.CellRendererCombo Properties"><a name="properties-gtkcellrenderercombo"></a><h2>gtk.CellRendererCombo 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-gtkcellrenderer.html#properties-gtkcellrenderer" title="gtk.CellRenderer Properties">gtk.CellRenderer Properties</a></p><p><a class="link" href="class-gtkcellrenderertext.html#properties-gtkcellrenderertext" title="gtk.CellRendererText Properties">gtk.CellRendererText 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">"has-entry"</td><td valign="top">Read/Write</td><td valign="top">If <code class="literal">False</code>, don't allow entering strings
other than the given ones. 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 tree model containing the possible values for the combo
box entry. Available in GTK+ 2.6 and above.</td></tr><tr valign="top"><td valign="top">"text-column"</td><td valign="top">Read/Write</td><td valign="top">A column in the data source model to get the strings from.
Allowed values: >= -1. Default value: -1. Available in GTK+ 2.6 and
above.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.CellRendererCombo Signal Prototypes"><a name="signal-prototypes-gtkcellrenderercombo"></a><h2>gtk.CellRendererCombo 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-gtkcellrenderer.html#signal-prototypes-gtkcellrenderer" title="gtk.CellRenderer Signal Prototypes">gtk.CellRenderer Signal Prototypes</a></p><p><a class="link" href="class-gtkcellrenderertext.html#signal-prototypes-gtkcellrenderertext" title="gtk.CellRendererText Signal Prototypes">gtk.CellRendererText 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-gtkcellrenderercombo.html#signal-gtkcellrenderercombo--changed" title='The "changed" gtk.CellRendererCombo 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>combo</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path_string</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>new_iter</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="id3633215"></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 object is available in PyGTK 2.6 and above.</p></div><p>The <a class="link" href="class-gtkcellrenderercombo.html" title="gtk.CellRendererCombo"><code class="classname">gtk.CellRendererCombo</code></a>
manages the rendering of a <a class="link" href="class-gtkcomboboxentry.html" title="gtk.ComboBoxEntry"><code class="classname">gtk.ComboBoxEntry</code></a>
into a <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>
cell.</p></div><div class="refsect1" title="Constructor"><a name="constructor-gtkcellrenderercombo"></a><h2>Constructor</h2><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.CellRendererCombo</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 new cell renderer</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.6 and above.</p></div><p>Creates a new <a class="link" href="class-gtkcellrenderercombo.html" title="gtk.CellRendererCombo"><code class="classname">gtk.CellRendererCombo</code></a>.
Rendering parameters are adjusted using the object properties. The object
properties can be set globally (with <PYGTKDOCLINK HREF="method-gobject--set-property"><code class="methodname">set_property</code>()</PYGTKDOCLINK>).
Also, with <a class="link" href="class-gtktreeviewcolumn.html" title="gtk.TreeViewColumn"><code class="classname">gtk.TreeViewColumn</code></a>,
you can bind a property to a value in a <a class="link" href="class-gtktreemodel.html" title="gtk.TreeModel"><code class="classname">gtk.TreeModel</code></a>.
For example, you can bind the "text" property on the cell renderer to a
string value in the model, thus rendering a different string in each row of
the <a class="link" href="class-gtktreeview.html" title="gtk.TreeView"><code class="classname">gtk.TreeView</code></a>.</p></div><div class="refsect1" title="Signals"><a name="id3633340"></a><h2>Signals</h2><div class="refsect2" title='The "changed" gtk.CellRendererCombo Signal'><a name="signal-gtkcellrenderercombo--changed"></a><h3>The "changed" gtk.CellRendererCombo Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>combo</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>path_string</code></em></span></span>, <span class="methodparam"><span class="parameter"><em class="parameter"><code>new_iter</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>combo</code></em> :</span></p></td><td>the object on which the signal is emitted </td></tr><tr><td><p><span class="term"><em class="parameter"><code>path_string</code></em> :</span></p></td><td>a string of the path identifying the edited cell
(relative to the tree view model) </td></tr><tr><td><p><span class="term"><em class="parameter"><code>new_iter</code></em> :</span></p></td><td>the new iter selected in the combo box
(relative to the combo box model) </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><p>
The "changed" signal is emitted each time after the user selected an item in
the combo box, either by using the mouse or the arrow keys. Contrary to GtkComboBox,
GtkCellRendererCombo::changed is not emitted for changes made to a selected item in
the entry. The argument new_iter corresponds to the newly selected item in the combo
box and it is relative to the GtkTreeModel set via the model property on GtkCellRendererCombo.
</p><p>
Note that as soon as you change the model displayed in the tree view, the tree view will
immediately cease the editing operating. This means that you most probably want to refrain
from changing the model until the combo cell renderer emits the edited or editing_canceled signal.
</p><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></div></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="class-gtkcellrendereraccel.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-gtkcellrendererpixbuf.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.CellRendererAccel </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.CellRendererPixbuf</td></tr></table></div></body></html>
|