displaying the recently used documents

displaying the recently used documents list is handled by any widget implementing the gtkrecentchooser interface. these widgets also handle the sorting and filtering of the list; they will create their own gtkrecentmanager objects by default:

        gtkwidget *chooser;
	gint response;

	/* create a new dialog with the recently used documents list shown
	 * using a gtktreeview widget
	 */
	chooser = gtk_recent_chooser_dialog_new ("recent documents",
	                                         parent_window,
						 gtk_stock_close, gtk_response_cancel,
						 gtk_stock_open, gtk_response_ok,
						 null);
        /* set the sorting order to "most recently used first" */
	gtk_recent_chooser_set_sort_type (gtk_recent_chooser (chooser), gtk_recent_sort_mru);
	response = gtk_dialog_run (gtk_dialog (chooser));
	if (response == gtk_response_ok)
	  {
	    gtkrecentinfo *info;

            info = gtk_recent_chooser_get_current_item (gtk_recent_chooser (chooser));
	    do_something_with_the_item (info);

	    gtk_recent_info_unref (info);
	  }
	
	gtk_widget_destroy (chooser);