149 GtkRecentChooserDialog

Displays recently used files in a dialog

149.1 Overview

<gtk-recent-chooser-dialog> is a dialog box suitable for displaying the recently used documents. This widgets works by putting a <gtk-recent-chooser-widget> inside a <gtk-dialog>. It exposes the <gtk-recent-chooser-iface> interface, so you can use all the <gtk-recent-chooser> functions on the recent chooser dialog as well as those for <gtk-dialog>.

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

In the simplest of cases, you can use the following code to use a <gtk-recent-chooser-dialog> to select a recently used file:

     
     GtkWidget *dialog;
     
     dialog = gtk_recent_chooser_dialog_new ("Recent Documents",
     					parent_window,
     					GTK_STOCK_CANCEL, GTK_RESPONSE_CANCEL,
     					GTK_STOCK_OPEN, GTK_RESPONSE_ACCEPT,
     					NULL);
     
     if (gtk_dialog_run (GTK_DIALOG (dialog)) == GTK_RESPONSE_ACCEPT)
       {
         GtkRecentInfo *info;
     
         info = gtk_recent_chooser_get_current_item (GTK_RECENT_CHOOSER (dialog));
         open_file (gtk_recent_info_get_uri (info));
         gtk_recent_info_unref (info);
       }
     
     gtk_widget_destroy (dialog);
     

Recently used files are supported since GTK+ 2.10.

149.2 Usage