 -- Class: <gtk-recent-filter>
     Derives from <gtk-object>.

     This class defines no direct slots.

 -- Function: gtk-recent-filter-new =>  (ret <gtk-recent-filter>)
     Creates a new <gtk-recent-filter> with no rules added to it. Such filter does not accept any recently used resources, so is not particularly useful until you add rules with gtk-recent-filter-add-pattern, gtk-recent-filter-add-mime-type, gtk-recent-filter-add-application, gtk-recent-filter-add-age. To create a filter that accepts any recently used resource, use:

          GtkRecentFilter *filter = gtk_recent_filter_new ();
          gtk_recent_filter_add_pattern (filter, "*");

     ret
          a new <gtk-recent-filter>

     Since 2.10

 -- Function: gtk-recent-filter-get-name (self <gtk-recent-filter>) =>  (ret mchars)
 -- Method: get-name
     Gets the human-readable name for the filter. See gtk-recent-filter-set-name.

     filter
          a <gtk-recent-filter>

     ret
          the name of the filter, or #f. The returned string is owned by the filter object and should not be freed.

     Since 2.10

 -- Function: gtk-recent-filter-set-name (self <gtk-recent-filter>) (name mchars)
 -- Method: set-name
     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.

     filter
          a <gtk-recent-filter>

     name
          then human readable name of FILTER

     Since 2.10

 -- Function: gtk-recent-filter-add-mime-type (self <gtk-recent-filter>) (mime_type mchars)
 -- Method: add-mime-type
     Adds a rule that allows resources based on their registered MIME type.

     filter
          a <gtk-recent-filter>

     mime-type
          a MIME type

     Since 2.10

 -- Function: gtk-recent-filter-add-pattern (self <gtk-recent-filter>) (pattern mchars)
 -- Method: add-pattern
     Adds a rule that allows resources based on a pattern matching their display name.

     filter
          a <gtk-recent-filter>

     pattern
          a file pattern

     Since 2.10

 -- Function: gtk-recent-filter-add-application (self <gtk-recent-filter>) (application mchars)
 -- Method: add-application
     Adds a rule that allows resources based on the name of the application that has registered them.

     filter
          a <gtk-recent-filter>

     application
          an application name

     Since 2.10

 -- Function: gtk-recent-filter-add-group (self <gtk-recent-filter>) (group mchars)
 -- Method: add-group
     Adds a rule that allows resources based on the name of the group to which they belong

     filter
          a <gtk-recent-filter>

     group
          a group name

     Since 2.10

 -- Function: gtk-recent-filter-add-age (self <gtk-recent-filter>) (days int)
 -- Method: add-age
     Adds a rule that allows resources based on their age - that is, the number of days elapsed since they were last modified.

     filter
          a <gtk-recent-filter>

     days
          number of days

     Since 2.10

 -- Function: gtk-recent-filter-get-needed (self <gtk-recent-filter>) =>  (ret <gtk-recent-filter-flags>)
 -- Method: get-needed
     Gets the fields that need to be filled in for the structure passed to gtk-recent-filter-filter

     This function will not typically be used by applications; it is intended principally for use in the implementation of <gtk-recent-chooser>.

     filter
          a <gtk-recent-filter>

     ret
          bitfield of flags indicating needed fields when calling gtk-recent-filter-filter

     Since 2.10