forked from AuroraMiddleware/gtk
f060a9866f
2006-08-14 Emmanuele Bassi <ebassi@gnome.org> * gtk/tmpl/gtkrecentchoosermenu.sgml: Add a warning about the semantics of gtk_recent_chooser_add_filter() and of gtk_recent_chooser_remove_filter() when applied to a GtkRecentChooserMenu.
89 lines
1.9 KiB
Plaintext
89 lines
1.9 KiB
Plaintext
<!-- ##### SECTION Title ##### -->
|
|
GtkRecentChooserMenu
|
|
|
|
<!-- ##### SECTION Short_Description ##### -->
|
|
Displays recently used files in a menu
|
|
|
|
<!-- ##### SECTION Long_Description ##### -->
|
|
<para>
|
|
#GtkRecentChooserMenu is a widget suitable for displaying recently used files
|
|
inside a menu. It can be used to set a sub-menu of a #GtkMenuItem using
|
|
gtk_menu_item_set_submenu(), or as the menu of a #GtkMenuToolButton.
|
|
</para>
|
|
|
|
<para>
|
|
Note that #GtkRecentChooserMenu does not have any methods of its own. Instead,
|
|
you should use the functions that work on a #GtkRecentChooser.
|
|
</para>
|
|
|
|
<para>
|
|
Note also that #GtkRecentChooserMenu does not support multiple filters, as it
|
|
has no way to let the user choose between them as the #GtkRecentChooserWidget
|
|
and #GtkRecentChooserDialog widgets do. Thus using gtk_recent_chooser_add_filter()
|
|
on a #GtkRecentChooserMenu 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 #GtkRecentFilter object and will unset the current filter;
|
|
gtk_recent_chooser_list_filters() will return a list containing a single
|
|
#GtkRecentFilter object.
|
|
</para>
|
|
|
|
<para>
|
|
Recently used files are supported since GTK+ 2.10.
|
|
</para>
|
|
|
|
<!-- ##### SECTION See_Also ##### -->
|
|
<para>
|
|
#GtkRecentChooser
|
|
</para>
|
|
|
|
<!-- ##### SECTION Stability_Level ##### -->
|
|
|
|
|
|
<!-- ##### STRUCT GtkRecentChooserMenu ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
|
|
<!-- ##### ARG GtkRecentChooserMenu:show-numbers ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
<!-- ##### FUNCTION gtk_recent_chooser_menu_new ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_recent_chooser_menu_new_for_manager ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@manager:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_recent_chooser_menu_get_show_numbers ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@menu:
|
|
@Returns:
|
|
|
|
|
|
<!-- ##### FUNCTION gtk_recent_chooser_menu_set_show_numbers ##### -->
|
|
<para>
|
|
|
|
</para>
|
|
|
|
@menu:
|
|
@show_numbers:
|
|
|
|
|