gi-gtk-3.0.11: Gtk bindings

CopyrightWill Thompson, Iñaki García Etxebarria and Jonas Platte
LicenseLGPL-2.1
MaintainerIñaki García Etxebarria (garetxe@gmail.com)
Safe HaskellNone
LanguageHaskell2010

GI.Gtk.Interfaces.RecentChooser

Contents

Description

RecentChooser is an interface that can be implemented by widgets displaying the list of recently used files. In GTK+, the main objects that implement this interface are RecentChooserWidget, RecentChooserDialog and RecentChooserMenu.

Recently used files are supported since GTK+ 2.10.

Synopsis

Exported types

Methods

addFilter

recentChooserAddFilter Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a, IsRecentFilter b) 
=> a

chooser: a RecentChooser

-> b

filter: a RecentFilter

-> m () 

Adds filter to the list of RecentFilter objects held by chooser.

If no previous filter objects were defined, this function will call recentChooserSetFilter.

Since: 2.10

getCurrentItem

recentChooserGetCurrentItem Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m RecentInfo

Returns: a RecentInfo. Use recentInfoUnref when when you have finished using it.

Gets the RecentInfo currently selected by chooser.

Since: 2.10

getCurrentUri

recentChooserGetCurrentUri Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m Text

Returns: a newly allocated string holding a URI.

Gets the URI currently selected by chooser.

Since: 2.10

getFilter

recentChooserGetFilter Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m RecentFilter

Returns: a RecentFilter object.

Gets the RecentFilter object currently used by chooser to affect the display of the recently used resources.

Since: 2.10

getItems

recentChooserGetItems Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m [RecentInfo]

Returns: A newly allocated list of RecentInfo objects. You should use recentInfoUnref on every item of the list, and then free the list itself using g_list_free().

Gets the list of recently used resources in form of RecentInfo objects.

The return value of this function is affected by the “sort-type” and “limit” properties of chooser.

Since: 2.10

getLimit

recentChooserGetLimit Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m Int32

Returns: A positive integer, or -1 meaning that all items are returned.

Gets the number of items returned by recentChooserGetItems and recentChooserGetUris.

Since: 2.10

getLocalOnly

recentChooserGetLocalOnly Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m Bool

Returns: True if only local resources should be shown.

Gets whether only local resources should be shown in the recently used resources selector. See recentChooserSetLocalOnly

Since: 2.10

getSelectMultiple

recentChooserGetSelectMultiple Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m Bool

Returns: True if chooser can select more than one item.

Gets whether chooser can select multiple items.

Since: 2.10

getShowIcons

recentChooserGetShowIcons Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m Bool

Returns: True if the icons should be displayed, False otherwise.

Retrieves whether chooser should show an icon near the resource.

Since: 2.10

getShowNotFound

recentChooserGetShowNotFound Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m Bool

Returns: True if the resources not found should be displayed, and False otheriwse.

Retrieves whether chooser should show the recently used resources that were not found.

Since: 2.10

getShowPrivate

recentChooserGetShowPrivate Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m Bool

Returns: True if the recent chooser should show private items, False otherwise.

Returns whether chooser should display recently used resources registered as private.

Since: 2.10

getShowTips

recentChooserGetShowTips Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m Bool

Returns: True if the recent chooser should show tooltips, False otherwise.

Gets whether chooser should display tooltips containing the full path of a recently user resource.

Since: 2.10

getSortType

recentChooserGetSortType Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m RecentSortType

Returns: the sorting order of the chooser.

Gets the value set by recentChooserSetSortType.

Since: 2.10

getUris

recentChooserGetUris Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m ([Text], Word64)

Returns: A newly allocated, Nothing-terminated array of strings. Use strfreev to free it.

Gets the URI of the recently used resources.

The return value of this function is affected by the “sort-type” and “limit” properties of chooser.

Since the returned array is Nothing terminated, length may be Nothing.

Since: 2.10

listFilters

recentChooserListFilters Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m [RecentFilter]

Returns: A singly linked list of RecentFilter objects. You should just free the returned list using g_slist_free().

Gets the RecentFilter objects held by chooser.

Since: 2.10

removeFilter

recentChooserRemoveFilter Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a, IsRecentFilter b) 
=> a

chooser: a RecentChooser

-> b

filter: a RecentFilter

-> m () 

Removes filter from the list of RecentFilter objects held by chooser.

Since: 2.10

selectAll

recentChooserSelectAll Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m () 

Selects all the items inside chooser, if the chooser supports multiple selection.

Since: 2.10

selectUri

recentChooserSelectUri Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> Text

uri: a URI

-> m ()

(Can throw GError)

Selects uri inside chooser.

Since: 2.10

setCurrentUri

recentChooserSetCurrentUri Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> Text

uri: a URI

-> m ()

(Can throw GError)

Sets uri as the current URI for chooser.

