1
2@c %start of fragment
3
4@node GtkRecentChooserMenu
5@chapter GtkRecentChooserMenu
6Displays recently used files in a menu
7
8@section Overview
9@code{<gtk-recent-chooser-menu>} is a widget suitable for displaying recently
10used files inside a menu. It can be used to set a sub-menu of a
11@code{<gtk-menu-item>} using @code{gtk-menu-item-set-submenu}, or as the menu of
12a @code{<gtk-menu-tool-button>}.
13
14Note that @code{<gtk-recent-chooser-menu>} does not have any methods of its own.
15Instead, you should use the functions that work on a
16@code{<gtk-recent-chooser>}.
17
18Note also that @code{<gtk-recent-chooser-menu>} does not support multiple
19filters, as it has no way to let the user choose between them as the
20@code{<gtk-recent-chooser-widget>} and @code{<gtk-recent-chooser-dialog>}
21widgets do. Thus using @code{gtk-recent-chooser-add-filter} on a
22@code{<gtk-recent-chooser-menu>} widget will yield the same effects as using
23@code{gtk-recent-chooser-set-filter}, replacing any currently set filter with
24the supplied filter; @code{gtk-recent-chooser-remove-filter} will remove any
25currently set @code{<gtk-recent-filter>} object and will unset the current
26filter; @code{gtk-recent-chooser-list-filters} will return a list containing a
27single @code{<gtk-recent-filter>} object.
28
29Recently used files are supported since GTK+ 2.10.
30
31@section Usage
32@include defuns-gtkrecentchoosermenu.xml.texi
33
34@c %end of fragment
35