GtkRecentFilter {RGtk2}R Documentation

GtkRecentFilter

Description

A filter for selecting a subset of recently used files

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

GtkRecentFilterFlags
These flags indicate what parts of a GtkRecentFilterInfo struct are filled or need to be filled.

uri
the URI of the file being tested
display-name
the string that will be used to display the file in the recent chooser
mime-type
the mime type of the file
application
the list of applications that have registered the file
group
the groups to which the file belongs to
age
the number of days elapsed since the file has been registered

User Functions

GtkRecentFilterFunc(filter.info, user.data)
The type of function that is used with custom filters, see gtkRecentFilterAddCustom.

filter.info
[GtkRecentFilterInfo] a GtkRecentFilterInfo that is filled according to the needed flags passed to gtkRecentFilterAddCustom
user.data
[R object] user data passed to gtkRecentFilterAddCustom

Returns: [logical] TRUE if the file should be displayed

Author(s)

Derived by RGtkGen from GTK+ documentation

References

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

See Also

GtkRecentChooser


[Package RGtk2 version 2.12.5-3 Index]