Prev

Up

Home

GTK+ Reference Manual

Next

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