Portability	portable (depends on GHC)
Stability	provisional
Maintainer	gtk2hs-users@lists.sourceforge.net
Safe Haskell	None

Graphics.UI.Gtk.Selectors.FileFilter

Contents

Detail
Class Hierarchy
Types
Constructors
Methods
Attributes

Description

A filter for selecting a file subset

Module available since Gtk+ version 2.4

Synopsis

Detail

A FileFilter can be used to restrict the files being shown in a FileChooser. Files can be filtered based on their name (with fileFilterAddPattern), on their mime type (with fileFilterAddMimeType), or by a custom filter function (with fileFilterAddCustom).

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 FileFilter 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 FileChooser, see fileChooserAddFilter.

Class Hierarchy

 | GObject
 | +----Object
 | +----FileFilter

Types

data FileFilter Source

Instances

Eq FileFilter
Ord FileFilter
GObjectClass FileFilter
FileFilterClass FileFilter
ObjectClass FileFilter

class ObjectClass o => FileFilterClass o Source

Instances

FileFilterClass FileFilter

castToFileFilter :: GObjectClass obj => obj -> FileFilter Source

gTypeFileFilter :: GType Source

toFileFilter :: FileFilterClass o => o -> FileFilter Source

data FileFilterFlags Source

Constructors

FileFilterFilename
FileFilterUri
FileFilterDisplayName
FileFilterMimeType

Instances

Bounded FileFilterFlags
Enum FileFilterFlags
Eq FileFilterFlags
Show FileFilterFlags
Flags FileFilterFlags

Constructors

fileFilterNew :: IO FileFilter Source

Creates a new FileFilter with no rules added to it. Such a filter doesn't accept any files, so is not particularly useful until you add rules with fileFilterAddMimeType, fileFilterAddPattern, or fileFilterAddCustom.

Methods

fileFilterSetName Source

Arguments

:: FileFilter
-> String	`name` - the human-readable-name for the filter
-> IO ()

Sets the human-readable name of the filter; this is the string that will be displayed in the file selector user interface if there is a selectable list of filters.

fileFilterGetName Source

Arguments

:: FileFilter
-> IO String	returns The human-readable name of the filter

Gets the human-readable name for the filter. See fileFilterSetName.

fileFilterAddMimeType Source

Arguments

:: FileFilter
-> String	`mimeType` - name of a MIME type
-> IO ()

Adds a rule allowing a given mime type to filter.

fileFilterAddPattern Source

Arguments

:: FileFilter
-> String	`pattern` - a shell style glob
-> IO ()

Adds a rule allowing a shell style glob to a filter.

fileFilterAddCustom Source

Arguments

:: FileFilter
-> [FileFilterFlags]	`needed` - list of flags indicating the information that the custom filter function needs.
-> (Maybe String -> Maybe String -> Maybe String -> Maybe String -> IO Bool)	`(filename uri displayName mimeType -> ...)` - filter function; if the function returns `True`, then the file will be displayed.
-> IO ()

Adds rule to a filter that allows files based on a custom callback function. The list of flags needed which is passed in provides information about what sorts of information that the filter function needs; this allows Gtk+ to avoid retrieving expensive information when it isn't needed by the filter.

fileFilterAddPixbufFormats :: FileFilter -> IO ()Source

Adds a rule allowing image files in the formats supported by Pixbuf.

Available since Gtk+ version 2.6

Attributes

fileFilterName :: Attr FileFilter String Source

'name' property. See fileFilterGetName and fileFilterSetName