Class
GtkFileFilter
Description [src]
final class Gtk.FileFilter : Gtk.Filter
implements Gtk.Buildable {
/* No available fields */
}
Filters files by name or mime type.
GtkFileFilter can be used to restrict the files being shown in a
file chooser. Files can be filtered based on their name (with
gtk_file_filter_add_pattern() or gtk_file_filter_add_suffix())
or on their mime type (with gtk_file_filter_add_mime_type()).
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, file filters are used by adding them to a file chooser
(see gtk_file_dialog_set_filters()), but it is also possible to
manually use a file filter on any GtkFilterListModel containing
GFileInfo objects.
GtkFileFilter as GtkBuildable
The GtkFileFilter implementation of the GtkBuildable interface
supports adding rules using the <mime-types> and <patterns> and
<suffixes> elements and listing the rules within. Specifying a
<mime-type> or <pattern> or <suffix> has the same effect as
as calling
gtk_file_filter_add_mime_type() or
gtk_file_filter_add_pattern() or
gtk_file_filter_add_suffix().
An example of a UI definition fragment specifying GtkFileFilter
rules:
<object class="GtkFileFilter">
<property name="name" translatable="yes">Text and Images</property>
<mime-types>
<mime-type>text/plain</mime-type>
<mime-type>image/ *</mime-type>
</mime-types>
<patterns>
<pattern>*.txt</pattern>
</patterns>
<suffixes>
<suffix>png</suffix>
</suffixes>
</object>
Instance methods
gtk_file_filter_add_pixbuf_formats
Adds a rule allowing image files in the formats supported by GdkPixbuf.
deprecated: 4.20
gtk_file_filter_get_attributes
Gets the attributes that need to be filled in for the GFileInfo
passed to this filter.
Methods inherited from GtkFilter (3)
gtk_filter_changed
Notifies all users of the filter that it has changed.
gtk_filter_get_strictness
Gets the known strictness of a filter.
gtk_filter_match
Checks if the given item is matched by the filter or not.
Methods inherited from GtkBuildable (1)
Signals
Signals inherited from GtkFilter (1)
Signals inherited from GObject (1)
GObject::notify
The notify signal is emitted on an object when one of its properties has its value set through g_object_set_property(), g_object_set(), et al.