/usr/share/gtk-doc/html/pygtk/class-gtkrecentmanager.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 | <html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.RecentManager</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-gtkrecentinfo.html" title="gtk.RecentInfo"><link rel="next" href="class-gtkrequisition.html" title="gtk.Requisition"></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.RecentManager</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkrecentinfo.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkrequisition.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.RecentManager"><a name="class-gtkrecentmanager"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.RecentManager</h2><p>gtk.RecentManager — manages recently used files (new in PyGTK
2.10)</p></div><div class="refsect1" title="Synopsis"><a name="id3876842"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.RecentManager</span></span>(<span class="ooclass"><span class="classname"><PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK></span></span>):
<code class="constructorsynopsis"> <span class="methodname"><a class="link" href="class-gtkrecentmanager.html#constructor-gtkrecentmanager" title="gtk.RecentManager">gtk.RecentManager</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentmanager.html#method-gtkrecentmanager--set-screen" title="gtk.RecentManager.set_screen">set_screen</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>screen</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentmanager.html#method-gtkrecentmanager--add-item" title="gtk.RecentManager.add_item">add_item</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-gtkrecentmanager.html#method-gtkrecentmanager--add-full" title="gtk.RecentManager.add_full">add_full</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>uri</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>recent_data</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentmanager.html#method-gtkrecentmanager--remove-item" title="gtk.RecentManager.remove_item">remove_item</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-gtkrecentmanager.html#method-gtkrecentmanager--lookup-item" title="gtk.RecentManager.lookup_item">lookup_item</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-gtkrecentmanager.html#method-gtkrecentmanager--has-item" title="gtk.RecentManager.has_item">has_item</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-gtkrecentmanager.html#method-gtkrecentmanager--move-item" title="gtk.RecentManager.move_item">move_item</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>uri</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>new_uri</code></strong></span></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentmanager.html#method-gtkrecentmanager--set-limit" title="gtk.RecentManager.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-gtkrecentmanager.html#method-gtkrecentmanager--get-limit" title="gtk.RecentManager.get_limit">get_limit</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentmanager.html#method-gtkrecentmanager--get-items" title="gtk.RecentManager.get_items">get_items</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentmanager.html#method-gtkrecentmanager--purge-items" title="gtk.RecentManager.purge_items">purge_items</a></span>()</code><br></pre></td></tr></table><pre class="programlisting">
<span class="bold"><strong>Functions</strong></span>
<code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentmanager.html#function-gtk--recent-manager-get-default" title="gtk.recent_manager_get_default">gtk.recent_manager_get_default</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis"> def <span class="methodname"><a class="link" href="class-gtkrecentmanager.html#function-gtk--recent-manager-get-for-screen" title="gtk.recent_manager_get_for_screen">gtk.recent_manager_get_for_screen</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>screen</code></strong></span></span>)</code></pre></div><div class="refsect1" title="Ancestry"><a name="id3877251"></a><h2>Ancestry</h2><pre class="synopsis">+-- <PYGTKDOCLINK HREF="class-gobject">gobject.GObject</PYGTKDOCLINK>
+-- <a class="link" href="class-gtkrecentmanager.html" title="gtk.RecentManager">gtk.RecentManager</a>
</pre></div><div class="refsect1" title="gtk.RecentManager Properties"><a name="properties-gtkrecentmanager"></a><h2>gtk.RecentManager 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">"filename"</td><td valign="top">Read-Write-Construct Only</td><td valign="top">The full path to the file to be used to store and read the
recently used resources list This property is available in GTK+
2.10 and above.</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 returned by the <a class="link" href="class-gtkrecentmanager.html#method-gtkrecentmanager--get-items" title="gtk.RecentManager.get_items"><code class="methodname">gtk.RecentManager.get_items()</code></a>
function. This property is available in GTK+ 2.10 and
above.</td></tr><tr valign="top"><td valign="top">"size"</td><td valign="top">Read</td><td valign="top">The size of the recently used resources list. This
property is available in GTK+ 2.10 and above.</td></tr></tbody></table></div></td></tr></table></div></div><div class="refsect1" title="gtk.RecentManager Signal Prototypes"><a name="signal-prototypes-gtkrecentmanager"></a><h2>gtk.RecentManager Signal Prototypes</h2><p><PYGTKDOCLINK HREF="signal-prototypes-gobject">gobject.GObject Signal Prototypes</PYGTKDOCLINK></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-gtkrecentmanager.html#signal-gtkrecentmanager--changed" title='The "changed" gtk.RecentManager 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>recent_manager</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="id3877483"></a><h2>Description</h2><p><a class="link" href="class-gtkrecentmanager.html" title="gtk.RecentManager"><code class="classname">gtk.RecentManager</code></a>
provides a facility for adding, removing and looking up recently used
files. Each recently used file is identified by its URI, and has
meta-data associated to it, like the names and command lines of the
applications that have registered it, the number of time each
application has registered the same file, the mime type of the file and
whether the file should be displayed only by the applications that have
registered it.</p><p>The <a class="link" href="class-gtkrecentmanager.html" title="gtk.RecentManager"><code class="classname">gtk.RecentManager</code></a>
acts like a database of all the recently used files. You can create new
<a class="link" href="class-gtkrecentmanager.html" title="gtk.RecentManager"><code class="classname">gtk.RecentManager</code></a>
objects, but it is more efficient to use the standard recent manager for
the <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a>
so that information about the recently used files is shared with other
people using them. In case the default screen is being used, adding a
new recently used file is as simple as:</p><div class="informalexample"><pre class="programlisting">
manager = gtk.recent_manager_get_default()
manager.add_item(file_uri)
</pre></div><p>While looking up a recently used file is as simple as:</p><div class="informalexample"><pre class="programlisting">
manager = gtk.recent_manager_get_default()
try:
info = manager.lookup_item(file_uri)
except gobject.GError:
print "Could not find the file: ", file_uri
</pre></div><p>Recently used files are supported since GTK+ 2.10.</p></div><div class="refsect1" title="Constructor"><a name="id3877572"></a><h2>Constructor</h2><div class="refsect2" title="gtk.RecentManager"><a name="constructor-gtkrecentmanager"></a><h3>gtk.RecentManager</h3><pre class="programlisting"><code class="constructorsynopsis"> <span class="methodname">gtk.RecentManager</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 newly created <a class="link" href="class-gtkrecentmanager.html" title="gtk.RecentManager"><code class="classname">gtk.RecentManager</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 constructor is available in PyGTK 2.10 and above.</p></div><p>Creates a new recent manager object. Recent manager objects are
used to handle the list of recently used resources. A <a class="link" href="class-gtkrecentmanager.html" title="gtk.RecentManager"><code class="classname">gtk.RecentManager</code></a>
object monitors the recently used resources list, and emits the
"changed" signal each time something inside the list changes.</p><p><a class="link" href="class-gtkrecentmanager.html" title="gtk.RecentManager"><code class="classname">gtk.RecentManager</code></a>
objects are expansive: be sure to create them only when needed. You
should use the <a class="link" href="class-gtkrecentmanager.html#function-gtk--recent-manager-get-for-screen" title="gtk.recent_manager_get_for_screen"><code class="function">gtk.recent_manager_get_for_screen</code>()</a>
or the <a class="link" href="class-gtkrecentmanager.html#function-gtk--recent-manager-get-default" title="gtk.recent_manager_get_default"><code class="function">gtk.recent_manager_get_default</code>()</a>
functions instead.</p></div></div><div class="refsect1" title="Methods"><a name="id3877696"></a><h2>Methods</h2><div class="refsect2" title="gtk.RecentManager.set_screen"><a name="method-gtkrecentmanager--set-screen"></a><h3>gtk.RecentManager.set_screen</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">set_screen</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>screen</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>screen</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</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 the screen for a recent manager; the screen is used to
track the user's currently configured recently used documents
storage.</p></div><div class="refsect2" title="gtk.RecentManager.add_item"><a name="method-gtkrecentmanager--add-item"></a><h3>gtk.RecentManager.add_item</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">add_item</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 valid 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 new item was
successfully added to the recently used resources
list</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 a new resource, pointed by <em class="parameter"><code>uri</code></em>, into
the recently used resources list.</p><p>This method automatically retrieves some of the needed metadata
and sets other metadata to common default values.</p><p>See the <a class="link" href="class-gtkrecentmanager.html#method-gtkrecentmanager--add-full" title="gtk.RecentManager.add_full"><code class="methodname">gtk.RecentManager.add_full()</code></a>
method if you want to explicitly define the metadata for the resource
pointed by <em class="parameter"><code>uri</code></em>.</p></div><div class="refsect2" title="gtk.RecentManager.add_full"><a name="method-gtkrecentmanager--add-full"></a><h3>gtk.RecentManager.add_full</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">add_full</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>uri</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>recent_data</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 valid URI</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>recent_data</code></strong> :</span></p></td><td>a dict containing metadata of the
resource</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 new item was
successfully added to the recently used resources
list.</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 a new resource, pointed by <em class="parameter"><code>uri</code></em>, into
the recently used resources list, using the metadata specified inside
the dict passed in <em class="parameter"><code>recent_data</code></em>.</p><p>The passed URI will be used to identify this resource inside the
list.</p><p>In order to register the new recently used resource, metadata
about the resource must be passed as well as the URI. The metadata is
stored in a dict, which must contain the MIME type of the resource
pointed by the URI ("mime_type"), the name of the application that is
registering the item ("app_name"), and a command line to be used when
launching the item ("app_exec").</p><p>Optionally, the <em class="parameter"><code>recent_data</code></em> dict might
contain a UTF-8 string to be used when viewing the item instead of the
last component of the URI ("display_name"), a short description of the
item ("description"), whether the item should be considered private -
that is, should be displayed only by the applications that have
registered it("is_private") or a list of the groups that the item
belongs to ("groups").</p></div><div class="refsect2" title="gtk.RecentManager.remove_item"><a name="method-gtkrecentmanager--remove-item"></a><h3>gtk.RecentManager.remove_item</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">remove_item</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>the URI of the item you wish to remove</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 item pointed by
<em class="parameter"><code>uri</code></em> has been successfully removed by the
recently used resources list.</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 a resource pointed by <em class="parameter"><code>uri</code></em> from
the recently used resources list handled by a recent manager. Raises
the gobject.GError when an error occurs.</p></div><div class="refsect2" title="gtk.RecentManager.lookup_item"><a name="method-gtkrecentmanager--lookup-item"></a><h3>gtk.RecentManager.lookup_item</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">lookup_item</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>a <a class="link" href="class-gtkrecentinfo.html" title="gtk.RecentInfo"><code class="classname">gtk.RecentInfo</code></a>
object containing information about the resource pointed by
<em class="parameter"><code>uri</code></em>, or <code class="literal">None</code> if the URI
was not registered in the recently used resources
list.</td></tr></tbody></table><p>Searches for a URI inside the recently used resources list, and
returns a <a class="link" href="class-gtkrecentinfo.html" title="gtk.RecentInfo"><code class="classname">gtk.RecentInfo</code></a>
object containing information about the resource like its MIME type,
or its display name. Raises the gobject.GError when an error
occurs.</p></div><div class="refsect2" title="gtk.RecentManager.has_item"><a name="method-gtkrecentmanager--has-item"></a><h3>gtk.RecentManager.has_item</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">has_item</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 resource 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>Checks whether there is a recently used resource registered with
<em class="parameter"><code>uri</code></em>.</p></div><div class="refsect2" title="gtk.RecentManager.move_item"><a name="method-gtkrecentmanager--move-item"></a><h3>gtk.RecentManager.move_item</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">move_item</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>uri</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>new_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>the URI of a recently used resource</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>new_uri</code></strong> :</span></p></td><td>the new URI of the recently used resource, or <code class="literal">None</code> to
remove the item pointed by <em class="parameter"><code>uri</code></em> in the list</td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td><code class="literal">True</code> on
success.</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>Changes the location of a recently used resource from
<em class="parameter"><code>uri</code></em> to <em class="parameter"><code>new_uri</code></em>.</p><p>Please note that this function will not affect the resource
pointed by the URIs, but only the URI used in the recently used
resources list. Raises the gobject.GError when an error occurs.</p></div><div class="refsect2" title="gtk.RecentManager.set_limit"><a name="method-gtkrecentmanager--set-limit"></a><h3>gtk.RecentManager.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>the maximum number of items to return, or
-1.</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 maximum number of item that the <a class="link" href="class-gtkrecentmanager.html#method-gtkrecentmanager--get-items" title="gtk.RecentManager.get_items"><code class="methodname">gtk.RecentManager.get_items()</code></a>
function should return. If <em class="parameter"><code>limit</code></em> is set to -1,
then return all the items.</p></div><div class="refsect2" title="gtk.RecentManager.get_limit"><a name="method-gtkrecentmanager--get-limit"></a><h3>gtk.RecentManager.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>the number of items to return, or -1 for every
item.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Returns the maximum number of items that the <a class="link" href="class-gtkrecentmanager.html#method-gtkrecentmanager--get-items" title="gtk.RecentManager.get_items"><code class="methodname">gtk.RecentManager.get_items()</code></a>
method should return.</p></div><div class="refsect2" title="gtk.RecentManager.get_items"><a name="method-gtkrecentmanager--get-items"></a><h3>gtk.RecentManager.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 as <a class="link" href="class-gtkrecentinfo.html" title="gtk.RecentInfo"><code class="classname">gtk.RecentInfo</code></a>
objects.</p></div><div class="refsect2" title="gtk.RecentManager.purge_items"><a name="method-gtkrecentmanager--purge-items"></a><h3>gtk.RecentManager.purge_items</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">purge_items</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 number of items that have been removed from
the recently used resources list.</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>Purges every item from the recently used resources list. Raises
the gobject.GError when an error occurs.</p></div></div><div class="refsect1" title="Functions"><a name="id3878872"></a><h2>Functions</h2><div class="refsect2" title="gtk.recent_manager_get_default"><a name="function-gtk--recent-manager-get-default"></a><h3>gtk.recent_manager_get_default</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.recent_manager_get_default</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 unique <a class="link" href="class-gtkrecentmanager.html" title="gtk.RecentManager"><code class="classname">gtk.RecentManager</code></a>
associated with the default screen. This recent manager is
associated to the screen and can be used as long as the screen is
open.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.10 and above.</p></div><p>Gets the recent manager for the default screen. See the <a class="link" href="class-gtkrecentmanager.html#function-gtk--recent-manager-get-for-screen" title="gtk.recent_manager_get_for_screen"><code class="function">gtk.recent_manager_get_for_screen</code>()</a>
function.</p></div><div class="refsect2" title="gtk.recent_manager_get_for_screen"><a name="function-gtk--recent-manager-get-for-screen"></a><h3>gtk.recent_manager_get_for_screen</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">gtk.recent_manager_get_for_screen</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>screen</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>screen</code></strong> :</span></p></td><td>a <a class="link" href="class-gdkscreen.html" title="gtk.gdk.Screen"><code class="classname">gtk.gdk.Screen</code></a></td></tr><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>A unique <a class="link" href="class-gtkrecentmanager.html" title="gtk.RecentManager"><code class="classname">gtk.RecentManager</code></a>
associated with the given screen. This recent manager is
associated to the with the screen and can be used as long as the
screen is open.</td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This function is available in PyGTK 2.10 and above.</p></div><p>Gets the recent manager object associated with
<em class="parameter"><code>screen</code></em>; if this function has not previously
been called for the given screen, a new recent manager object will be
created and associated with the screen. Recent manager objects are
fairly expensive to create, so using this function is usually a better
choice than calling the <a class="link" href="class-gtkrecentmanager.html#constructor-gtkrecentmanager" title="gtk.RecentManager">gtk.RecentManager</a>()
constructor and setting the screen yourself; by using this function a
single recent manager object will be shared between users.</p></div></div><div class="refsect1" title="Signals"><a name="id3879090"></a><h2>Signals</h2><div class="refsect2" title='The "changed" gtk.RecentManager Signal'><a name="signal-gtkrecentmanager--changed"></a><h3>The "changed" gtk.RecentManager Signal</h3><pre class="programlisting"><code class="methodsynopsis"> def <span class="methodname">callback</span>(<span class="methodparam"><span class="parameter"><em class="parameter"><code>recent_manager</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>recent_manager</code></em> :</span></p></td><td>the recent manager</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>Emitted when the current recently used resources manager changes
its contents.</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-gtkrecentinfo.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-gtkrequisition.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.RecentInfo </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.Requisition</td></tr></table></div></body></html>
|