GI.Gtk.Objects.RecentChooserDialog

RecentChooserDialog is a dialog box suitable for displaying the recently used documents. This widgets works by putting a RecentChooserWidget inside a Dialog. It exposes the RecentChooserIface interface, so you can use all the RecentChooser functions on the recent chooser dialog as well as those for Dialog.

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

## {gtkrecentchooser-typical-usage}

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

C code

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.

Exported types

newtype RecentChooserDialog

Memory-managed wrapper type.

Constructors

RecentChooserDialog (ManagedPtr RecentChooserDialog)

Instances

GObject RecentChooserDialog

Defined in GI.Gtk.Objects.RecentChooserDialog

Methods

gobjectType :: RecentChooserDialog -> IO GType

IsImplementorIface RecentChooserDialog

Defined in GI.Gtk.Objects.RecentChooserDialog

IsObject RecentChooserDialog

Defined in GI.Gtk.Objects.RecentChooserDialog

IsBuildable RecentChooserDialog

Defined in GI.Gtk.Objects.RecentChooserDialog

IsRecentChooser RecentChooserDialog

Defined in GI.Gtk.Objects.RecentChooserDialog

IsBin RecentChooserDialog

Defined in GI.Gtk.Objects.RecentChooserDialog

IsContainer RecentChooserDialog

Defined in GI.Gtk.Objects.RecentChooserDialog

IsDialog RecentChooserDialog

Defined in GI.Gtk.Objects.RecentChooserDialog

IsWidget RecentChooserDialog

Defined in GI.Gtk.Objects.RecentChooserDialog

IsWindow RecentChooserDialog

Defined in GI.Gtk.Objects.RecentChooserDialog

IsRecentChooserDialog RecentChooserDialog

Defined in GI.Gtk.Objects.RecentChooserDialog

class GObject o => IsRecentChooserDialog o

Type class for types which can be safely cast to RecentChooserDialog, for instance with toRecentChooserDialog.

Instances

(GObject a, (UnknownAncestorError RecentChooserDialog a :: Constraint)) => IsRecentChooserDialog a

Defined in GI.Gtk.Objects.RecentChooserDialog

IsRecentChooserDialog RecentChooserDialog

Defined in GI.Gtk.Objects.RecentChooserDialog

toRecentChooserDialog :: (MonadIO m, IsRecentChooserDialog o) => o -> m RecentChooserDialog

Cast to RecentChooserDialog, for types for which this is known to be safe. For general casts, use castTo.

noRecentChooserDialog :: Maybe RecentChooserDialog

A convenience alias for Nothing :: Maybe RecentChooserDialog.