| Top |  |  |  |  | 
| gboolean | (*GtkRecentFilterFunc) () | 
| GtkRecentFilter * | gtk_recent_filter_new () | 
| const gchar * | gtk_recent_filter_get_name () | 
| void | gtk_recent_filter_set_name () | 
| void | gtk_recent_filter_add_mime_type () | 
| void | gtk_recent_filter_add_pattern () | 
| void | gtk_recent_filter_add_pixbuf_formats () | 
| void | gtk_recent_filter_add_application () | 
| void | gtk_recent_filter_add_group () | 
| void | gtk_recent_filter_add_age () | 
| void | gtk_recent_filter_add_custom () | 
| GtkRecentFilterFlags | gtk_recent_filter_get_needed () | 
| gboolean | gtk_recent_filter_filter () | 
A GtkRecentFilter can be used to restrict the files being shown
in a GtkRecentChooser.  Files can be filtered based on their name
(with gtk_recent_filter_add_pattern()), on their mime type (with
gtk_file_filter_add_mime_type()), on the application that has
registered them (with gtk_recent_filter_add_application()), or by
a custom filter function (with gtk_recent_filter_add_custom()).
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 GtkRecentFilter 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 GtkRecentChooser,
see gtk_recent_chooser_add_filter(), but it is also possible to
manually use a filter on a file with gtk_recent_filter_filter().
Recently used files are supported since GTK+ 2.10.
The GtkRecentFilter implementation of the GtkBuildable interface
supports adding rules using the <mime-types>, <patterns> and
<applications> elements and listing the rules within. Specifying
a <mime-type>, <pattern> or <application> has the same effect as
calling gtk_recent_filter_add_mime_type(),
gtk_recent_filter_add_pattern() or gtk_recent_filter_add_application().
An example of a UI definition fragment specifying GtkRecentFilter rules:
| 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 | <object class="GtkRecentFilter"> <mime-types> <mime-type>text/plain</mime-type> <mime-type>image/png</mime-type> </mime-types> <patterns> <pattern>*.txt</pattern> <pattern>*.png</pattern> </patterns> <applications> <application>gimp</application> <application>gedit</application> <application>glade</application> </applications> </object> | 
gboolean (*GtkRecentFilterFunc) (const GtkRecentFilterInfo *filter_info,gpointer user_data);
The type of function that is used with custom filters,
see gtk_recent_filter_add_custom().
| filter_info | a GtkRecentFilterInfo that is filled according
to the  | |
| user_data | user data passed to  | 
GtkRecentFilter *
gtk_recent_filter_new (void);
Creates a new GtkRecentFilter 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:
| 1 2 | GtkRecentFilter *filter = gtk_recent_filter_new (); gtk_recent_filter_add_pattern (filter, "*"); | 
Since: 2.10
const gchar *
gtk_recent_filter_get_name (GtkRecentFilter *filter);
Gets the human-readable name for the filter.
See gtk_recent_filter_set_name().
 the name of the filter, or NULL.  The returned string
is owned by the filter object and should not be freed. 
[nullable]
Since: 2.10
void gtk_recent_filter_set_name (GtkRecentFilter *filter,const gchar *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.
Since: 2.10
void gtk_recent_filter_add_mime_type (GtkRecentFilter *filter,const gchar *mime_type);
Adds a rule that allows resources based on their registered MIME type.
Since: 2.10
void gtk_recent_filter_add_pattern (GtkRecentFilter *filter,const gchar *pattern);
Adds a rule that allows resources based on a pattern matching their display name.
Since: 2.10
void
gtk_recent_filter_add_pixbuf_formats (GtkRecentFilter *filter);
Adds a rule allowing image files in the formats supported by GdkPixbuf.
Since: 2.10
void gtk_recent_filter_add_application (GtkRecentFilter *filter,const gchar *application);
Adds a rule that allows resources based on the name of the application that has registered them.
Since: 2.10
void gtk_recent_filter_add_group (GtkRecentFilter *filter,const gchar *group);
Adds a rule that allows resources based on the name of the group to which they belong
Since: 2.10
void gtk_recent_filter_add_age (GtkRecentFilter *filter,gint days);
Adds a rule that allows resources based on their age - that is, the number of days elapsed since they were last modified.
Since: 2.10
void gtk_recent_filter_add_custom (GtkRecentFilter *filter,GtkRecentFilterFlags needed,GtkRecentFilterFunc func,gpointer data,GDestroyNotify data_destroy);
Adds a rule to a filter that allows resources based on a custom callback
function. The bitfield needed
 which is passed in provides information
about what sorts of information that the filter function needs;
this allows GTK+ to avoid retrieving expensive information when
it isn’t needed by the filter.
| filter | ||
| needed | bitfield of flags indicating the information that the custom filter function needs. | |
| func | callback function; if the function returns  | |
| data | data to pass to  | |
| data_destroy | function to call to free  | 
Since: 2.10
GtkRecentFilterFlags
gtk_recent_filter_get_needed (GtkRecentFilter *filter);
Gets the fields that need to be filled in for the GtkRecentFilterInfo
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 GtkRecentChooser.
Since: 2.10
gboolean gtk_recent_filter_filter (GtkRecentFilter *filter,const GtkRecentFilterInfo *filter_info);
Tests whether a file should be displayed according to filter
.
The GtkRecentFilterInfo filter_info
 should include
the fields returned from gtk_recent_filter_get_needed(), and
must set the GtkRecentFilterInfo.contains field of filter_info
to indicate which fields have been set.
This function will not typically be used by applications; it is intended principally for use in the implementation of GtkRecentChooser.
| filter | ||
| filter_info | a GtkRecentFilterInfo containing information about a recently used resource | 
Since: 2.10
struct GtkRecentFilterInfo {
  GtkRecentFilterFlags contains;
  const gchar *uri;
  const gchar *display_name;
  const gchar *mime_type;
  const gchar **applications;
  const gchar **groups;
  gint age;
};
A GtkRecentFilterInfo struct is used
to pass information about the tested file to gtk_recent_filter_filter().
| GtkRecentFilterFlags  | GtkRecentFilterFlags to indicate which fields are set. | |
| const gchar * | The URI of the file being tested. | [nullable] | 
| const gchar * | The string that will be used to display the file in the recent chooser. | [nullable] | 
| const gchar * | MIME type of the file. | [nullable] | 
| const gchar ** | The list of applications that have registered the file. | [nullable][array zero-terminated=1] | 
| const gchar ** | The groups to which the file belongs to. | [nullable][array zero-terminated=1] | 
| gint  | The number of days elapsed since the file has been registered. | 
These flags indicate what parts of a GtkRecentFilterInfo struct are filled or need to be filled.