diff --git a/docs/reference/gtk/tmpl/.gitignore b/docs/reference/gtk/tmpl/.gitignore index d60266462e..0d0be57c29 100644 --- a/docs/reference/gtk/tmpl/.gitignore +++ b/docs/reference/gtk/tmpl/.gitignore @@ -12,6 +12,7 @@ gtkradiobutton.sgml gtkrange.sgml gtkrecentaction.sgml gtkrecentchooser.sgml +gtkrecentchooserdialog.sgml gtkrecentchoosermenu.sgml gtkrecentchooserwidget.sgml gtkscalebutton.sgml diff --git a/docs/reference/gtk/tmpl/gtkrecentchooserdialog.sgml b/docs/reference/gtk/tmpl/gtkrecentchooserdialog.sgml deleted file mode 100644 index fd06e2b507..0000000000 --- a/docs/reference/gtk/tmpl/gtkrecentchooserdialog.sgml +++ /dev/null @@ -1,96 +0,0 @@ - -GtkRecentChooserDialog - - -Displays recently used files in a dialog - - - -#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: - - - -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. - - - - -#GtkRecentChooser, #GtkDialog - - - - - - - - - - - - - - - - - - - -@title: -@parent: -@first_button_text: -@Varargs: -@Returns: - - - - - - - -@title: -@parent: -@manager: -@first_button_text: -@Varargs: -@Returns: - - diff --git a/gtk/gtkrecentchooserdialog.c b/gtk/gtkrecentchooserdialog.c index 058439af8d..c86910f3fa 100644 --- a/gtk/gtkrecentchooserdialog.c +++ b/gtk/gtkrecentchooserdialog.c @@ -29,6 +29,52 @@ #include + +/** + * SECTION:gtkrecentchooserdialog + * @Short_description: Displays recently used files in a dialog + * @Title: GtkRecentChooserDialog + * @See_also:#GtkRecentChooser, #GtkDialog + * + * #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: + * + * 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. + */ + + struct _GtkRecentChooserDialogPrivate { GtkRecentManager *manager;