GtkFileFilter A filter for selecting a file subset A GtkFileFilter can be used to restrict the files being shown in a #GtkFileChooser. Files can be filtered based on their name (with gtk_file_filter_add_pattern()), on their mime type (with gtk_file_filter_add_mime_type()), or by a custom filter function (with gtk_file_filter_add_custom()). Filtering by mime types 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 #GtkFileFilter 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 #GtkFileChooser, see gtk_file_chooser_add_filter(), but it is also possible to manually use a filter on a file with gtk_file_filter_filter(). #GtkFileChooser The GtkFileFilter struct contains only private fields and should not be directly accessed. A GtkFileFilterInfo struct is used to pass information about the tested file to gtk_file_filter_filter(). @contains: Flags indicating which of the following fields need are filled @filename: the filename of the file being tested @uri: the URI for the file being tested @display_name: the string that will be used to display the file in the file chooser @mime_type: the mime type of the file These flags indicate what parts of a #GtkFileFilterInfo struct are filled or need to be filled. @GTK_FILE_FILTER_FILENAME: the filename of the file being tested @GTK_FILE_FILTER_URI: the URI for the file being tested @GTK_FILE_FILTER_DISPLAY_NAME: the string that will be used to display the file in the file chooser @GTK_FILE_FILTER_MIME_TYPE: the mime type of the file The type of function that is used with custom filters, see gtk_file_filter_add_custom(). @filter_info: a #GtkFileFilterInfo that is filled according to the @needed flags passed to gtk_file_filter_add_custom() @data: user data passed to gtk_file_filter_add_custom() @Returns: %TRUE if the file should be displayed @void: @Returns: @filter: @name: @filter: @Returns: @filter: @mime_type: @filter: @pattern: @filter: @filter: @needed: @func: @data: @notify: @filter: @Returns: @filter: @filter_info: @Returns: