|  |  | GTK+ Reference Manual |
Top | Description | Object Hierarchy | Implemented Interfaces

## GtkRecentChooserDialog

GtkRecentChooserDialog — Отображение недавно использованных файлов в диалоге

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

    #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()`.

`title` : | Заголовок диалога, или `NULL`
`parent` : | Переходный родитель диалога, или `NULL`,
`first_button_text` : | Заготовленный ID или текст помещаемый в первую кнопку, или `NULL`
`...` : | ID ответа первой кнопки, затем дополнительные (кнопка, id) пары, заканчивается `NULL`
Возвращает : | новый GtkRecentChooserDialog

Начиная с версии 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.

`title` : | Заголовок диалога, или `NULL`
`parent` : | Переходный родитель диалога, или `NULL`,
`manager` : | GtkRecentManager
`first_button_text` : | Заготовленный ID или текст для первой кнопки, или `NULL`
`...` : | ID ответа первой кнопки, затем дополнительные (кнопка, id) пары, заканчивается `NULL`
Возвращает : | новый GtkRecentChooserDialog

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

## Смотрите также

GtkRecentChooser, GtkDialog