Since: 2.10

setFilter

recentChooserSetFilter Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a, IsRecentFilter b) 
=> a

chooser: a RecentChooser

-> Maybe b

filter: a RecentFilter

-> m () 

Sets filter as the current RecentFilter object used by chooser to affect the displayed recently used resources.

Since: 2.10

setLimit

recentChooserSetLimit Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> Int32

limit: a positive integer, or -1 for all items

-> m () 

Sets the number of items that should be returned by recentChooserGetItems and recentChooserGetUris.

Since: 2.10

setLocalOnly

recentChooserSetLocalOnly Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> Bool

localOnly: True if only local files can be shown

-> m () 

Sets whether only local resources, that is resources using the file:// URI scheme, should be shown in the recently used resources selector. If localOnly is True (the default) then the shown resources are guaranteed to be accessible through the operating system native file system.

Since: 2.10

setSelectMultiple

recentChooserSetSelectMultiple Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> Bool

selectMultiple: True if chooser can select more than one item

-> m () 

Sets whether chooser can select multiple items.

Since: 2.10

setShowIcons

recentChooserSetShowIcons Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> Bool

showIcons: whether to show an icon near the resource

-> m () 

Sets whether chooser should show an icon near the resource when displaying it.

Since: 2.10

setShowNotFound

recentChooserSetShowNotFound Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> Bool

showNotFound: whether to show the local items we didn’t find

-> m () 

Sets whether chooser should display the recently used resources that it didn’t find. This only applies to local resources.

Since: 2.10

setShowPrivate

recentChooserSetShowPrivate Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> Bool

showPrivate: True to show private items, False otherwise

-> m () 

Whether to show recently used resources marked registered as private.

Since: 2.10

setShowTips

recentChooserSetShowTips Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> Bool

showTips: True if tooltips should be shown

-> m () 

Sets whether to show a tooltips containing the full path of each recently used resource in a RecentChooser widget.

Since: 2.10

setSortFunc

recentChooserSetSortFunc Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> RecentSortFunc

sortFunc: the comparison function

-> m () 

Sets the comparison function used when sorting to be sortFunc. If the chooser has the sort type set to GTK_RECENT_SORT_CUSTOM then the chooser will sort using this function.

To the comparison function will be passed two RecentInfo structs and sortData; sortFunc should return a positive integer if the first item comes before the second, zero if the two items are equal and a negative integer if the first item comes after the second.

Since: 2.10

setSortType

recentChooserSetSortType Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> RecentSortType

sortType: sort order that the chooser should use

-> m () 

Changes the sorting order of the recently used resources list displayed by chooser.

Since: 2.10

unselectAll

recentChooserUnselectAll Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> m () 

Unselects all the items inside chooser.

Since: 2.10

unselectUri

recentChooserUnselectUri Source #

Arguments

:: (HasCallStack, MonadIO m, IsRecentChooser a) 
=> a

chooser: a RecentChooser

-> Text

uri: a URI

-> m () 

Unselects uri inside chooser.

Since: 2.10

Properties

filter

data RecentChooserFilterPropertyInfo Source #

Instances

AttrInfo RecentChooserFilterPropertyInfo Source # 
type AttrOrigin RecentChooserFilterPropertyInfo Source # 
type AttrLabel RecentChooserFilterPropertyInfo Source # 
type AttrGetType RecentChooserFilterPropertyInfo Source # 
type AttrBaseTypeConstraint RecentChooserFilterPropertyInfo Source # 
type AttrSetTypeConstraint RecentChooserFilterPropertyInfo Source # 
type AttrAllowedOps RecentChooserFilterPropertyInfo Source # 

limit

data RecentChooserLimitPropertyInfo Source #

Instances

AttrInfo RecentChooserLimitPropertyInfo Source # 
type AttrOrigin RecentChooserLimitPropertyInfo Source # 
type AttrLabel RecentChooserLimitPropertyInfo Source # 
type AttrGetType RecentChooserLimitPropertyInfo Source # 
type AttrBaseTypeConstraint RecentChooserLimitPropertyInfo Source # 
type AttrSetTypeConstraint RecentChooserLimitPropertyInfo Source # 
type AttrAllowedOps RecentChooserLimitPropertyInfo Source # 

localOnly

data RecentChooserLocalOnlyPropertyInfo Source #

Instances

AttrInfo RecentChooserLocalOnlyPropertyInfo Source # 
type AttrOrigin RecentChooserLocalOnlyPropertyInfo Source # 
type AttrLabel RecentChooserLocalOnlyPropertyInfo Source # 
type AttrGetType RecentChooserLocalOnlyPropertyInfo Source # 
type AttrBaseTypeConstraint RecentChooserLocalOnlyPropertyInfo Source # 
type AttrSetTypeConstraint RecentChooserLocalOnlyPropertyInfo Source # 
type AttrAllowedOps RecentChooserLocalOnlyPropertyInfo Source # 

