gtk.RecentFilter — A filter for selecting a subset of recently used files (new in PyGTK 2.10)
| class gtk.RecentFilter(gtk.Object): | 
A gtk.RecentFilter
    can be used to restrict the files being shown in a gtk.RecentChooser.
    Files can be filtered based on their name (with the gtk.RecentFilter.add_pattern()
    method), on their mime type (with the gtk.FileFilter.add_mime_type()
    method), on the application that has registered them (with the gtk.RecentFilter.add_application()
    method), or by a custom filter function (with the gtk.RecentFilter.add_custom()
    method).
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 gtk.RecentFilter
    allows wildcards for the subtype of a mime type, so you can e.g. filter
    for "image/*".
Normally, filters are used by adding them to a gtk.RecentChooser,
    see the gtk.RecentChooser.add_filter()
    method, but it is also possible to manually use a filter on a file with
    the gtk.RecentFilter.filter()
    method.
Recently used files are supported since GTK+ 2.10.
    gtk.RecentFilter()| Returns : | a new gtk.RecentFilter | 
This constructor is available in PyGTK 2.10 and above.
Creates a new gtk.RecentFilter
      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 gtk.RecentFilter.add_pattern(),
      gtk.RecentFilter.add_mime_type(),
      gtk.RecentFilter.add_application(),
      gtk.RecentFilter.add_age()
      methods.  To create a filter that accepts any recently used resource,
      use:
      filter = gtk.RecentFilter()
      filter.add_pattern("*")
          def set_name(name)| 
 | the human readable name | 
This method is available in PyGTK 2.10 and above.
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.
    def get_name()| Returns : | the name of the filter, or None. | 
This method is available in PyGTK 2.10 and above.
Returns the human-readable name for the filter.  See the gtk.RecentFilter.set_name()
      method.
    def add_mime_type(mime_type)| 
 | a MIME type | 
This method is available in PyGTK 2.10 and above.
Adds a rule that filters resources based on their registered MIME type.
    def add_pattern(pattern)| 
 | a file pattern | 
This method is available in PyGTK 2.10 and above.
Adds a rule that filters resources based on a pattern matching their display name.
    def add_pixbuf_formats()This method is available in PyGTK 2.10 and above.
Adds a rule that filters image files based on the formats
      supported by gtk.gdk.Pixbuf.
    def add_application(application)| 
 | an application name | 
This method is available in PyGTK 2.10 and above.
Adds a rule that filters resources based on the name of the application that has registered them.
    def add_group(group)| 
 | a group name | 
This method is available in PyGTK 2.10 and above.
Adds a rule that filters resources based on the name of the group to which they belong
    def add_age(days)| 
 | number of days | 
This method is available in PyGTK 2.10 and above.
Adds a rule that filters resources based on their age - that is, the number of days elapsed since they were last modified.
    def add_custom(needed, func, data)| 
 | a combination of the GTK Recent Filter Flags indicating the information that the custom filter function needs. | 
| 
 | callback function; if the function returns True, then
  the file will be displayed. | 
| 
 | data to pass to func | 
This method is available in PyGTK 2.10 and above.
Adds a rule to a filter that filters resources based on a custom
      callback function. needed is a combination of
      the GTK Recent Filter Flags 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.
The signature of the filter function is:
  def func(filterinfo, user_data):
      where filterinfo is a dict containing the
      info requested by needed as key-value pairs and
      user_data is data. The
      possible filterinfo keys are: "uri",
      "display_name", "mime_type", "applications", "age" and
      "groups".
    def get_needed()| Returns : | a combination of the GTK Recent Filter Flags
          indicating what fields are used for filtering when calling the gtk.RecentFilter.filter()method | 
This method is available in PyGTK 2.10 and above.
Returns a combination of the GTK Recent Filter Flags indicating what fields are used for filtering.
This method will not typically be used by applications; it is
      intended principally for use in the implementation of gtk.RecentChooser.
    def filter(filter_info)| 
 | a filter info dict containing information about a recently used resource | 
| Returns : | Trueif the file should be
          displayed | 
This method is available in PyGTK 2.10 and above.
Returns True if a file should be displayed.
      filter_info is a dict that should include the
      key-value pairs as specified by the return flags from the gtk.RecentFilter.get_needed()
      method. The possible filter_info keys are:
      "uri", "display_name", "mime_type", "applications", "age" and
      "groups".
This method will not typically be used by applications; it is
      intended principally for use in the implementation of gtk.RecentChooser.