краткое описание

#include <gtk/gtk.h>


            gtkrecentchooserdialog;
gtkwidget*  gtk_recent_chooser_dialog_new   (const gchar *title,
                                             gtkwindow *parent,
                                             const gchar *first_button_text,
                                             ...);

gtkwidget*  gtk_recent_chooser_dialog_new_for_manager
                                            (const gchar *title,
                                             gtkwindow *parent,
                                             gtkrecentmanager *manager,
                                             const gchar *first_button_text,
                                             ...);

иерархия объектов

  gobject
   +----ginitiallyunowned
         +----gtkobject

               +----gtkwidget
                     +----gtkcontainer
                           +----gtkbin
                                 +----gtkwindow
                                       +----gtkdialog

                                             +----gtkrecentchooserdialog

реализуемые интерфейсы

gtkrecentchooserdialog реализует atkimplementoriface и gtkrecentchooser.

описание

gtkrecentchooserdialog это диалог для отображения недавно использованных документов. этот виджет состоит из gtkrecentchooserwidget помещённого внутри gtkdialog. он выставляет интерфейс gtkrecentchooseriface, поэтому вы можете использовать все функции gtkrecentchooser в диалоге недавно использованных файлов также, как для gtkdialog.

помните, gtkrecentchooserdialog не имеет собственных методов. вместо них вы должны использовать функции которые работают в gtkrecentchooser.

пример 1. обычное использование

в самых простых случаях вы можете использовать следующий код для выбора недавно использованных файлов с помощью gtkrecentchooserdialog:

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);
  

недавно использованные файлы поддерживаются с версии gtk+ 2.10.

детали

gtkrecentchooserdialog

typedef struct _gtkrecentchooserdialog gtkrecentchooserdialog;

gtk_recent_chooser_dialog_new ()

gtkwidget*  gtk_recent_chooser_dialog_new   (const gchar *title,
                                             gtkwindow *parent,
                                             const gchar *first_button_text,
                                             ...);

создаёт новый gtkrecentchooserdialog. эта функция аналогична gtk_dialog_new_with_buttons().

начиная с версии 2.10

gtk_recent_chooser_dialog_new_for_manager ()

gtkwidget*  gtk_recent_chooser_dialog_new_for_manager
                                            (const gchar *title,
                                             gtkwindow *parent,
                                             gtkrecentmanager *manager,
                                             const gchar *first_button_text,
                                             ...);

создаёт новый gtkrecentchooserdialog с определенным управляющим недавно использованных файлов.

это полезно если вам нужно реализовать собственный менеджер, или если вы хотите настроить образец объекта gtkrecentmanager.

начиная с версии 2.10

смотрите также

gtkrecentchooser, gtkdialog