File: class-gtkrecentfilter.html

package info (click to toggle)
pygtk 2.24.0-5.1
  • links: PTS, VCS
  • area: main
  • in suites: buster, stretch
  • size: 26,760 kB
  • ctags: 8,260
  • sloc: xml: 182,079; sh: 10,297; python: 10,161; ansic: 2,861; makefile: 1,358
file content (71 lines) | stat: -rw-r--r-- 25,778 bytes parent folder | download | duplicates (3)
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
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><title>gtk.RecentFilter</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-gtkrecentchooser.html" title="gtk.RecentChooser"><link rel="next" href="class-gtkrecentinfo.html" title="gtk.RecentInfo"></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.RecentFilter</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="class-gtkrecentchooser.html">Prev</a> </td><th width="60%" align="center">The gtk Class Reference</th><td width="20%" align="right"> <a accesskey="n" href="class-gtkrecentinfo.html">Next</a></td></tr></table><hr></div><div class="refentry" title="gtk.RecentFilter"><a name="class-gtkrecentfilter"></a><div class="titlepage"></div><div class="refnamediv"><h2>gtk.RecentFilter</h2><p>gtk.RecentFilter — A filter for selecting a subset of recently used files
      (new in PyGTK 2.10)</p></div><div class="refsect1" title="Synopsis"><a name="id3872912"></a><h2>Synopsis</h2><table bgcolor="#D0E0F0" width="100%"><tr><td><pre class="classsynopsis">class <span class="ooclass"><span class="classname">gtk.RecentFilter</span></span>(<span class="ooclass"><span class="classname"><a class="link" href="class-gtkobject.html" title="gtk.Object">gtk.Object</a></span></span>):
