![]() |
![]() |
![]() |
GTK+ Reference Manual | ![]() |
---|---|---|---|---|
#include <gtk/gtk.h> GtkRecentChooserMenu; GtkWidget* gtk_recent_chooser_menu_new (void); GtkWidget* gtk_recent_chooser_menu_new_for_manager (GtkRecentManager *manager);gboolean gtk_recent_chooser_menu_get_show_numbers (GtkRecentChooserMenu *menu);void gtk_recent_chooser_menu_set_show_numbers (GtkRecentChooserMenu *menu,gboolean show_numbers);
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.
Note that GtkRecentChooserMenu does not have any methods of its own. Instead, you should use the functions that work on a GtkRecentChooser.
Recently used files are supported since GTK+ 2.10.
GtkWidget* gtk_recent_chooser_menu_new (void);
Creates a new GtkRecentChooserMenu 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 GtkRecentChooser interface.
This widget creates its own GtkRecentManager object. See the
gtk_recent_chooser_menu_new_for_manager()
function to know how to create
a GtkRecentChooserMenu widget bound to another GtkRecentManager object.
Returns : | a new GtkRecentChooserMenu |
Since 2.10
GtkWidget* gtk_recent_chooser_menu_new_for_manager (GtkRecentManager *manager);
Creates a new GtkRecentChooserMenu widget using manager
as
the underlying recently used resources manager.
This is useful if you have implemented your own recent manager, or if you have a customized instance of a GtkRecentManager object or if you wish to share a common GtkRecentManager object among multiple GtkRecentChooser widgets.
manager : |
a GtkRecentManager |
Returns : | a new GtkRecentChooserMenu, bound to manager .
|
Since 2.10
gboolean gtk_recent_chooser_menu_get_show_numbers (GtkRecentChooserMenu *menu);
Returns the value set by gtk_recent_chooser_menu_set_show_numbers()
.
menu : |
a GtkRecentChooserMenu |
Returns : | TRUE |
Since 2.10
void gtk_recent_chooser_menu_set_show_numbers (GtkRecentChooserMenu *menu,gboolean show_numbers);
Sets whether a number should be added to the items of menu
. The
numbers are shown to provide a unique character for a mnemonic to
be used inside the menu item's label. Only the first the items
get a number to avoid clashes.
menu : |
a GtkRecentChooserMenu |
show_numbers : |
whether to show numbers |
Since 2.10