/usr/share/gtk-doc/html/pygtk/class-gtkrecentchooser.html is in python-gtk2-doc 2.24.0-3.
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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.RecentChooser</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-gtkrecentchooserwidget.html" title="gtk.RecentChooserWidget"><link rel="next" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"></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.RecentChooser</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkrecentchooserwidget.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkrecentfilter.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.RecentChooser"><a name="class-gtkrecentchooser"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.RecentChooser</h2><p>gtk.RecentChooser — an interface implemented by <a class="link" href="class-gtkrecentchooserwidget.html" title="gtk.RecentChooserWidget"><code class="classname">gtk.RecentChooserWidget</code></a>,
<a class="link" href="class-gtkrecentchoosermenu.html" title="gtk.RecentChooserMenu"><code class="classname">gtk.RecentChooserMenu</code></a>
and <a class="link" href="class-gtkrecentchooserdialog.html" title="gtk.RecentChooserDialog"><code class="classname">gtk.RecentChooserDialog</code></a> (new in PyGTK 2.10)
</p></div><div class="refsect1" title="Synopsis"><a name="id3868313"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.RecentChooser</span></span>:
<code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-show-private" title="gtk.RecentChooser.set_show_private">set_show_private</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>show_private</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-show-private" title="gtk.RecentChooser.get_show_private">get_show_private</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-show-not-found" title="gtk.RecentChooser.set_show_not_found">set_show_not_found</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>show_not_found</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-show-not-found" title="gtk.RecentChooser.get_show_not_found">get_show_not_found</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-select-multiple" title="gtk.RecentChooser.set_select_multiple">set_select_multiple</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>select_multiple</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-select-multiple" title="gtk.RecentChooser.get_select_multiple">get_select_multiple</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-limit" title="gtk.RecentChooser.set_limit">set_limit</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>limit</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-limit" title="gtk.RecentChooser.get_limit">get_limit</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-local-only" title="gtk.RecentChooser.set_local_only">set_local_only</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>local_only</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-local-only" title="gtk.RecentChooser.get_local_only">get_local_only</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-show-tips" title="gtk.RecentChooser.set_show_tips">set_show_tips</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>show_tips</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-show-tips" title="gtk.RecentChooser.get_show_tips">get_show_tips</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-show-numbers" title="gtk.RecentChooser.set_show_numbers">set_show_numbers</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>show_numbers</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-show-numbers" title="gtk.RecentChooser.get_show_numbers">get_show_numbers</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-show-icons" title="gtk.RecentChooser.set_show_icons">set_show_icons</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>show_icons</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-show-icons" title="gtk.RecentChooser.get_show_icons">get_show_icons</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-sort-type" title="gtk.RecentChooser.set_sort_type">set_sort_type</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>sort_type</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-sort-type" title="gtk.RecentChooser.get_sort_type">get_sort_type</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-sort-func" title="gtk.RecentChooser.set_sort_func">set_sort_func</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>sort_func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>sort_data</code></strong></span><span class="initializer">=None</span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-current-uri" title="gtk.RecentChooser.set_current_uri">set_current_uri</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>uri</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-current-uri" title="gtk.RecentChooser.get_current_uri">get_current_uri</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-current-item" title="gtk.RecentChooser.get_current_item">get_current_item</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--select-uri" title="gtk.RecentChooser.select_uri">select_uri</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>uri</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--unselect-uri" title="gtk.RecentChooser.unselect_uri">unselect_uri</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>uri</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--select-all" title="gtk.RecentChooser.select_all">select_all</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--unselect-all" title="gtk.RecentChooser.unselect_all">unselect_all</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-items" title="gtk.RecentChooser.get_items">get_items</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-uris" title="gtk.RecentChooser.get_uris">get_uris</a></span>()</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--add-filter" title="gtk.RecentChooser.add_filter">add_filter</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filter</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--remove-filter" title="gtk.RecentChooser.remove_filter">remove_filter</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filter</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--list-filters" title="gtk.RecentChooser.list_filters">list_filters</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-filter" title="gtk.RecentChooser.set_filter">set_filter</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filter</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-filter" title="gtk.RecentChooser.get_filter">get_filter</a></span>(<span class="methodparam"></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id3869134"></a><h2>Ancestry</h2><pre class="synopsis">+-- <a class="link" href="class-gtkrecentchooser.html" title="gtk.RecentChooser">gtk.RecentChooser</a>
</pre></div><div class="refsect1" title="gtk.RecentChooser Properties"><a name="properties-gtkrecentchooser"></a><h2>gtk.RecentChooser Properties</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">"filter"</td><td valign="top">Read-Write</td><td valign="top">The current <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</code></a>
for selecting which resources are displayed</td></tr><tr valign="top"><td valign="top">"limit"</td><td valign="top">Read-Write</td><td valign="top">The maximum number of items to be displayed</td></tr><tr valign="top"><td valign="top">"local-only"</td><td valign="top">Read-Write</td><td valign="top">if <code class="literal">True</code> the selected resource(s) should
be limited to local file: URIs</td></tr><tr valign="top"><td valign="top">"recent-manager"</td><td valign="top">Write-Construct Only</td><td valign="top">The RecentManager object to use</td></tr><tr valign="top"><td valign="top">"select-multiple"</td><td valign="top">Read-Write</td><td valign="top">if <code class="literal">True</code> allow multiple items to be
selected</td></tr><tr valign="top"><td valign="top">"show-icons"</td><td valign="top">Read-Write</td><td valign="top">if <code class="literal">True</code> there should be an icon near the
item</td></tr><tr valign="top"><td valign="top">"show-not-found"</td><td valign="top">Read-Write</td><td valign="top">if <code class="literal">True</code> the items pointing to
unavailable resources should be displayed</td></tr><tr valign="top"><td valign="top">"show-private"</td><td valign="top">Read-Write</td><td valign="top">if <code class="literal">True</code> the private items should be
displayed</td></tr><tr valign="top"><td valign="top">"show-tips"</td><td valign="top">Read-Write</td><td valign="top">if <code class="literal">True</code> there should be a tooltip on the
item</td></tr><tr valign="top"><td valign="top">"sort-type"</td><td valign="top">Read-Write</td><td valign="top">The sorting order of the items displayed - one of the <a class="xref" href="gtk-constants.html#gtk-recent-sort-type-constants" title="GTK Recent Sort Type Constants">GTK Recent Sort Type Constants</a></td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.RecentChooser Signal Prototypes"><a name="signal-prototypes-gtkrecentchooser"></a><h2>gtk.RecentChooser Signal Prototypes</h2><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-gtkrecentchooser.html#signal-gtkrecentchooser--item-activated" title='The "item-activated" gtk.RecentChooser Signal'>item-activated</a></span></p></td><td><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>chooser</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-gtkrecentchooser.html#signal-gtkrecentchooser--selection-changed" title='The "selection-changed" gtk.RecentChooser Signal'>selection-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>chooser</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="id3869578"></a><h2>Description</h2><p><a class="link" href="class-gtkrecentchooser.html" title="gtk.RecentChooser"><code class="classname">gtk.RecentChooser</code></a>
is an interface that can be implemented by widgets displaying the list
of recently used files. In PyGTK, the main objects that implement this
interface are <a class="link" href="class-gtkrecentchooserwidget.html" title="gtk.RecentChooserWidget"><code class="classname">gtk.RecentChooserWidget</code></a>,
<a class="link" href="class-gtkrecentchooserdialog.html" title="gtk.RecentChooserDialog"><code class="classname">gtk.RecentChooserDialog</code></a>
and <a class="link" href="class-gtkrecentchoosermenu.html" title="gtk.RecentChooserMenu"><code class="classname">gtk.RecentChooserMenu</code></a>.</p><p>Recently used files are supported since GTK+ 2.10.</p></div><div class="refsect1" title="Methods"><a name="id3869625"></a><h2>Methods</h2><div class="refsect2" title="gtk.RecentChooser.set_show_private"><a name="method-gtkrecentchooser--set-show-private"></a><h3>gtk.RecentChooser.set_show_private</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_show_private</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>show_private</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>show_private</code></strong> :</span></p></td><td>if <code class="literal">True</code> show private
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.10 and above.</p></div><p>Sets the "show-private" property to the value of
<em class="parameter"><code>show_private</code></em>. If
<em class="parameter"><code>show_private</code></em> is <code class="literal">True</code> show
recently used resources marked registered as private.</p></div><div class="refsect2" title="gtk.RecentChooser.get_show_private"><a name="method-gtkrecentchooser--get-show-private"></a><h3>gtk.RecentChooser.get_show_private</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_show_private</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 recent chooser
should show private 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.10 and above.</p></div><p>Returns <code class="literal">True</code> if recently used resources
registered as private should be displayed.</p></div><div class="refsect2" title="gtk.RecentChooser.set_show_not_found"><a name="method-gtkrecentchooser--set-show-not-found"></a><h3>gtk.RecentChooser.set_show_not_found</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_show_not_found</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>show_not_found</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>show_not_found</code></strong> :</span></p></td><td>if <code class="literal">True</code> show the local items
we didn't find</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>Sets the "show-not'found" property to the value specified by
<em class="parameter"><code>show_not_found</code></em>. If
<em class="parameter"><code>show_not_found</code></em> is <code class="literal">True</code>,
display the recently used resources that it didn't find. This only
applies to local resources.</p></div><div class="refsect2" title="gtk.RecentChooser.get_show_not_found"><a name="method-gtkrecentchooser--get-show-not-found"></a><h3>gtk.RecentChooser.get_show_not_found</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_show_not_found</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 resources not
found should be displayed.</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>Returns <code class="literal">True</code> if the recently used resources
that were not found shoudl be shown.</p></div><div class="refsect2" title="gtk.RecentChooser.set_select_multiple"><a name="method-gtkrecentchooser--set-select-multiple"></a><h3>gtk.RecentChooser.set_select_multiple</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_select_multiple</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>select_multiple</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>select_multiple</code></strong> :</span></p></td><td>if <code class="literal">True</code> more than one item
can 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.10 and above.</p></div><p>Sets the "select-multiple" property to the value of
<em class="parameter"><code>select_multiple</code></em>. If
<em class="parameter"><code>select_mulitple</code></em> is <code class="literal">True</code>
multiple items can be selected.</p></div><div class="refsect2" title="gtk.RecentChooser.get_select_multiple"><a name="method-gtkrecentchooser--get-select-multiple"></a><h3>gtk.RecentChooser.get_select_multiple</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_select_multiple</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 more than one item
can 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.10 and above.</p></div><p>Returns <code class="literal">True</code> if multiple items can be
selected.</p></div><div class="refsect2" title="gtk.RecentChooser.set_limit"><a name="method-gtkrecentchooser--set-limit"></a><h3>gtk.RecentChooser.set_limit</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_limit</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>limit</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>limit</code></strong> :</span></p></td><td>a positive integer, or -1 for all 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.10 and above.</p></div><p>Sets the number of items that should be returned by the <a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-items" title="gtk.RecentChooser.get_items"><code class="methodname">gtk.RecentChooser.get_items()</code></a>
and <a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-uris" title="gtk.RecentChooser.get_uris"><code class="methodname">gtk.RecentChooser.get_uris()</code></a>
methods.</p></div><div class="refsect2" title="gtk.RecentChooser.get_limit"><a name="method-gtkrecentchooser--get-limit"></a><h3>gtk.RecentChooser.get_limit</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_limit</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 positive integer, or -1 meaning that all
items are returned.</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>Returns the number of items that can be returned by the <a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-items" title="gtk.RecentChooser.get_items"><code class="methodname">gtk.RecentChooser.get_items()</code></a>
and <a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--get-uris" title="gtk.RecentChooser.get_uris"><code class="methodname">gtk.RecentChooser.get_uris()</code></a>
methods.</p></div><div class="refsect2" title="gtk.RecentChooser.set_local_only"><a name="method-gtkrecentchooser--set-local-only"></a><h3>gtk.RecentChooser.set_local_only</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_local_only</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>local_only</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>local_only</code></strong> :</span></p></td><td>if <code class="literal">True</code> only local files can
be shown</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>Sets the "local-only" property to the value of
<em class="parameter"><code>local_only</code></em>. If
<em class="parameter"><code>local_only</code></em> is <code class="literal">True</code> only
local resources, that is resources using the file:// URI scheme,
should be shown in the recently used resources selector. If
<em class="parameter"><code>local_only</code></em> is <code class="literal">True</code> (the
default) then the resources shown are guaranteed to be accessible
through the operating system native file system.</p></div><div class="refsect2" title="gtk.RecentChooser.get_local_only"><a name="method-gtkrecentchooser--get-local-only"></a><h3>gtk.RecentChooser.get_local_only</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_local_only</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 only local resources
should be shown.</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>Returns <code class="literal">True</code> if only local resources should
be shown in the recently used resources selector. See the <a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-local-only" title="gtk.RecentChooser.set_local_only"><code class="methodname">gtk.RecentChooser.set_local_only()</code></a>
method.</p></div><div class="refsect2" title="gtk.RecentChooser.set_show_tips"><a name="method-gtkrecentchooser--set-show-tips"></a><h3>gtk.RecentChooser.set_show_tips</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_show_tips</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>show_tips</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>show_tips</code></strong> :</span></p></td><td>if <code class="literal">True</code> tooltips should be
shown</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>Sets the "show-tips" property to the value of
<em class="parameter"><code>show_tips</code></em>. If <em class="parameter"><code>show_tips</code></em>
is <code class="literal">True</code>, show a tooltips on the widget.</p></div><div class="refsect2" title="gtk.RecentChooser.get_show_tips"><a name="method-gtkrecentchooser--get-show-tips"></a><h3>gtk.RecentChooser.get_show_tips</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_show_tips</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 recent chooser
should show tooltips.</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>Returns <code class="literal">True</code> if tooltips should be
displayed.</p></div><div class="refsect2" title="gtk.RecentChooser.set_show_numbers"><a name="method-gtkrecentchooser--set-show-numbers"></a><h3>gtk.RecentChooser.set_show_numbers</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_show_numbers</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>show_numbers</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>show_numbers</code></strong> :</span></p></td><td>if <code class="literal">True</code> show
numbers</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><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
This method is deprecated in PyGTK 2.12 and above and should not be
used in newly-written code.
Use <a class="link" href="class-gtkrecentchoosermenu.html#method-gtkrecentchoosermenu--set-show-numbers" title="gtk.RecentChooserMenu.set_show_numbers"><code class="methodname">gtk.RecentChooserMenu.set_show_numbers</code></a>() instead.
</p></div><p>Sets the "show-number" property to the value of
<em class="parameter"><code>show_numbers</code></em>. If
<em class="parameter"><code>show_numbers</code></em> is <code class="literal">True</code>, show
recently used resources prepended by a unique number.</p></div><div class="refsect2" title="gtk.RecentChooser.get_show_numbers"><a name="method-gtkrecentchooser--get-show-numbers"></a><h3>gtk.RecentChooser.get_show_numbers</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_show_numbers</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 recent chooser
should show display numbers.</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><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
This method is deprecated in PyGTK 2.12 and above and should not be
used in newly-written code.
Use <a class="link" href="class-gtkrecentchoosermenu.html#method-gtkrecentchoosermenu--get-show-numbers" title="gtk.RecentChooserMenu.get_show_numbers"><code class="methodname">gtk.RecentChooserMenu.get_show_numbers</code></a>() instead.
</p></div><p>Returns <code class="literal">True</code> if recently used resources
should be displayed prepended by a unique number.</p></div><div class="refsect2" title="gtk.RecentChooser.set_show_icons"><a name="method-gtkrecentchooser--set-show-icons"></a><h3>gtk.RecentChooser.set_show_icons</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_show_icons</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>show_icons</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>show_icons</code></strong> :</span></p></td><td>if <code class="literal">True</code> show an icon near
the resource</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>Sets the "show-icon" property to the value of
<em class="parameter"><code>show_icon</code></em>. If <em class="parameter"><code>show_icon</code></em>
is <code class="literal">True</code>, show an icon near the resource when
displaying it.</p></div><div class="refsect2" title="gtk.RecentChooser.get_show_icons"><a name="method-gtkrecentchooser--get-show-icons"></a><h3>gtk.RecentChooser.get_show_icons</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_show_icons</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 icons should be
displayed.</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>Returns <code class="literal">True</code> if an icon should be shown near
the resource.</p></div><div class="refsect2" title="gtk.RecentChooser.set_sort_type"><a name="method-gtkrecentchooser--set-sort-type"></a><h3>gtk.RecentChooser.set_sort_type</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_sort_type</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>sort_type</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>sort_type</code></strong> :</span></p></td><td>the sort order that the chooser should use -
one of the <a class="xref" href="gtk-constants.html#gtk-recent-sort-type-constants" title="GTK Recent Sort Type Constants">GTK Recent Sort Type Constants</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.10 and above.</p></div><p>Sets the sorting order of the recently used resources list to
the value specified by sort_type which must be one of the <a class="xref" href="gtk-constants.html#gtk-recent-sort-type-constants" title="GTK Recent Sort Type Constants">GTK Recent Sort Type Constants</a>.</p></div><div class="refsect2" title="gtk.RecentChooser.get_sort_type"><a name="method-gtkrecentchooser--get-sort-type"></a><h3>gtk.RecentChooser.get_sort_type</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_sort_type</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 sorting order - one of the <a class="xref" href="gtk-constants.html#gtk-recent-sort-type-constants" title="GTK Recent Sort Type Constants">GTK Recent Sort Type Constants</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.10 and above.</p></div><p>Returns the value set by the <a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-sort-type" title="gtk.RecentChooser.set_sort_type"><code class="methodname">gtk.RecentChooser.set_sort_type()</code>
method.</a>.</p></div><div class="refsect2" title="gtk.RecentChooser.set_sort_func"><a name="method-gtkrecentchooser--set-sort-func"></a><h3>gtk.RecentChooser.set_sort_func</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_sort_func</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>sort_func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>sort_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>sort_func</code></strong> :</span></p></td><td>the comparison function</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>sort_data</code></strong> :</span></p></td><td>user data to pass to <em class="parameter"><code>sort_func</code></em>, 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.10 and above.</p></div><p>Sets the comparison function specified by
<em class="parameter"><code>sort_func</code></em> to be used when sorting. If the
"sort-type" property is set to
<code class="literal">gtk.RECENT_SORT_CUSTOM</code>, the chooser will sort using
this function.</p><p>The signature of the comparison function is:</p><pre class="programlisting">
def sort_func(a, b, data):
</pre><p>where <em class="parameter"><code>a</code></em> and <em class="parameter"><code>b</code></em> are
two <a class="link" href="class-gtkrecentinfo.html" title="gtk.RecentInfo"><code class="classname">gtk.RecentInfo</code></a>
objects and <em class="parameter"><code>data</code></em> is
<em class="parameter"><code>sort_data</code></em>. <em class="parameter"><code>sort_func</code></em>
should return a positive integer if the first item comes before the
second, zero if the two items are equal and a negative integer if the
first item comes after the second.</p></div><div class="refsect2" title="gtk.RecentChooser.set_current_uri"><a name="method-gtkrecentchooser--set-current-uri"></a><h3>gtk.RecentChooser.set_current_uri</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_current_uri</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>uri</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>uri</code></strong> :</span></p></td><td>a URI</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if the URI was
found.</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>Sets <em class="parameter"><code>uri</code></em> as the current URI. Raises the
gobject.GError exception when an error occurs.</p></div><div class="refsect2" title="gtk.RecentChooser.get_current_uri"><a name="method-gtkrecentchooser--get-current-uri"></a><h3>gtk.RecentChooser.get_current_uri</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_current_uri</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 URI.</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>Returns the currently selected URI.</p></div><div class="refsect2" title="gtk.RecentChooser.get_current_item"><a name="method-gtkrecentchooser--get-current-item"></a><h3>gtk.RecentChooser.get_current_item</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_current_item</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-gtkrecentinfo.html" title="gtk.RecentInfo"><code class="classname">gtk.RecentInfo</code></a>
object.</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>Returns the <a class="link" href="class-gtkrecentinfo.html" title="gtk.RecentInfo"><code class="classname">gtk.RecentInfo</code></a>
for the currently selected item.</p></div><div class="refsect2" title="gtk.RecentChooser.select_uri"><a name="method-gtkrecentchooser--select-uri"></a><h3>gtk.RecentChooser.select_uri</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">select_uri</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>uri</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>uri</code></strong> :</span></p></td><td>a URI</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> if
<em class="parameter"><code>uri</code></em> was found.</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>Selects <em class="parameter"><code>uri</code></em>. Raises the gobject.GError
exception when an error occurs.</p></div><div class="refsect2" title="gtk.RecentChooser.unselect_uri"><a name="method-gtkrecentchooser--unselect-uri"></a><h3>gtk.RecentChooser.unselect_uri</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">unselect_uri</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>uri</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>uri</code></strong> :</span></p></td><td>a URI</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>Unselects <em class="parameter"><code>uri</code></em>.</p></div><div class="refsect2" title="gtk.RecentChooser.select_all"><a name="method-gtkrecentchooser--select-all"></a><h3>gtk.RecentChooser.select_all</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">select_all</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.10 and above.</p></div><p>Selects all the items inside <em class="parameter"><code>chooser</code></em>, if
the "select-multiple" property is <code class="literal">True</code>.</p></div><div class="refsect2" title="gtk.RecentChooser.unselect_all"><a name="method-gtkrecentchooser--unselect-all"></a><h3>gtk.RecentChooser.unselect_all</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">unselect_all</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.10 and above.</p></div><p>Unselects all the items.</p></div><div class="refsect2" title="gtk.RecentChooser.get_items"><a name="method-gtkrecentchooser--get-items"></a><h3>gtk.RecentChooser.get_items</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_items</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 list of <a class="link" href="class-gtkrecentinfo.html" title="gtk.RecentInfo"><code class="classname">gtk.RecentInfo</code></a>
objects.</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>Returns the list of recently used resources in form of <a class="link" href="class-gtkrecentinfo.html" title="gtk.RecentInfo"><code class="classname">gtk.RecentInfo</code></a>
objects.</p><p>The return value of this function is affected by the "sort-type"
and "limit" properties.</p></div><div class="refsect2" title="gtk.RecentChooser.get_uris"><a name="method-gtkrecentchooser--get-uris"></a><h3>gtk.RecentChooser.get_uris</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_uris</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 list of strings.</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>Returns a list of the URIs of the recently used
resources.</p><p>The return value of this function is affected by the "sort-type"
and "limit" properties>.</p></div><div class="refsect2" title="gtk.RecentChooser.add_filter"><a name="method-gtkrecentchooser--add-filter"></a><h3>gtk.RecentChooser.add_filter</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">add_filter</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filter</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>filter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</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.10 and above.</p></div><p>Adds <em class="parameter"><code>filter</code></em> to the list of <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</code></a>
objects.</p><p>If no previous filter objects were defined, this method will
call the <a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--set-filter" title="gtk.RecentChooser.set_filter"><code class="methodname">gtk.RecentChooser.set_filter()</code></a>
method.</p></div><div class="refsect2" title="gtk.RecentChooser.remove_filter"><a name="method-gtkrecentchooser--remove-filter"></a><h3>gtk.RecentChooser.remove_filter</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">remove_filter</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filter</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>filter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</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.10 and above.</p></div><p>Removes <em class="parameter"><code>filter</code></em> from the list of <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</code></a>
objects.</p></div><div class="refsect2" title="gtk.RecentChooser.list_filters"><a name="method-gtkrecentchooser--list-filters"></a><h3>gtk.RecentChooser.list_filters</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">list_filters</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 list of <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</code></a>
objects..</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>Returns a list of the <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</code></a>
objects.</p></div><div class="refsect2" title="gtk.RecentChooser.set_filter"><a name="method-gtkrecentchooser--set-filter"></a><h3>gtk.RecentChooser.set_filter</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_filter</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filter</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>filter</code></strong> :</span></p></td><td>a <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</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.10 and above.</p></div><p>Sets <em class="parameter"><code>filter</code></em> as the current <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</code></a>
object used by the recent chooser to filter the displayed recently
used resources.</p></div><div class="refsect2" title="gtk.RecentChooser.get_filter"><a name="method-gtkrecentchooser--get-filter"></a><h3>gtk.RecentChooser.get_filter</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">get_filter</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-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</code></a>
object.</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>Returns the currently used <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</code></a>
object.</p></div></div><div class="refsect1" title="Signals"><a name="id3872592"></a><h2>Signals</h2><div class="refsect2" title='The "item-activated" gtk.RecentChooser Signal'><a name="signal-gtkrecentchooser--item-activated"></a><h3>The "item-activated" gtk.RecentChooser Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>chooser</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>chooser</code></em> :</span></p></td><td>the object which 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 GTK+ 2.10 and above.</p></div><p>This signal is emitted when the user "activates" a recent item
in the recent chooser. This can happen by double-clicking on an item
in the recently used resources list, or by pressing
<span class="keycap"><strong>Enter</strong></span>.</p></div><div class="refsect2" title='The "selection-changed" gtk.RecentChooser Signal'><a name="signal-gtkrecentchooser--selection-changed"></a><h3>The "selection-changed" gtk.RecentChooser Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>chooser</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>chooser</code></em> :</span></p></td><td>the object which 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 GTK+ 2.10 and above.</p></div><p>This signal is emitted when there is a change in the set of
selected recently used resources. This can happen when a user
modifies the selection with the mouse or the keyboard, or when
explicitly calling methods to change the selection.</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-gtkrecentchooserwidget.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-gtkrecentfilter.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.RecentChooserWidget </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.RecentFilter</td></tr></table></div></body></html>
|