GI.Gtk.Objects.RecentFilter

A RecentFilter can be used to restrict the files being shown in a RecentChooser. Files can be filtered based on their name (with recentFilterAddPattern), on their mime type (with fileFilterAddMimeType), on the application that has registered them (with recentFilterAddApplication), or by a custom filter function (with recentFilterAddCustom).

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 RecentFilter 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 RecentChooser, see recentChooserAddFilter, but it is also possible to manually use a filter on a file with recentFilterFilter.

Recently used files are supported since GTK+ 2.10.

GtkRecentFilter as GtkBuildable

The GtkRecentFilter implementation of the GtkBuildable interface supports adding rules using the <mime-types>, <patterns> and <applications> elements and listing the rules within. Specifying a <mime-type>, <pattern> or <application> has the same effect as calling recentFilterAddMimeType, recentFilterAddPattern or recentFilterAddApplication.

An example of a UI definition fragment specifying GtkRecentFilter rules: > >class="GtkRecentFilter" > mime-types > mime-typetextplain<mime-type> > mime-typeimagepng<mime-type> > /mime-types > patterns > pattern*.txt/pattern > pattern*.png/pattern > /patterns > applications > applicationgimp/application > applicationgedit/application > applicationglade/application > /applications >/object

Exported types

newtype RecentFilter

Constructors

RecentFilter (ManagedPtr RecentFilter)

Instances

GObject RecentFilter

Methods

gobjectType :: RecentFilter -> IO GType

IsObject RecentFilter

IsRecentFilter RecentFilter

IsBuildable RecentFilter

((~) * info (ResolveRecentFilterMethod t RecentFilter), MethodInfo * info RecentFilter p) => IsLabel t (RecentFilter -> p)

Methods

fromLabel :: Proxy# Symbol t -> RecentFilter -> p

((~) * info (ResolveRecentFilterMethod t RecentFilter), MethodInfo * info RecentFilter p) => IsLabelProxy t (RecentFilter -> p)

Methods

fromLabelProxy :: Proxy Symbol t -> RecentFilter -> p

HasAttributeList * RecentFilter

type AttributeList RecentFilter

type AttributeList RecentFilter

type SignalList RecentFilter

type SignalList RecentFilter

class GObject o => IsRecentFilter o

Instances

(GObject a, UnknownAncestorError Constraint RecentFilter a) => IsRecentFilter a

IsRecentFilter RecentFilter

toRecentFilter :: IsRecentFilter o => o -> IO RecentFilter

noRecentFilter :: Maybe RecentFilter

Methods

addAge

data RecentFilterAddAgeMethodInfo

Instances

((~) * signature (Int32 -> m ()), MonadIO m, IsRecentFilter a) => MethodInfo * RecentFilterAddAgeMethodInfo a signature

Methods

overloadedMethod :: MethodProxy RecentFilterAddAgeMethodInfo a -> signature -> s

recentFilterAddAge

Arguments

:: (HasCallStack, MonadIO m, IsRecentFilter a)

=> a

filter: a RecentFilter

-> Int32

days: number of days

-> m ()

Adds a rule that allows resources based on their age - that is, the number of days elapsed since they were last modified.

Since: 2.10

addApplication

data RecentFilterAddApplicationMethodInfo

Instances

((~) * signature (Text -> m ()), MonadIO m, IsRecentFilter a) => MethodInfo * RecentFilterAddApplicationMethodInfo a signature

Methods

overloadedMethod :: MethodProxy RecentFilterAddApplicationMethodInfo a -> signature -> s

recentFilterAddApplication

Arguments

:: (HasCallStack, MonadIO m, IsRecentFilter a)

=> a

filter: a RecentFilter

-> Text

application: an application name

-> m ()

Adds a rule that allows resources based on the name of the application that has registered them.

Since: 2.10

addCustom

data RecentFilterAddCustomMethodInfo

Instances

((~) * signature ([RecentFilterFlags] -> RecentFilterFunc -> m ()), MonadIO m, IsRecentFilter a) => MethodInfo * RecentFilterAddCustomMethodInfo a signature

Methods

overloadedMethod :: MethodProxy RecentFilterAddCustomMethodInfo a -> signature -> s

recentFilterAddCustom

Arguments

:: (HasCallStack, MonadIO m, IsRecentFilter a)

=> a

filter: a RecentFilter

-> [RecentFilterFlags]

needed: bitfield of flags indicating the information that the custom filter function needs.

-> RecentFilterFunc

func: callback function; if the function returns True, then the file will be displayed.

-> m ()

Adds a rule to a filter that allows resources based on a custom callback function. The bitfield 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.

Since: 2.10

addGroup

data RecentFilterAddGroupMethodInfo

Instances

((~) * signature (Text -> m ()), MonadIO m, IsRecentFilter a) => MethodInfo * RecentFilterAddGroupMethodInfo a signature

Methods

overloadedMethod :: MethodProxy RecentFilterAddGroupMethodInfo a -> signature -> s

recentFilterAddGroup

Arguments

:: (HasCallStack, MonadIO m, IsRecentFilter a)

=> a

filter: a RecentFilter

-> Text

group: a group name

-> m ()

Adds a rule that allows resources based on the name of the group to which they belong

Since: 2.10

addMimeType

data RecentFilterAddMimeTypeMethodInfo