recentManager

data RecentChooserRecentManagerPropertyInfo Source #

Instances

AttrInfo RecentChooserRecentManagerPropertyInfo Source # 
type AttrOrigin RecentChooserRecentManagerPropertyInfo Source # 
type AttrLabel RecentChooserRecentManagerPropertyInfo Source # 
type AttrGetType RecentChooserRecentManagerPropertyInfo Source # 
type AttrBaseTypeConstraint RecentChooserRecentManagerPropertyInfo Source # 
type AttrSetTypeConstraint RecentChooserRecentManagerPropertyInfo Source # 
type AttrAllowedOps RecentChooserRecentManagerPropertyInfo Source # 

selectMultiple

data RecentChooserSelectMultiplePropertyInfo Source #

Instances

AttrInfo RecentChooserSelectMultiplePropertyInfo Source # 
type AttrOrigin RecentChooserSelectMultiplePropertyInfo Source # 
type AttrLabel RecentChooserSelectMultiplePropertyInfo Source # 
type AttrGetType RecentChooserSelectMultiplePropertyInfo Source # 
type AttrBaseTypeConstraint RecentChooserSelectMultiplePropertyInfo Source # 
type AttrSetTypeConstraint RecentChooserSelectMultiplePropertyInfo Source # 
type AttrAllowedOps RecentChooserSelectMultiplePropertyInfo Source # 

showIcons

data RecentChooserShowIconsPropertyInfo Source #

Instances

AttrInfo RecentChooserShowIconsPropertyInfo Source # 
type AttrOrigin RecentChooserShowIconsPropertyInfo Source # 
type AttrLabel RecentChooserShowIconsPropertyInfo Source # 
type AttrGetType RecentChooserShowIconsPropertyInfo Source # 
type AttrBaseTypeConstraint RecentChooserShowIconsPropertyInfo Source # 
type AttrSetTypeConstraint RecentChooserShowIconsPropertyInfo Source # 
type AttrAllowedOps RecentChooserShowIconsPropertyInfo Source # 

showNotFound

data RecentChooserShowNotFoundPropertyInfo Source #

Instances

AttrInfo RecentChooserShowNotFoundPropertyInfo Source # 
type AttrOrigin RecentChooserShowNotFoundPropertyInfo Source # 
type AttrLabel RecentChooserShowNotFoundPropertyInfo Source # 
type AttrGetType RecentChooserShowNotFoundPropertyInfo Source # 
type AttrBaseTypeConstraint RecentChooserShowNotFoundPropertyInfo Source # 
type AttrSetTypeConstraint RecentChooserShowNotFoundPropertyInfo Source # 
type AttrAllowedOps RecentChooserShowNotFoundPropertyInfo Source # 

showPrivate

data RecentChooserShowPrivatePropertyInfo Source #

Instances

AttrInfo RecentChooserShowPrivatePropertyInfo Source # 
type AttrOrigin RecentChooserShowPrivatePropertyInfo Source # 
type AttrLabel RecentChooserShowPrivatePropertyInfo Source # 
type AttrGetType RecentChooserShowPrivatePropertyInfo Source # 
type AttrBaseTypeConstraint RecentChooserShowPrivatePropertyInfo Source # 
type AttrSetTypeConstraint RecentChooserShowPrivatePropertyInfo Source # 
type AttrAllowedOps RecentChooserShowPrivatePropertyInfo Source # 

showTips

data RecentChooserShowTipsPropertyInfo Source #

Instances

AttrInfo RecentChooserShowTipsPropertyInfo Source # 
type AttrOrigin RecentChooserShowTipsPropertyInfo Source # 
type AttrLabel RecentChooserShowTipsPropertyInfo Source # 
type AttrGetType RecentChooserShowTipsPropertyInfo Source # 
type AttrBaseTypeConstraint RecentChooserShowTipsPropertyInfo Source # 
type AttrSetTypeConstraint RecentChooserShowTipsPropertyInfo Source # 
type AttrAllowedOps RecentChooserShowTipsPropertyInfo Source # 

sortType

data RecentChooserSortTypePropertyInfo Source #

Instances

AttrInfo RecentChooserSortTypePropertyInfo Source # 
type AttrOrigin RecentChooserSortTypePropertyInfo Source # 
type AttrLabel RecentChooserSortTypePropertyInfo Source # 
type AttrGetType RecentChooserSortTypePropertyInfo Source # 
type AttrBaseTypeConstraint RecentChooserSortTypePropertyInfo Source # 
type AttrSetTypeConstraint RecentChooserSortTypePropertyInfo Source # 
type AttrAllowedOps RecentChooserSortTypePropertyInfo Source # 

Signals

itemActivated

selectionChanged