GtkRecentFilter: GtkRecentFilter

Description

A filter for selecting a subset of recently used files

Arguments

Methods and Functions

gtkRecentFilterNew() gtkRecentFilterGetName(object) gtkRecentFilterSetName(object, name) gtkRecentFilterAddMimeType(object, mime.type) gtkRecentFilterAddPattern(object, pattern) gtkRecentFilterAddPixbufFormats(object) gtkRecentFilterAddApplication(object, application) gtkRecentFilterAddGroup(object, group) gtkRecentFilterAddAge(object, days) gtkRecentFilterAddCustom(object, needed, func, data) gtkRecentFilterGetNeeded(object) gtkRecentFilterFilter(object, filter.info) gtkRecentFilter()

Hierarchy

GObject +----GInitiallyUnowned +----GtkObject +----GtkRecentFilter

Detailed Description

A GtkRecentFilter can be used to restrict the files being shown in a GtkRecentChooser. Files can be filtered based on their name (with gtkRecentFilterAddPattern), on their mime type (with gtkFileFilterAddMimeType), on the application that has registered them (with gtkRecentFilterAddApplication), or by a custom filter function (with gtkRecentFilterAddCustom). 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 gtkRecentChooserAddFilter, but it is also possible to manually use a filter on a file with gtkRecentFilterFilter. Recently used files are supported since GTK+ 2.10.

Convenient Construction

gtkRecentFilter is the equivalent of gtkRecentFilterNew.

References

http://developer.gnome.org/doc/API/2.0/gtk/GtkRecentFilter.html