Instances

((~) * signature (Text -> m ()), MonadIO m, IsRecentFilter a) => MethodInfo * RecentFilterAddMimeTypeMethodInfo a signature

Methods

overloadedMethod :: MethodProxy RecentFilterAddMimeTypeMethodInfo a -> signature -> s

recentFilterAddMimeType

Arguments

:: (HasCallStack, MonadIO m, IsRecentFilter a)

=> a

filter: a RecentFilter

-> Text

mimeType: a MIME type

-> m ()

Adds a rule that allows resources based on their registered MIME type.

Since: 2.10

addPattern

data RecentFilterAddPatternMethodInfo

Instances

((~) * signature (Text -> m ()), MonadIO m, IsRecentFilter a) => MethodInfo * RecentFilterAddPatternMethodInfo a signature

Methods

overloadedMethod :: MethodProxy RecentFilterAddPatternMethodInfo a -> signature -> s

recentFilterAddPattern

Arguments

:: (HasCallStack, MonadIO m, IsRecentFilter a)

=> a

filter: a RecentFilter

-> Text

pattern: a file pattern

-> m ()

Adds a rule that allows resources based on a pattern matching their display name.

Since: 2.10

addPixbufFormats

data RecentFilterAddPixbufFormatsMethodInfo

Instances

((~) * signature (m ()), MonadIO m, IsRecentFilter a) => MethodInfo * RecentFilterAddPixbufFormatsMethodInfo a signature

Methods

overloadedMethod :: MethodProxy RecentFilterAddPixbufFormatsMethodInfo a -> signature -> s

recentFilterAddPixbufFormats

Arguments

:: (HasCallStack, MonadIO m, IsRecentFilter a)

=> a

filter: a RecentFilter

-> m ()

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

Since: 2.10

filter

data RecentFilterFilterMethodInfo

Instances

((~) * signature (RecentFilterInfo -> m Bool), MonadIO m, IsRecentFilter a) => MethodInfo * RecentFilterFilterMethodInfo a signature

Methods

overloadedMethod :: MethodProxy RecentFilterFilterMethodInfo a -> signature -> s

recentFilterFilter

Arguments

:: (HasCallStack, MonadIO m, IsRecentFilter a)

=> a

filter: a RecentFilter

-> RecentFilterInfo

filterInfo: a RecentFilterInfo containing information about a recently used resource

-> m Bool

Returns: True if the file should be displayed

Tests whether a file should be displayed according to filter. The RecentFilterInfo filterInfo should include the fields returned from recentFilterGetNeeded, and must set the RecentFilterInfo.contains field of filterInfo to indicate which fields have been set.

This function will not typically be used by applications; it is intended principally for use in the implementation of RecentChooser.

Since: 2.10

getName

data RecentFilterGetNameMethodInfo

Instances

((~) * signature (m (Maybe Text)), MonadIO m, IsRecentFilter a) => MethodInfo * RecentFilterGetNameMethodInfo a signature

Methods

overloadedMethod :: MethodProxy RecentFilterGetNameMethodInfo a -> signature -> s

recentFilterGetName

Arguments

:: (HasCallStack, MonadIO m, IsRecentFilter a)

=> a

filter: a RecentFilter

-> m (Maybe Text)

Returns: the name of the filter, or Nothing. The returned string is owned by the filter object and should not be freed.

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

Since: 2.10

getNeeded

data RecentFilterGetNeededMethodInfo

Instances

((~) * signature (m [RecentFilterFlags]), MonadIO m, IsRecentFilter a) => MethodInfo * RecentFilterGetNeededMethodInfo a signature

Methods

overloadedMethod :: MethodProxy RecentFilterGetNeededMethodInfo a -> signature -> s

recentFilterGetNeeded

Arguments

:: (HasCallStack, MonadIO m, IsRecentFilter a)

=> a

filter: a RecentFilter

-> m [RecentFilterFlags]

Returns: bitfield of flags indicating needed fields when calling recentFilterFilter

Gets the fields that need to be filled in for the RecentFilterInfo passed to recentFilterFilter

This function will not typically be used by applications; it is intended principally for use in the implementation of RecentChooser.

Since: 2.10

new

recentFilterNew

Arguments

:: (HasCallStack, MonadIO m)

=> m RecentFilter

Returns: a new RecentFilter

Creates a new RecentFilter with no rules added to it. Such filter does not accept any recently used resources, so is not particularly useful until you add rules with recentFilterAddPattern, recentFilterAddMimeType, recentFilterAddApplication, recentFilterAddAge. To create a filter that accepts any recently used resource, use:

C code

GtkRecentFilter *filter = gtk_recent_filter_new ();
gtk_recent_filter_add_pattern (filter, "*");

Since: 2.10

setName

data RecentFilterSetNameMethodInfo

Instances

((~) * signature (Text -> m ()), MonadIO m, IsRecentFilter a) => MethodInfo * RecentFilterSetNameMethodInfo a signature

Methods

overloadedMethod :: MethodProxy RecentFilterSetNameMethodInfo a -> signature -> s

recentFilterSetName

Arguments

:: (HasCallStack, MonadIO m, IsRecentFilter a)

=> a

filter: a RecentFilter

-> Text

name: then human readable name of filter

-> m ()

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

Since: 2.10