Description

Interface implemented by widgets displaying recently used files

Methods and Functions

gtkRecentChooserSetShowPrivate(object, show.private)
gtkRecentChooserGetShowPrivate(object)
gtkRecentChooserSetShowNotFound(object, show.not.found)
gtkRecentChooserGetShowNotFound(object)
gtkRecentChooserSetShowIcons(object, show.icons)
gtkRecentChooserGetShowIcons(object)
gtkRecentChooserSetSelectMultiple(object, select.multiple)
gtkRecentChooserGetSelectMultiple(object)
gtkRecentChooserSetLocalOnly(object, local.only)
gtkRecentChooserGetLocalOnly(object)
gtkRecentChooserSetLimit(object, limit)
gtkRecentChooserGetLimit(object)
gtkRecentChooserSetShowTips(object, show.tips)
gtkRecentChooserGetShowTips(object)
gtkRecentChooserSetSortType(object, sort.type)
gtkRecentChooserGetSortType(object)
gtkRecentChooserSetSortFunc(object, sort.func, sort.data)
gtkRecentChooserSetCurrentUri(object, uri, .errwarn = TRUE)
gtkRecentChooserGetCurrentUri(object)
gtkRecentChooserGetCurrentItem(object)
gtkRecentChooserSelectUri(object, uri, .errwarn = TRUE)
gtkRecentChooserUnselectUri(object, uri)
gtkRecentChooserSelectAll(object)
gtkRecentChooserUnselectAll(object)
gtkRecentChooserGetItems(object)
gtkRecentChooserGetUris(object)
gtkRecentChooserAddFilter(object, filter)
gtkRecentChooserRemoveFilter(object, filter)
gtkRecentChooserListFilters(object)
gtkRecentChooserSetFilter(object, filter)
gtkRecentChooserGetFilter(object)

Hierarchy

Implementations

GtkRecentChooser is implemented by GtkRecentAction, GtkRecentChooserDialog, GtkRecentChooserMenu and GtkRecentChooserWidget.

Detailed Description

GtkRecentChooser 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 GtkRecentChooserWidget, GtkRecentChooserDialog and GtkRecentChooserMenu.

Recently used files are supported since GTK+ 2.10.

Structures

GtkRecentChooser

undocumented

Enums and Flags

GtkRecentChooserError

These identify the various errors that can occur while calling GtkRecentChooser functions.

not-found

Indicates that a file does not exist

invalid-uri

Indicates a malformed URI

GtkRecentSortType

Used to specify the sorting method to be applyed to the recently used resource list.

none

Do not sort the returned list of recently used resources.

mru

Sort the returned list with the most recently used items first.

lru

Sort the returned list with the least recently used items first.

custom

Sort the returned list using a custom sorting function passed using gtkRecentManagerSetSortFunc().

User Functions

GtkRecentSortFunc()

undocumented

Signals

item-activated(chooser, user.data)

This signal is emitted when the user "activates" a recent item in the recent chooser. This can happen by double-clicking on an item in the recently used resources list, or by pressing Enter. Since 2.10

chooser

the object which received the signal

user.data

user data set when the signal handler was connected.

selection-changed(chooser, user.data)

This signal is emitted when there is a change in the set of selected recently used resources. This can happen when a user modifies the selection with the mouse or the keyboard, or when explicitely calling functions to change the selection. Since 2.10

chooser

the object which received the signal

user.data

user data set when the signal handler was connected.

Properties

filter [GtkRecentFilter : * : Read / Write]

The GtkRecentFilter object to be used when displaying the recently used resources. Since 2.10

limit [integer : Read / Write]

The maximum number of recently used resources to be displayed, or -1 to display all items. By default, the GtkSetting:gtk-recent-files-limit setting is respected: you can override that limit on a particular instance of GtkRecentChooser by setting this property. Allowed values: >= -1 Default value: -1 Since 2.10

local-only [logical : Read / Write]

Whether this GtkRecentChooser should display only local (file:) resources. Default value: TRUE Since 2.10

recent-manager [GtkRecentManager : * : Write / Construct Only]

The GtkRecentManager instance used by the GtkRecentChooser to display the list of recently used resources. Since 2.10

select-multiple [logical : Read / Write]

Allow the user to select multiple resources. Default value: FALSE Since 2.10

show-icons [logical : Read / Write]

Whether this GtkRecentChooser should display an icon near the item. Default value: TRUE Since 2.10

show-not-found [logical : Read / Write]

Whether this GtkRecentChooser should display the recently used resources even if not present anymore. Setting this to FALSE will perform a potentially expensive check on every local resource (every remote resource will always be displayed). Default value: TRUE Since 2.10

show-private [logical : Read / Write]

Whether the private items should be displayed. Default value: FALSE

show-tips [logical : Read / Write]

Whether this GtkRecentChooser should display a tooltip containing the full path of the recently used resources. Default value: FALSE Since 2.10

sort-type [GtkRecentSortType : Read / Write]

Sorting order to be used when displaying the recently used resources. Default value: GTK_RECENT_SORT_NONE Since 2.10

Author(s)

Derived by RGtkGen from GTK+ documentation

References

https://developer.gnome.org/gtk2/stable/GtkRecentChooser.html

See Also

GtkRecentManager GtkRecentChooserDialog GtkRecentChooserWidget GtkRecentChooserMenu