RGtk2 (version 2.20.31)

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.

Structures

GtkRecentFilter
The GtkRecentFilter struct contains only private fields and should not be directly accessed.
GtkRecentFilterInfo
A GtkRecentFilterInfo struct is used to pass information about the tested file to gtkRecentFilterFilter. GtkRecentFilterInfo is a transparent-type.
contains
[GtkRecentFilterFlags] Flags indicating which of the following fields need are filled
uri
[character] the URI of the file being tested
displayName
[character] the string that will be used to display the file in the recent chooser
mimeType
[character] the mime type of the file
applications
[character] the list of applications that have registered the file
groups
[character] the groups to which the file belongs to
age
[integer] the number of days elapsed since the file has been registered

Convenient Construction

gtkRecentFilter is the equivalent of gtkRecentFilterNew.

Enums and Flags

User Functions

References

http://library.gnome.org/devel//gtk/GtkRecentFilter.html

See Also

GtkRecentChooser