GtkFileChooser

gtk_file_chooser_set_action ()

void
gtk_file_chooser_set_action (GtkFileChooser *chooser,
                             GtkFileChooserAction action);

Устанавливает тип операции, выполняемой диалогом выбора файла; пользовательский интерфейс адаптируется к выбранному действию. Например, опция создания новой папки может быть отображена, если действие — GTK_FILE_CHOOSER_ACTION_SAVE, но не если действие — GTK_FILE_CHOOSER_ACTION_OPEN.

С: 2.4

gtk_file_chooser_get_action ()

GtkFileChooserAction
gtk_file_chooser_get_action (GtkFileChooser *chooser);

Получает тип операции, выполняемой диалогом выбора файла; см. gtk_file_chooser_set_action().

С: 2.4

gtk_file_chooser_set_local_only ()

void
gtk_file_chooser_set_local_only (GtkFileChooser *chooser,
                                 gboolean local_only);

Устанавливает, могут ли быть выбраны только локальные файлы в диалоге выбора файла. Если local_only равно TRUE (по умолчанию), то выбранный файл или файлы гарантированно доступны через файловую систему операционной системы, и поэтому приложение только должно беспокоиться о функциях работы с именами файлов в GtkFileChooser, таких как gtk_file_chooser_get_filename(), а не функциях работы с URI, таких как gtk_file_chooser_get_uri().

На некоторых системах нелокальные файлы могут по-прежнему быть доступны с помощью локальной файловой системы через пользовательскую файловую систему (FUSE).

С: 2.4

gtk_file_chooser_get_local_only ()

gboolean
gtk_file_chooser_get_local_only (GtkFileChooser *chooser);

Получает, могут ли быть выбраны только локальные файлы в диалоге выбора файла. См. gtk_file_chooser_set_local_only()

С: 2.4

gtk_file_chooser_set_select_multiple ()

void
gtk_file_chooser_set_select_multiple (GtkFileChooser *chooser,
                                      gboolean select_multiple);

Устанавливает, можно ли выбирать несколько файлов в диалоге выбора файла. Это актуально только если действие задано как GTK_FILE_CHOOSER_ACTION_OPEN или GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER.

С: 2.4

gtk_file_chooser_get_select_multiple ()

gboolean
gtk_file_chooser_get_select_multiple (GtkFileChooser *chooser);

Получает, можно ли выбирать несколько файлов в диалоге выбора файла. См. gtk_file_chooser_set_select_multiple().

С: 2.4

gtk_file_chooser_set_show_hidden ()

void
gtk_file_chooser_set_show_hidden (GtkFileChooser *chooser,
                                  gboolean show_hidden);

Устанавливает, отображать ли скрытые файлы и папки в диалоге выбора файла.

С: 2.6

gtk_file_chooser_get_show_hidden ()

gboolean
gtk_file_chooser_get_show_hidden (GtkFileChooser *chooser);

Получает, отображать ли скрытые файлы и папки в диалоге выбора файла. См. gtk_file_chooser_set_show_hidden().

С: 2.6

gtk_file_chooser_set_do_overwrite_confirmation ()

void
gtk_file_chooser_set_do_overwrite_confirmation
                               (GtkFileChooser *chooser,
                                gboolean do_overwrite_confirmation);

Устанавливает, будет ли диалог выбора файла в режиме GTK_FILE_CHOOSER_ACTION_SAVE отображать диалог подтверждения, если пользователь вводит имя файла, который уже существует. По умолчанию это FALSE.

Если установлено значение TRUE, то chooser будет испускать сигнал “confirm-overwrite” при необходимости.

Если вам нужен только стандартный диалог подтверждения, установите значение TRUE. Вы можете переопределить способ подтверждения, обрабатывая сигнал “confirm-overwrite”; подробности см. в его документации.

С: 2.8

gtk_file_chooser_get_do_overwrite_confirmation ()

gboolean
gtk_file_chooser_get_do_overwrite_confirmation
                               (GtkFileChooser *chooser);

Определяет, установлен ли диалог подтверждения перезаписи файла при вводе пользователем существующего имени файла.

С: 2.8

gtk_file_chooser_set_create_folders ()

void
gtk_file_chooser_set_create_folders (GtkFileChooser *chooser,
                                     gboolean create_folders);

Устанавливает, будет ли файловый выборщик предлагать создавать новые папки. Это актуально только если действие не установлено как GTK_FILE_CHOOSER_ACTION_OPEN.

С: 2.18

gtk_file_chooser_get_create_folders ()

gboolean
gtk_file_chooser_get_create_folders (GtkFileChooser *chooser);

Возвращает, будет ли файловый выборщик предлагать создавать новые папки. См. gtk_file_chooser_set_create_folders().

С: 2.18

gtk_file_chooser_set_current_name ()

void
gtk_file_chooser_set_current_name (GtkFileChooser *chooser,
                                   const gchar *name);

Устанавливает текущее имя в файловом селекторе, как если бы его ввёл пользователь. Обратите внимание, что имя, переданное сюда, является строкой UTF-8, а не именем файла. Эта функция предназначена для использования, например, в качестве предложенного имени в диалоге «Сохранить как…». Вы можете передать «Без названия.doc» или аналогичное подходящее предложение для name.

Если вы хотите предварительно выбрать конкретный существующий файл, используйте gtk_file_chooser_set_filename() или gtk_file_chooser_set_uri() вместо этого. Обратитесь к документации этих функций для примера использования gtk_file_chooser_set_current_name() также.

С: 2.4

gtk_file_chooser_get_current_name ()

gchar *
gtk_file_chooser_get_current_name (GtkFileChooser *chooser);

Возвращает текущее имя в файловом селекторе, введённое пользователем в поле ввода «Имя».

Эта функция предназначена для использования в диалогах сохранения, чтобы получить введённое имя файла, когда сам файл ещё не существует. Например, приложение, добавляющее пользовательский дополнительный виджет в файловый выборщик для «формата файла», может захотеть изменить расширение введённого имени файла в зависимости от выбранного формата, например, с «.jpg» на «.png».

С: 3.10

gtk_file_chooser_get_filename ()

gchar *
gtk_file_chooser_get_filename (GtkFileChooser *chooser);

Возвращает имя файла для текущего выбранного файла в файловом селекторе. Имя файла возвращается в виде абсолютного пути. Если выбрано несколько файлов, возвращается одно из имён файлов случайным образом.

Если файловый выборщик находится в режиме папок, эта функция возвращает выбранную папку.

С: 2.4

gtk_file_chooser_set_filename ()

gboolean
gtk_file_chooser_set_filename (GtkFileChooser *chooser,
                               const char *filename);

Устанавливает filename в качестве текущего имени файла для файлового выборщика, перейдя к родительской папке файла и фактически выбрав файл в списке; все остальные файлы будут сняты с выбора. Если chooser находится в режиме GTK_FILE_CHOOSER_ACTION_SAVE, базовая часть имени файла также появится в поле имени файла диалога.

Обратите внимание, что файл должен существовать, иначе ничего не будет сделано, кроме изменения директории.

Вы должны использовать эту функцию только при реализации диалога сохранения, для которого у вас уже есть имя файла, в который пользователь может сохранить. Например, когда пользователь открывает существующий файл, а затем делает «Сохранить как…» для сохранения копии или изменённой версии. Если у вас нет имени файла — например, если пользователь только что создал новый файл и сохраняет его в первый раз, не вызывайте эту функцию. Вместо этого используйте что-то подобное:

В первом случае файловый выборщик предложит пользователю полезные подсказки о том, где сохранить новый файл. Во втором случае расположение файла уже известно, поэтому файловый выборщик его использует.

С: 2.4

gtk_file_chooser_select_filename ()

gboolean
gtk_file_chooser_select_filename (GtkFileChooser *chooser,
                                  const char *filename);

Выбирает имя файла. Если имя файла не находится в текущей папке chooser, то текущая папка chooser будет изменена на папку, содержащую filename.

С: 2.4

gtk_file_chooser_unselect-filename ()

void
gtk_file_chooser_unselect_filename (GtkFileChooser *chooser,
                                    const char *filename);

Снимает выбор с текущего выбранного имени файла. Если имя файла не находится в текущем каталоге, не существует или иначе не выбрано, ничего не происходит.

С: 2.4

gtk_file_chooser_select_all ()

void
gtk_file_chooser_select_all (GtkFileChooser *chooser);

Выбирает все файлы в текущей папке файлового выборщика.

С: 2.4

gtk_file_chooser_unselect_all ()

void
gtk_file_chooser_unselect_all (GtkFileChooser *chooser);

Отменяет выбор всех файлов в текущей папке файлового выбора.

Since: 2.4

gtk_file_chooser_get_filenames ()

GSList *
gtk_file_chooser_get_filenames (GtkFileChooser *chooser);

Выводит список всех выбранных файлов и подпапок в текущей папке chooser. Возвращаемые имена являются полными абсолютными путями. Если файлы в текущей папке не могут быть представлены как локальные имена файлов, они будут проигнорированы. (См. gtk_file_chooser_get_uris())

Since: 2.4

gtk_file_chooser_set_current_folder ()

gboolean
gtk_file_chooser_set_current_folder (GtkFileChooser *chooser,
                                     const gchar *filename);

Устанавливает текущую папку для chooser из локального имени файла. Пользователю будут отображены все содержимое текущей папки, а также элементы пользовательского интерфейса для перехода в другие папки.

В общем случае вы не должны использовать эту функцию. См. раздел по настройке диалога выбора файла для обоснования этого.

Since: 2.4

gtk_file_chooser_get_current_folder ()

gchar *
gtk_file_chooser_get_current_folder (GtkFileChooser *chooser);

Возвращает текущую папку chooser в виде локального имени файла. См. gtk_file_chooser_set_current_folder().

Обратите внимание, что это папка, которую в данный момент отображает файловый выборщик (например, "/home/username/Documents"), которая не является той же, что и выбранная папка, если выборщик находится в режиме GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER (например, "/home/username/Documents/selected-folder/". Для получения выбранной папки в этом режиме используйте gtk_file_chooser_get_uri() как обычный способ получения выбора.)

Since: 2.4

gtk_file_chooser_get_uri ()

gchar *
gtk_file_chooser_get_uri (GtkFileChooser *chooser);

Получает URI для выбранного файла в файловом селекторе. Если выбрано несколько файлов, одно из имён файлов будет возвращено случайным образом.

Если файловый выборщик находится в режиме папки, эта функция возвращает выбранную папку.

Since: 2.4

gtk_file_chooser_set_uri ()

gboolean
gtk_file_chooser_set_uri (GtkFileChooser *chooser,
                          const char *uri);

Устанавливает файл, на который ссылается uri, в качестве текущего файла для файлового выборщика, переходя к родительской папке URI и фактически выбирая URI в списке. Если chooser находится в режиме GTK_FILE_CHOOSER_ACTION_SAVE, имя файла URI также будет отображаться в поле имени файла диалога.

Обратите внимание, что URI должен существовать, иначе ничего не будет сделано, кроме изменения каталога.

Вы должны использовать эту функцию только при реализации диалога сохранения, для которого у вас уже есть имя файла, куда пользователь может сохранить. Например, когда пользователь открывает существующий файл, а затем делает «Сохранить как…», чтобы сохранить копию или изменённую версию. Если у вас ещё нет имени файла — например, если пользователь только что создал новый файл и сохраняет его впервые, не вызывайте эту функцию. Вместо этого используйте что-то подобное:

В первом случае файловый выборщик предложит пользователю полезные рекомендации о том, куда сохранить новый файл. Во втором случае местоположение файла уже известно, поэтому файловый выборщик использует его.

Since: 2.4

gtk_file_chooser_select_uri ()

gboolean
gtk_file_chooser_select_uri (GtkFileChooser *chooser,
                             const char *uri);

Выбирает файл по uri. Если URI не ссылается на файл в текущей папке chooser, то текущая папка chooser будет изменена на папку, содержащую filename.

Since: 2.4

gtk_file_chooser_unselect_uri ()

void
gtk_file_chooser_unselect_uri (GtkFileChooser *chooser,
                               const char *uri);

Отменяет выбор файла, на который ссылается uri. Если файл не находится в текущем каталоге, не существует или по другим причинам в настоящее время не выбран, ничего не делается.

Since: 2.4

gtk_file_chooser_get_uris ()

GSList *
gtk_file_chooser_get_uris (GtkFileChooser *chooser);

Перечисляет все выбранные файлы и подпапки в текущей папке chooser. Возвращаемые имена — полные абсолютные URI.

С: 2.4

gtk_file_chooser_set_current_folder_uri ()

gboolean
gtk_file_chooser_set_current_folder_uri
                               (GtkFileChooser *chooser,
                                const gchar *uri);

Устанавливает текущую папку для chooser по URI. Пользователю будут показаны все содержимое текущей папки, а также элементы пользовательского интерфейса для перехода в другие папки.

В общем случае, не следует использовать эту функцию. См. раздел по настройке диалога выбора файла для обоснования этого.

С: 2.4

gtk_file_chooser_get_current_folder_uri ()

gchar *
gtk_file_chooser_get_current_folder_uri
                               (GtkFileChooser *chooser);

Возвращает текущую папку chooser в виде URI. См. gtk_file_chooser_set_current_folder_uri().

Обратите внимание, что это папка, которая в данный момент отображается в окне выбора файла (например, "file:///home/username/Documents"), а не текущая выбранная папка, если окно выбора файла находится в режиме GTK_FILE_CHOOSER_ACTION_SELECT_FOLDER (например, "file:///home/username/Documents/selected-folder/". Чтобы получить текущую выбранную папку в этом режиме, используйте gtk_file_chooser_get_uri() как обычный способ получения выбора).

С: 2.4

gtk_file_chooser_set_preview_widget ()

void
gtk_file_chooser_set_preview_widget (GtkFileChooser *chooser,
                                     GtkWidget *preview_widget);

Устанавливает виджет, предоставленный приложением, для отображения пользовательского предварительного просмотра текущего выбранного файла. Для реализации предварительного просмотра после установки виджета предварительного просмотра подключитесь к сигналу “update-preview” и вызовите gtk_file_chooser_get_preview_filename() или gtk_file_chooser_get_preview_uri() при каждом изменении. Если можно отобразить предварительный просмотр нового файла, обновите свой виджет и активируйте предварительный просмотр, используя gtk_file_chooser_set_preview_widget_active(). В противном случае, отметьте предварительный просмотр как неактивный.

Если виджет предварительного просмотра приложения не задан или не активен, окно выбора файла не будет отображать никакой предварительный просмотр.

С: 2.4

gtk_file_chooser_get_preview_widget ()

GtkWidget *
gtk_file_chooser_get_preview_widget (GtkFileChooser *chooser);

Возвращает текущий виджет предварительного просмотра; см. gtk_file_chooser_set_preview_widget().

С: 2.4

gtk_file_chooser_set_preview_widget_active ()

void
gtk_file_chooser_set_preview_widget_active
                               (GtkFileChooser *chooser,
                                gboolean active);

Устанавливает, должен ли виджет предварительного просмотра, установленный с помощью gtk_file_chooser_set_preview_widget(), отображаться для текущего имени файла. Когда active установлено в false, окно выбора файла может отображать внутренне сгенерированный предварительный просмотр текущего файла или вообще не отображать предварительный просмотр. См. gtk_file_chooser_set_preview_widget() для получения дополнительной информации.

С: 2.4

gtk_file_chooser_get_preview_widget_active ()

gboolean
gtk_file_chooser_get_preview_widget_active
                               (GtkFileChooser *chooser);

Возвращает, должен ли виджет предварительного просмотра, установленный с помощью gtk_file_chooser_set_preview_widget(), отображаться для текущего имени файла. См. gtk_file_chooser_set_preview_widget_active().

С: 2.4

gtk_file_chooser_set_use_preview_label ()

void
gtk_file_chooser_set_use_preview_label
                               (GtkFileChooser *chooser,
                                gboolean use_label);

Устанавливает, должен ли файл-выбиратель отображать метку с именем файла, который предварительно просматривается; по умолчанию TRUE. Приложения, которые хотят отображать всю область предварительного просмотра самостоятельно, должны установить это в FALSE и отображать имя сами в своём виджете предварительного просмотра.

См. также: gtk_file_chooser_set_preview_widget()

С: 2.4

gtk_file_chooser_get_use_preview_label ()

gboolean
gtk_file_chooser_get_use_preview_label
                               (GtkFileChooser *chooser);

Определяет, нужно ли отображать имя предварительно просмотренного файла в виде метки. См. gtk_file_chooser_set_use_preview_label().

gtk_file_chooser_get_preview_filename ()

char *
gtk_file_chooser_get_preview_filename (GtkFileChooser *chooser);

Возвращает имя файла, которое должно быть предварительно просмотрено в пользовательском виджете предварительного просмотра. См. gtk_file_chooser_set_preview_widget().

С: 2.4

gtk_file_chooser_get_preview_uri ()

char *
gtk_file_chooser_get_preview_uri (GtkFileChooser *chooser);

Возвращает URI, который должен быть просмотрен в пользовательском виджете предварительного просмотра. См. gtk_file_chooser_set_preview_widget().

С: 2.4

gtk_file_chooser_set_extra_widget ()

void
gtk_file_chooser_set_extra_widget (GtkFileChooser *chooser,
                                   GtkWidget *extra_widget);

Устанавливает виджет, предоставленный приложением, для предоставления пользователю дополнительных опций.

С: 2.4

gtk_file_chooser_get_extra_widget ()

GtkWidget *
gtk_file_chooser_get_extra_widget (GtkFileChooser *chooser);

Получает текущий дополнительный виджет; см. gtk_file_chooser_set_extra_widget().

С: 2.4

gtk_file_chooser_add_choice ()

void
gtk_file_chooser_add_choice (GtkFileChooser *chooser,
                             const char *id,
                             const char *label,
                             const char **options,
                             const char **option_labels);

Добавляет «выбор» в диалог выбора файла. Обычно это реализуется как раскрывающийся список или, для булевых выборов, как флажок. Вы можете выбрать значение с помощью gtk_file_chooser_set_choice() перед отображением диалога, и вы можете получить выбранное пользователем значение в обработчике сигнала ::response с помощью gtk_file_chooser_get_choice().

Сравните gtk_file_chooser_set_extra_widget().

С: 3.22

gtk_file_chooser_remove_choice ()

void
gtk_file_chooser_remove_choice (GtkFileChooser *chooser,
                                const char *id);

Удаляет «выбор», добавленный с помощью gtk_file_chooser_add_choice().

С: 3.22

gtk_file_chooser_set_choice ()

void
gtk_file_chooser_set_choice (GtkFileChooser *chooser,
                             const char *id,
                             const char *option);

Выбирает опцию в «выборе», добавленном с помощью gtk_file_chooser_add_choice(). Для булева выбора возможными вариантами являются "true" и "false".

С: 3.22

gtk_file_chooser_get_choice ()

const char *
gtk_file_chooser_get_choice (GtkFileChooser *chooser,
                             const char *id);

Получает текущую выбранную опцию в «выборе» с заданным идентификатором.

С: 3.22

gtk_file_chooser_add_filter ()

void
gtk_file_chooser_add_filter (GtkFileChooser *chooser,
                             GtkFileFilter *filter);

Добавляет filter в список фильтров, между которыми может выбирать пользователь. При выборе фильтра отображаются только файлы, прошедшие проверку этим фильтром.

Обратите внимание, что chooser принимает на себя ответственность за фильтр, поэтому вам необходимо выполнить ref и sink, если вы хотите сохранить ссылку.

С: 2.4

gtk_file_chooser_remove_filter ()

void
gtk_file_chooser_remove_filter (GtkFileChooser *chooser,
                                GtkFileFilter *filter);

Удаляет filter из списка фильтров, между которыми может выбирать пользователь.

С: 2.4

gtk_file_chooser_list_filters ()

GSList *
gtk_file_chooser_list_filters (GtkFileChooser *chooser);

Отображает текущий набор фильтров, которые может выбрать пользователь; см. gtk_file_chooser_add_filter(), gtk_file_chooser_remove_filter().

С: 2.4

gtk_file_chooser_set_filter ()

void
gtk_file_chooser_set_filter (GtkFileChooser *chooser,
                             GtkFileFilter *filter);

Устанавливает текущий фильтр; отображаются только файлы, которые соответствуют фильтру. Если список пользовательских фильтров не пуст, то фильтр должен быть одним из фильтров в этом списке. Установка текущего фильтра, когда список фильтров пуст, полезна, если вы хотите ограничить отображаемый набор файлов, не позволяя пользователю его изменить.

С: 2.4

gtk_file_chooser_get_filter ()

GtkFileFilter *
gtk_file_chooser_get_filter (GtkFileChooser *chooser);

Возвращает текущий фильтр; см. gtk_file_chooser_set_filter().

С: 2.4

gtk_file_chooser_add_shortcut_folder ()

gboolean
gtk_file_chooser_add_shortcut_folder (GtkFileChooser *chooser,
                                      const char *folder,
                                      GError **error);

Добавляет папку для отображения с папками ярлыков в файловом менеджере. Обратите внимание, что папки ярлыков не сохраняются, так как они предоставляются приложением. Например, вы можете использовать это для добавления папки «/usr/share/mydrawprogram/Clipart» в список томов.

С: 2.4

gtk_file_chooser_remove_shortcut_folder ()

gboolean
gtk_file_chooser_remove_shortcut_folder
                               (GtkFileChooser *chooser,
                                const char *folder,
                                GError **error);

Удаляет папку из списка папок-ярлыков файлового менеджера.

С: 2.4

gtk_file_chooser_list_shortcut_folders ()

GSList *
gtk_file_chooser_list_shortcut_folders
                               (GtkFileChooser *chooser);

Запрашивает список папок-ярлыков в файловом менеджере, заданном с помощью gtk_file_chooser_add_shortcut_folder().

С: 2.4

gtk_file_chooser_add_shortcut_folder_uri ()

gboolean
gtk_file_chooser_add_shortcut_folder_uri
                               (GtkFileChooser *chooser,
                                const char *uri,
                                GError **error);

Добавляет URI папки, которая должна отображаться с папками ярлыков в файловом выборе. Обратите внимание, что папки ярлыков не сохраняются, так как они предоставляются приложением. Например, вы можете добавить папку «file:///usr/share/mydrawprogram/Clipart» в список томов.

С: 2.4

gtk_file_chooser_remove_shortcut_folder_uri ()

gboolean
gtk_file_chooser_remove_shortcut_folder_uri
                               (GtkFileChooser *chooser,
                                const char *uri,
                                GError **error);

Удаляет URI папки из списка папок ярлыков файлового выбора.

С: 2.4

gtk_file_chooser_list_shortcut_folder_uris ()

GSList *
gtk_file_chooser_list_shortcut_folder_uris
                               (GtkFileChooser *chooser);

Запрашивает список папок ярлыков в файловом выборе, заданных с помощью gtk_file_chooser_add_shortcut_folder_uri().

С: 2.4

gtk_file_chooser_get_current_folder_file ()

GFile *
gtk_file_chooser_get_current_folder_file
                               (GtkFileChooser *chooser);

Возвращает текущую папку chooser как GFile. См. gtk_file_chooser_get_current_folder_uri().

С: 2.14

gtk_file_chooser_get_file ()

GFile *
gtk_file_chooser_get_file (GtkFileChooser *chooser);

Возвращает GFile для текущего выбранного файла в файловом селекторе. Если выбрано несколько файлов, один из файлов будет возвращен случайным образом.

Если файловый выборник находится в режиме папки, эта функция возвращает выбранную папку.

С: 2.14

gtk_file_chooser_get_files ()

GSList *
gtk_file_chooser_get_files (GtkFileChooser *chooser);

Перечисляет все выбранные файлы и подпапки в текущей папке chooser как GFile. Внутренняя функция, см. gtk_file_chooser_get_uris().

С: 2.14

gtk_file_chooser_get_preview_file ()

GFile *
gtk_file_chooser_get_preview_file (GtkFileChooser *chooser);

Возвращает GFile, который должен быть предварительно просмотрен в пользовательском предварительном просмотре. Внутренняя функция, см. gtk_file_chooser_get_preview_uri().

С: 2.14

gtk_file_chooser_select_file ()

gboolean
gtk_file_chooser_select_file (GtkFileChooser *chooser,
                              GFile *file,
                              GError **error);

Выбирает файл, на который ссылается file. Внутренняя функция. См. _gtk_file_chooser_select_uri().

С: 2.14

gtk_file_chooser_set_current_folder_file ()

gboolean
gtk_file_chooser_set_current_folder_file
                               (GtkFileChooser *chooser,
                                GFile *file,
                                GError **error);

Устанавливает текущую папку для chooser из GFile. Внутренняя функция, см. gtk_file_chooser_set_current_folder_uri().

С: 2.14

gtk_file_chooser_set_file ()

gboolean
gtk_file_chooser_set_file (GtkFileChooser *chooser,
                           GFile *file,
                           GError **error);

Устанавливает file в качестве текущего имени файла для файлового выбора, переходя в родительскую папку файла и фактически выбирая файл в списке. Если chooser находится в режиме GTK_FILE_CHOOSER_ACTION_SAVE, имя файла также отобразится в поле имени файла диалога.

Если имя файла не находится в текущей папке chooser, то текущая папка chooser будет изменена на папку, содержащую filename. Это эквивалентно последовательности gtk_file_chooser_unselect_all(), за которой следует gtk_file_chooser_select_filename().

Обратите внимание, что файл должен существовать, иначе ничего не произойдёт, кроме изменения директории.

При реализации диалога сохранения используйте эту функцию, если у вас уже есть имя файла, в который пользователь может сохранить; например, когда пользователь открывает существующий файл и затем нажимает «Сохранить как…». Если у вас ещё нет имени файла — например, если пользователь только что создал новый файл и сохраняет его в первый раз, не вызывайте эту функцию. Вместо этого используйте что-то подобное:

С: 2.14

gtk_file_chooser_unselect_file ()

void
gtk_file_chooser_unselect_file (GtkFileChooser *chooser,
                                GFile *file);

Снимает выделение с файла, на который ссылается file. Если файл не в текущей директории, не существует или по какой-либо причине не выбран, ничего не делает.

С: 2.14

Сигнал “confirm-overwrite”

GtkFileChooserConfirmation
user_function (GtkFileChooser *chooser,
               gpointer        user_data)

Этот сигнал генерируется всякий раз, когда необходимо отобразить диалог подтверждения, когда пользователь выбрал имя файла, который уже существует. Сигнал генерируется только при выборе режима GTK_FILE_CHOOSER_ACTION_SAVE.

Большинству приложений достаточно включить свойство “do-overwrite-confirmation” (или вызвать функцию gtk_file_chooser_set_do_overwrite_confirmation()), и они автоматически получат стандартный диалог подтверждения. Приложения, которым нужно настроить это поведение, должны сделать это и подключиться к сигналу “confirm-overwrite”.

Обработчик этого сигнала должен вернуть значение GtkFileChooserConfirmation, которое указывает действие, которое нужно предпринять. Если обработчик определит, что пользователь хочет выбрать другое имя файла, он должен вернуть GTK_FILE_CHOOSER_CONFIRMATION_SELECT_AGAIN. Если он определит, что пользователь удовлетворён выбранным именем файла, он должен вернуть GTK_FILE_CHOOSER_CONFIRMATION_ACCEPT_FILENAME. С другой стороны, если он определит, что следует использовать стандартный диалог подтверждения, он должен вернуть GTK_FILE_CHOOSER_CONFIRMATION_CONFIRM. Следующий пример иллюстрирует это.

{
  GtkImage *preview;

  ...

  preview = gtk_image_new ();

  gtk_file_chooser_set_preview_widget (my_file_chooser, preview);
  g_signal_connect (my_file_chooser, "update-preview",
		    G_CALLBACK (update_preview_cb), preview);
}

static void
update_preview_cb (GtkFileChooser *file_chooser, gpointer data)
{
  GtkWidget *preview;
  char *filename;
  GdkPixbuf *pixbuf;
  gboolean have_preview;

  preview = GTK_WIDGET (data);
  filename = gtk_file_chooser_get_preview_filename (file_chooser);

  pixbuf = gdk_pixbuf_new_from_file_at_size (filename, 128, 128, NULL);
  have_preview = (pixbuf != NULL);
  g_free (filename);

  gtk_image_set_from_pixbuf (GTK_IMAGE (preview), pixbuf);
  if (pixbuf)
    g_object_unref (pixbuf);

  gtk_file_chooser_set_preview_widget_active (file_chooser, have_preview);
}

Флаги: Выполнить последним

С: 2.8

Сигнал “current-folder-changed”

void
user_function (GtkFileChooser *chooser,
               gpointer        user_data)

Этот сигнал генерируется, когда текущая папка в GtkFileChooser изменяется. Это может произойти из-за действия пользователя, изменяющего папки, например, выбора закладки или перехода к папке в списке файлов. Это также может произойти в результате вызова функции для явного изменения текущей папки в файловом обозревателе.

Обычно нет необходимости подключаться к этому сигналу, если вам не нужно отслеживать, какую папку отображает файловый обозреватель.

См. также: gtk_file_chooser_set_current_folder(), gtk_file_chooser_get_current_folder(), gtk_file_chooser_set_current_folder_uri(), gtk_file_chooser_get_current_folder_uri().

Флаги: Выполнить последним

Сигнал “file-activated”

void
user_function (GtkFileChooser *chooser,
               gpointer        user_data)

Этот сигнал генерируется, когда пользователь "активирует" файл в файловом обозревателе. Это может произойти при двойном щелчке по файлу в списке файлов или при нажатии Enter.

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

См. также: gtk_file_chooser_get_filename(), gtk_file_chooser_get_filenames(), gtk_file_chooser_get_uri(), gtk_file_chooser_get_uris().

Флаги: Выполнить последним

Сигнал “selection-changed”

void
user_function (GtkFileChooser *chooser,
               gpointer        user_data)

Этот сигнал генерируется при изменении набора выбранных файлов в GtkFileChooser. Это может произойти, когда пользователь изменяет выбор с помощью мыши или клавиатуры, или при явном вызове функций для изменения выбора.

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

См. также: gtk_file_chooser_select_filename(), gtk_file_chooser_unselect_filename(), gtk_file_chooser_get_filename(), gtk_file_chooser_get_filenames(), gtk_file_chooser_select_uri(), gtk_file_chooser_unselect_uri(), gtk_file_chooser_get_uri(), gtk_file_chooser_get_uris().

Флаги: Выполнить последним

Сигнал “update-preview”

void
user_function (GtkFileChooser *chooser,
               gpointer        user_data)

Этот сигнал генерируется, когда предварительный просмотр в диалоге выбора файла должен быть пересоздан. Например, это может произойти, когда изменяется выбранный файл. Вы должны использовать этот сигнал, если хотите, чтобы ваш диалог выбора файла имел виджет предварительного просмотра.

После установки виджета предварительного просмотра с помощью gtk_file_chooser_set_preview_widget(), вы должны обновить его при генерации этого сигнала. Вы можете использовать функции gtk_file_chooser_get_preview_filename() или gtk_file_chooser_get_preview_uri() для получения имени файла для предварительного просмотра. Возможно, ваш виджет не сможет просмотреть все типы файлов; ваш обработчик должен вызвать gtk_file_chooser_set_preview_widget_active(), чтобы сообщить диалогу выбора файла о том, был ли предварительный просмотр успешно сгенерирован или нет.

Обратитесь к примерам кода в Разделе «Использование виджета предварительного просмотра».

См. также: gtk_file_chooser_set_preview_widget(), gtk_file_chooser_set_preview_widget_active(), gtk_file_chooser_set_use_preview_label(), gtk_file_chooser_get_preview_filename(), gtk_file_chooser_get_preview_uri().

Флаги: Выполнить последним