GtkRecentFilter A filter for selecting a subset of recently used files 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. #GtkRecentChooser The GtkRecentFilter struct contains only private fields and should not be directly accessed. A GtkRecentFilterInfo struct is used to pass information about the tested file to gtk_recent_filter_filter(). @contains: Flags indicating which of the following fields need are filled @uri: the URI of the file being tested @display_name: the string that will be used to display the file in the recent chooser @mime_type: the mime type of the file @applications: the list of applications that have registered the file @groups: the groups to which the file belongs to @age: 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. @GTK_RECENT_FILTER_URI: the URI of the file being tested @GTK_RECENT_FILTER_DISPLAY_NAME: the string that will be used to display the file in the recent chooser @GTK_RECENT_FILTER_MIME_TYPE: the mime type of the file @GTK_RECENT_FILTER_APPLICATION: the list of applications that have registered the file @GTK_RECENT_FILTER_GROUP: the groups to which the file belongs to @GTK_RECENT_FILTER_AGE: the number of days elapsed since the file has been registered 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 @needed flags passed to gtk_recent_filter_add_custom() @user_data: user data passed to gtk_recent_filter_add_custom() @Returns: %TRUE if the file should be displayed @void: @Returns: @filter: @Returns: @filter: @name: @filter: @mime_type: @filter: @pattern: @filter: @filter: @application: @filter: @group: @filter: @days: @filter: @needed: @func: @data: @data_destroy: @filter: @Returns: @filter: @filter_info: @Returns: