gtk-gtkfilefilter {RGtk2} | R Documentation |
A filter for selecting a file subset
gtkFileFilterNew()
gtkFileFilterSetName(object, name)
gtkFileFilterGetName(object)
gtkFileFilterAddMimeType(object, mime.type)
gtkFileFilterAddPattern(object, pattern)
gtkFileFilterAddPixbufFormats(object)
gtkFileFilterAddCustom(object, needed, func, data = NULL)
gtkFileFilterGetNeeded(object)
gtkFileFilterFilter(object, filter.info)
gtkFileFilter()
GObject +----GInitiallyUnowned +----GtkObject +----GtkFileFilter
A GtkFileFilter can be used to restrict the files being shown
in a GtkFileChooser
. Files can be filtered based on their name
(with gtkFileFilterAddPattern
), on their mime type (with
gtkFileFilterAddMimeType
), or by a custom filter function
(with gtkFileFilterAddCustom
).
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, filters are used by adding them to a GtkFileChooser
,
see gtkFileChooserAddFilter
, but it is also possible
to manually use a filter on a file with gtkFileFilterFilter
.
gtkFileFilter
is the equivalent of gtkFileFilterNew
.
GtkFileFilterFlags
These flags indicate what parts of a GtkFileFilterInfo
struct
are filled or need to be filled.
filename
the filename of the file being tested
uri
the URI for the file being tested
display-name
the string that will be used to display the file in the file chooser
mime-type
the mime type of the file
GtkFileFilterFunc(filter.info, data)
The type of function that is used with custom filters,
see gtkFileFilterAddCustom
.
filter.info
a GtkFileFilterInfo
that is filled according
to the needed
flags passed to gtkFileFilterAddCustom
data
user data passed to gtkFileFilterAddCustom
Returns: [logical] TRUE
if the file should be displayed
Derived by RGtkGen from GTK+ documentation
http://library.gnome.org/devel//gtk/gtk-gtkfilefilter.html