<code class="constructorsynopsis">    <span class="methodname"><a class="link" href="class-gtkrecentfilter.html#constructor-gtkrecentfilter" title="gtk.RecentFilter">gtk.RecentFilter</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--set-name" title="gtk.RecentFilter.set_name">set_name</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--get-name" title="gtk.RecentFilter.get_name">get_name</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-mime-type" title="gtk.RecentFilter.add_mime_type">add_mime_type</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mime_type</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-pattern" title="gtk.RecentFilter.add_pattern">add_pattern</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>pattern</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-pixbuf-formats" title="gtk.RecentFilter.add_pixbuf_formats">add_pixbuf_formats</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-application" title="gtk.RecentFilter.add_application">add_application</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>application</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-group" title="gtk.RecentFilter.add_group">add_group</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>group</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-age" title="gtk.RecentFilter.add_age">add_age</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>days</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-custom" title="gtk.RecentFilter.add_custom">add_custom</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>needed</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>data</code></strong></span></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--get-needed" title="gtk.RecentFilter.get_needed">get_needed</a></span>(<span class="methodparam"></span>)</code><br><code class="methodsynopsis">    def <span class="methodname"><a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--filter" title="gtk.RecentFilter.filter">filter</a></span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filter_info</code></strong></span></span>)</code><br></pre></td></tr></table></div><div class="refsect1" title="Ancestry"><a name="id3873269"></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-gtkrecentfilter.html" title="gtk.RecentFilter">gtk.RecentFilter</a>
</pre></div><div class="refsect1" title="gtk.RecentFilter Properties"><a name="properties-gtkrecentfilter"></a><h2>gtk.RecentFilter Properties</h2><p><a class="link" href="class-gtkobject.html#properties-gtkobject" title="gtk.Object Properties">gtk.Object Properties</a></p></div><div class="refsect1" title="gtk.RecentFilter Signal Prototypes"><a name="signal-prototypes-gtkrecentfilter"></a><h2>gtk.RecentFilter 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></div><div class="refsect1" title="Description"><a name="id3873349"></a><h2>Description</h2><p>A <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</code></a>
    can be used to restrict the files being shown in a <a class="link" href="class-gtkrecentchooser.html" title="gtk.RecentChooser"><code class="classname">gtk.RecentChooser</code></a>.
    Files can be filtered based on their name (with the <a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-pattern" title="gtk.RecentFilter.add_pattern"><code class="methodname">gtk.RecentFilter.add_pattern()</code></a>
    method), on their mime type (with the <a class="link" href="class-gtkfilefilter.html#method-gtkfilefilter--add-mime-type" title="gtk.FileFilter.add_mime_type"><code class="methodname">gtk.FileFilter.add_mime_type()</code></a>
    method), on the application that has registered them (with the <a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-application" title="gtk.RecentFilter.add_application"><code class="methodname">gtk.RecentFilter.add_application()</code></a>
    method), or by a custom filter function (with the <a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-custom" title="gtk.RecentFilter.add_custom"><code class="methodname">gtk.RecentFilter.add_custom()</code></a>
    method).</p><p>Filtering by mime type handles aliasing and subclassing of mime
    types; e.g. a filter for "text/plain" also matches a file with mime type
    "application/rtf", since "application/rtf" is a subclass of
    "text/plain".  Note that <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</code></a>
    allows wildcards for the subtype of a mime type, so you can e.g. filter
    for "image/*".</p><p>Normally, filters are used by adding them to a <a class="link" href="class-gtkrecentchooser.html" title="gtk.RecentChooser"><code class="classname">gtk.RecentChooser</code></a>,
    see the <a class="link" href="class-gtkrecentchooser.html#method-gtkrecentchooser--add-filter" title="gtk.RecentChooser.add_filter"><code class="methodname">gtk.RecentChooser.add_filter()</code></a>
    method, but it is also possible to manually use a filter on a file with
    the <a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--filter" title="gtk.RecentFilter.filter"><code class="methodname">gtk.RecentFilter.filter()</code></a>
    method.</p><p>Recently used files are supported since GTK+ 2.10.</p></div><div class="refsect1" title="Constructor"><a name="id3873460"></a><h2>Constructor</h2><div class="refsect2" title="gtk.RecentFilter"><a name="constructor-gtkrecentfilter"></a><h3>gtk.RecentFilter</h3><pre class="programlisting"><code class="constructorsynopsis">    <span class="methodname">gtk.RecentFilter</span>(<span class="methodparam"></span>)</code></pre><table border="0" width="100%" bgcolor="#FFECCE"><col align="left" valign="top" width="0*"><tbody><tr><td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td><td>a new <a class="link" href="class-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 constructor is available in PyGTK 2.10 and above.</p></div><p>Creates a new <a class="link" href="class-gtkrecentfilter.html" title="gtk.RecentFilter"><code class="classname">gtk.RecentFilter</code></a>
      with no rules added to it.  Such a filter does not accept any recently
      used resources, so is not particularly useful until you add rules with
      the <a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-pattern" title="gtk.RecentFilter.add_pattern"><code class="methodname">gtk.RecentFilter.add_pattern()</code></a>,
      <a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-mime-type" title="gtk.RecentFilter.add_mime_type"><code class="methodname">gtk.RecentFilter.add_mime_type()</code></a>,
      <a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-application" title="gtk.RecentFilter.add_application"><code class="methodname">gtk.RecentFilter.add_application()</code></a>,
      <a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--add-age" title="gtk.RecentFilter.add_age"><code class="methodname">gtk.RecentFilter.add_age()</code></a>
      methods.  To create a filter that accepts any recently used resource,
      use:</p><div class="informalexample"><pre class="programlisting">
      filter = gtk.RecentFilter()
      filter.add_pattern("*")
      </pre></div></div></div><div class="refsect1" title="Methods"><a name="id3873589"></a><h2>Methods</h2><div class="refsect2" title="gtk.RecentFilter.set_name"><a name="method-gtkrecentfilter--set-name"></a><h3>gtk.RecentFilter.set_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">set_name</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>name</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>name</code></strong> :</span></p></td><td>the human readable name</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 human-readable name of the filter; this is the string
      that will be displayed in the recently used resources selector user
      interface if there is a selectable list of filters.</p></div><div class="refsect2" title="gtk.RecentFilter.get_name"><a name="method-gtkrecentfilter--get-name"></a><h3>gtk.RecentFilter.get_name</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_name</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 name of the filter, 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>Returns the human-readable name for the filter.  See the <a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--set-name" title="gtk.RecentFilter.set_name"><code class="methodname">gtk.RecentFilter.set_name()</code></a>
      method.</p></div><div class="refsect2" title="gtk.RecentFilter.add_mime_type"><a name="method-gtkrecentfilter--add-mime-type"></a><h3>gtk.RecentFilter.add_mime_type</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_mime_type</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>mime_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>mime_type</code></strong> :</span></p></td><td>a MIME type</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 rule that filters resources based on their registered
      MIME type.</p></div><div class="refsect2" title="gtk.RecentFilter.add_pattern"><a name="method-gtkrecentfilter--add-pattern"></a><h3>gtk.RecentFilter.add_pattern</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_pattern</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>pattern</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>pattern</code></strong> :</span></p></td><td>a file pattern</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 rule that filters resources based on a pattern matching
      their display name.</p></div><div class="refsect2" title="gtk.RecentFilter.add_pixbuf_formats"><a name="method-gtkrecentfilter--add-pixbuf-formats"></a><h3>gtk.RecentFilter.add_pixbuf_formats</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_pixbuf_formats</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>Adds a rule that filters image files based on the formats
      supported by <a class="link" href="class-gdkpixbuf.html" title="gtk.gdk.Pixbuf"><code class="classname">gtk.gdk.Pixbuf</code></a>.</p></div><div class="refsect2" title="gtk.RecentFilter.add_application"><a name="method-gtkrecentfilter--add-application"></a><h3>gtk.RecentFilter.add_application</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_application</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>application</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>application</code></strong> :</span></p></td><td>an application name</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 rule that filters resources based on the name of the
      application that has registered them.</p></div><div class="refsect2" title="gtk.RecentFilter.add_group"><a name="method-gtkrecentfilter--add-group"></a><h3>gtk.RecentFilter.add_group</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_group</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>group</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>group</code></strong> :</span></p></td><td>a group name</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 rule that filters resources based on the name of the
      group to which they belong</p></div><div class="refsect2" title="gtk.RecentFilter.add_age"><a name="method-gtkrecentfilter--add-age"></a><h3>gtk.RecentFilter.add_age</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_age</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>days</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>days</code></strong> :</span></p></td><td>number of days</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 rule that filters resources based on their age -
      that is, the number of days elapsed since they were last
      modified.</p></div><div class="refsect2" title="gtk.RecentFilter.add_custom"><a name="method-gtkrecentfilter--add-custom"></a><h3>gtk.RecentFilter.add_custom</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">add_custom</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>needed</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>func</code></strong></span></span>, <span class="methodparam"><span class="parameter"><strong class="parameter"><code>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>needed</code></strong> :</span></p></td><td>a combination of the <a class="xref" href="gtk-constants.html#gtk-recent-filter-flags-constants" title="GTK Recent Filter Flags">GTK Recent Filter Flags</a>
          indicating the information that the custom filter function
          needs.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>func</code></strong> :</span></p></td><td>callback function; if the function returns <code class="literal">True</code>, then
  the file will be displayed.</td></tr><tr><td><p><span class="term"><strong class="parameter"><code>data</code></strong> :</span></p></td><td>data to pass to <em class="parameter"><code>func</code></em></td></tr></tbody></table><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>This method is available in PyGTK 2.10 and above.</p></div><p>Adds a rule to a filter that filters resources based on a custom
      callback function. <em class="parameter"><code>needed</code></em> is a combination of
      the <a class="xref" href="gtk-constants.html#gtk-recent-filter-flags-constants" title="GTK Recent Filter Flags">GTK Recent Filter Flags</a> which
      provides information about what sorts of information that the filter
      function needs; this allows PyGTK to avoid retrieving expensive
      information when it isn't needed by the filter.</p><p>The signature of the filter function is:</p><pre class="programlisting">
  def func(filterinfo, user_data):
      </pre><p>where <em class="parameter"><code>filterinfo</code></em> is a dict containing the
      info requested by <em class="parameter"><code>needed</code></em> as key-value pairs and
      <em class="parameter"><code>user_data</code></em> is <em class="parameter"><code>data</code></em>. The
      possible <em class="parameter"><code>filterinfo</code></em> keys are: "uri",
      "display_name", "mime_type", "applications", "age" and
      "groups".</p></div><div class="refsect2" title="gtk.RecentFilter.get_needed"><a name="method-gtkrecentfilter--get-needed"></a><h3>gtk.RecentFilter.get_needed</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">get_needed</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 combination of the <a class="xref" href="gtk-constants.html#gtk-recent-filter-flags-constants" title="GTK Recent Filter Flags">GTK Recent Filter Flags</a>
          indicating what fields are used for filtering when calling the
          <a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--filter" title="gtk.RecentFilter.filter"><code class="methodname">gtk.RecentFilter.filter()</code></a>
          method</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 combination of the <a class="xref" href="gtk-constants.html#gtk-recent-filter-flags-constants" title="GTK Recent Filter Flags">GTK Recent Filter Flags</a> indicating
      what fields are used for filtering.</p><p>This method will not typically be used by applications; it is
      intended principally for use in the implementation of <a class="link" href="class-gtkrecentchooser.html" title="gtk.RecentChooser"><code class="classname">gtk.RecentChooser</code></a>.</p></div><div class="refsect2" title="gtk.RecentFilter.filter"><a name="method-gtkrecentfilter--filter"></a><h3>gtk.RecentFilter.filter</h3><pre class="programlisting"><code class="methodsynopsis">    def <span class="methodname">filter</span>(<span class="methodparam"><span class="parameter"><strong class="parameter"><code>filter_info</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_info</code></strong> :</span></p></td><td>a filter info dict containing information about
          a recently used 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 file 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 a file should be displayed.
      <em class="parameter"><code>filter_info</code></em> is a dict that should include the
      key-value pairs as specified by the return flags from the <a class="link" href="class-gtkrecentfilter.html#method-gtkrecentfilter--get-needed" title="gtk.RecentFilter.get_needed"><code class="methodname">gtk.RecentFilter.get_needed()</code></a>
      method. The possible <em class="parameter"><code>filter_info</code></em> keys are:
      "uri", "display_name", "mime_type", "applications", "age" and
      "groups".</p><p>This method will not typically be used by applications; it is
      intended principally for use in the implementation of <a class="link" href="class-gtkrecentchooser.html" title="gtk.RecentChooser"><code class="classname">gtk.RecentChooser</code></a>.</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-gtkrecentchooser.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-gtkrecentinfo.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">gtk.RecentChooser </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> gtk.RecentInfo</td></tr></table></div></body></html>