Next: , Previous: GtkRecentChooserDialog, Up: Top


150 GtkRecentChooserMenu

Displays recently used files in a menu

150.1 Overview

<gtk-recent-chooser-menu> is a widget suitable for displaying recently used files inside a menu. It can be used to set a sub-menu of a <gtk-menu-item> using gtk-menu-item-set-submenu, or as the menu of a <gtk-menu-tool-button>.

Note that <gtk-recent-chooser-menu> does not have any methods of its own. Instead, you should use the functions that work on a <gtk-recent-chooser>.

Note also that <gtk-recent-chooser-menu> does not support multiple filters, as it has no way to let the user choose between them as the <gtk-recent-chooser-widget> and <gtk-recent-chooser-dialog> widgets do. Thus using gtk-recent-chooser-add-filter on a <gtk-recent-chooser-menu> widget will yield the same effects as using gtk-recent-chooser-set-filter, replacing any currently set filter with the supplied filter; gtk-recent-chooser-remove-filter will remove any currently set <gtk-recent-filter> object and will unset the current filter; gtk-recent-chooser-list-filters will return a list containing a single <gtk-recent-filter> object.

Recently used files are supported since GTK+ 2.10.

150.2 Usage

— Class: <gtk-recent-chooser-menu>

Derives from <gtk-recent-chooser>, <gtk-menu>.

This class defines the following slots:

show-numbers
Whether the items should be displayed with a number
— Function: gtk-recent-chooser-menu-new ⇒  (ret <gtk-widget>)

Creates a new <gtk-recent-chooser-menu> widget.

This kind of widget shows the list of recently used resources as a menu, each item as a menu item. Each item inside the menu might have an icon, representing its MIME type, and a number, for mnemonic access.

This widget implements the <gtk-recent-chooser> interface.

This widget creates its own <gtk-recent-manager> object. See the gtk-recent-chooser-menu-new-for-manager function to know how to create a <gtk-recent-chooser-menu> widget bound to another <gtk-recent-manager> object.

ret
a new <gtk-recent-chooser-menu>

Since 2.10