RecentFilter


Object Hierarchy:

Gtk.RecentFilter Gtk.RecentFilter Gtk.RecentFilter GLib.InitiallyUnowned GLib.InitiallyUnowned GLib.InitiallyUnowned->Gtk.RecentFilter GLib.Object GLib.Object GLib.Object->GLib.InitiallyUnowned Gtk.Buildable Gtk.Buildable Gtk.Buildable->Gtk.RecentFilter

Description:

[ CCode ( type_id = "gtk_recent_filter_get_type ()" ) ]
public sealed class RecentFilter : InitiallyUnowned, Buildable

A RecentFilter can be used to restrict the files being shown in a RecentChooser.

Files can be filtered based on their name (with add_pattern), on their mime type (with add_mime_type), on the application that has registered them (with add_application), or by a custom filter function (with 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 RecentFilter 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 RecentChooser, see add_filter, but it is also possible to manually use a filter on a file with filter.

Recently used files are supported since GTK+ 2.10.

GtkRecentFilter as GtkBuildable

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 add_mime_type, add_pattern or add_application.

An example of a UI definition fragment specifying `GtkRecentFilter` rules:

<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>


Namespace: Gtk
Package: gtk+-3.0

Content:

Creation methods:

Methods:

Inherited Members: