GtkFileChooserDialog

Типичное использование

В простейшем случае вы можете использовать следующий код, чтобы использовать GtkFileChooserDialog для выбора файла для открытия:

Для использования диалогового окна для сохранения вы можете использовать это:

Настройка диалогового окна выбора файла

Существуют различные случаи, в которых вам может потребоваться использовать GtkFileChooserDialog:

Обратите внимание, что в старых версиях документации по выбору файлов предлагалось использовать gtk_file_chooser_set_current_folder() в различных ситуациях, с намерением позволить приложению предложить разумную папку по умолчанию. Это больше не считается хорошей политикой, так как теперь окно выбора файла способно самостоятельно предлагать хорошие варианты. В общем случае, вы должны заставить окно выбора файла показать определённую папку только тогда, когда это уместно использовать gtk_file_chooser_set_filename(), то есть когда вы выполняете команду «Сохранить как» и у вас уже есть файл, сохраненный где-то.

Коды ответа

GtkFileChooserDialog унаследован от GtkDialog, поэтому кнопки в области действий имеют коды ответов, такие как GTK_RESPONSE_ACCEPT и GTK_RESPONSE_CANCEL. Например, вы могли бы вызвать gtk_file_chooser_dialog_new() следующим образом:

GtkWidget *dialog;
GtkFileChooserAction action = GTK_FILE_CHOOSER_ACTION_OPEN;
gint res;

dialog = gtk_file_chooser_dialog_new ("Open File",
                                      parent_window,
                                      action,
                                      _("_Cancel"),
                                      GTK_RESPONSE_CANCEL,
                                      _("_Open"),
                                      GTK_RESPONSE_ACCEPT,
                                      NULL);

res = gtk_dialog_run (GTK_DIALOG (dialog));
if (res == GTK_RESPONSE_ACCEPT)
  {
    char *filename;
    GtkFileChooser *chooser = GTK_FILE_CHOOSER (dialog);
    filename = gtk_file_chooser_get_filename (chooser);
    open_file (filename);
    g_free (filename);
  }

gtk_widget_destroy (dialog);

Это создаст кнопки «Отмена» и «Открыть», которые используют стандартные идентификаторы ответов из GtkResponseType. Для большинства диалоговых окон вы можете использовать свои собственные пользовательские коды ответов вместо тех, что в GtkResponseType, но GtkFileChooserDialog предполагает, что его действие типа «принять», например, кнопка «Открыть» или «Сохранить», будет иметь один из следующих кодов ответа:

Это связано с тем, что GtkFileChooserDialog должен перехватывать ответы и переключаться на папки, если это необходимо, а не позволять диалоговому окну завершиться — реализация использует эти известные коды ответов, чтобы знать, какие ответы можно заблокировать, если это уместно.

Подводя итог, убедитесь, что вы используете стандартный код ответа, когда используете GtkFileChooserDialog, чтобы обеспечить правильную работу.

gtk_file_chooser_dialog_new ()

GtkWidget *
gtk_file_chooser_dialog_new (const gchar *title,
                             GtkWindow *parent,
                             GtkFileChooserAction action,
                             const gchar *first_button_text,
                             ...);

Создаёт новое диалоговое окно GtkFileChooserDialog. Эта функция аналогична gtk_dialog_new_with_buttons().

Since: 2.4

struct GtkFileChooserDialog

struct GtkFileChooserDialog;