RecentChooserDialogRef

public struct RecentChooserDialogRef : RecentChooserDialogProtocol, GWeakCapturing

GtkRecentChooserDialog is a dialog box suitable for displaying the recently used documents. This widgets works by putting a GtkRecentChooserWidget inside a GtkDialog. It exposes the GtkRecentChooserIface interface, so you can use all the GtkRecentChooser functions on the recent chooser dialog as well as those for GtkDialog.

Note that GtkRecentChooserDialog does not have any methods of its own. Instead, you should use the functions that work on a GtkRecentChooser.

Typical usage ##

In the simplest of cases, you can use the following code to use a GtkRecentChooserDialog to select a recently used file:

(C Language Example):

GtkWidget *dialog;
gint res;

dialog = gtk_recent_chooser_dialog_new ("Recent Documents",
                                        parent_window,
                                        _("_Cancel"),
                                        GTK_RESPONSE_CANCEL,
                                        _("_Open"),
                                        GTK_RESPONSE_ACCEPT,
                                        NULL);

res = gtk_dialog_run (GTK_DIALOG (dialog));
if (res == GTK_RESPONSE_ACCEPT)
  {
    GtkRecentInfo *info;
    GtkRecentChooser *chooser = GTK_RECENT_CHOOSER (dialog);

    info = gtk_recent_chooser_get_current_item (chooser);
    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.

The RecentChooserDialogRef type acts as a lightweight Swift reference to an underlying GtkRecentChooserDialog instance. It exposes methods that can operate on this data type through RecentChooserDialogProtocol conformance. Use RecentChooserDialogRef only as an unowned reference to an existing GtkRecentChooserDialog instance.