Class gtk-recent-chooser

Package: gtk

Superclasses

g-object, common-lisp:standard-object, common-lisp:t

Documented Subclasses

gtk-recent-action, gtk-recent-chooser-dialog, gtk-recent-chooser-menu, gtk-recent-chooser-widget

Direct Slots

filter

The filter property of type gtk-recent-filter (Read / Write)
The filter to be used when displaying the recently used resources.

limit

The limit property of type :int (Read / Write)
The maximum number of recently used resources to be displayed, or -1 to display all items. By default, the gtk-recent-files-limit setting is respected. You can override that limit on a particular instance of the gtk-recent-chooser widget by setting this property.
Allowed values: >= -1
Default value: -1

local-only

The local-only property of type :boolean (Read / Write)
Whether this gtk-recent-chooser should display only local (file:) resources.
Default value: true

recent-manager

The recent-manager property of type gtk-recent-manager (Write / Construct Only)
The recent manager used by the recent chooser to display the list of recently used resources.

select-multiple

The select-multiple property of type :boolean (Read / Write)
Allow the user to select multiple resources.
Default value: false

show-icons

The show-icons property of type :boolean (Read / Write)
Whether the recent chooser should display an icon near the item.
Default value: true

show-not-found

The show-not-found property of type :boolean (Read / Write)
Whether the recent chooser 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

show-private

The show-private property of type :boolean (Read / Write)
Whether the private items should be displayed.
Default value: false

show-tips

The show-tips property of type :boolean (Read / Write)
Whether the recent chooser should display a tooltip containing the full path of the recently used resources.
Default value: nil

sort-type

The sort-type property of type gtk-recent-sort-type (Read / Write)
Sorting order to be used when displaying the recently used resources.
Default value: :none

Details

The gtk-recent-chooser interface 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 the gtk-recent-chooser-widget, gtk-recent-chooser-dialog and gtk-recent-chooser-menu widgets.

Signal Details

The "item-activated" signal

 lambda (chooser)    :run-last

The 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 the Enter key.

chooser: The gtk-recent-chooser object which received the signal.

The "selection-changed" signal

 lambda (chooser)    :run-last

The 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.