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.

gtk_file_chooser_get_action ()

GtkFileChooserAction
gtk_file_chooser_get_action (GtkFileChooser *chooser);

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

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.

gtk_file_chooser_get_select_multiple ()

gboolean
gtk_file_chooser_get_select_multiple (GtkFileChooser *chooser);

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

gtk_file_chooser_set_create_folders ()

void
gtk_file_chooser_set_create_folders (GtkFileChooser *chooser,
                                     gboolean create_folders);

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

gtk_file_chooser_get_create_folders ()

gboolean
gtk_file_chooser_get_create_folders (GtkFileChooser *chooser);

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

gtk_file_chooser_set_current_name ()

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

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

Если вы хотите предварительно выбрать определённый существующий файл, используйте gtk_file_chooser_set_file() вместо этого.

См. документацию по этим функциям для примера использования gtk_file_chooser_set_current_name() также.

gtk_file_chooser_get_current_name ()

char *
gtk_file_chooser_get_current_name (GtkFileChooser *chooser);

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

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

gtk_file_chooser_get_file ()

GFile *
gtk_file_chooser_get_file (GtkFileChooser *chooser);

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

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

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 .

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

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

static void
prepare_file_chooser (GtkFileChooser *chooser,
                      GFile          *existing_file)
{
  gboolean document_is_new = (existing_file == NULL);

  if (document_is_new)
    {
      GFile *default_file_for_saving = g_file_new_for_path ("./out.txt");
      // the user just created a new document
      gtk_file_chooser_set_current_folder (chooser, default_file_for_saving, NULL);
      gtk_file_chooser_set_current_name (chooser, "Untitled document");
      g_object_unref (default_file_for_saving);
    }
  else
    {
      // the user edited an existing document
      gtk_file_chooser_set_file (chooser, existing_file, NULL);
    }
}

gtk_file_chooser_get_files ()

GListModel *
gtk_file_chooser_get_files (GtkFileChooser *chooser);

Список всех выбранных файлов и подпапок в текущей папке chooser в виде GFile.

gtk_file_chooser_set_current_folder ()

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

Устанавливает текущую папку для chooser из GFile.

gtk_file_chooser_get_current_folder ()

GFile *
gtk_file_chooser_get_current_folder (GtkFileChooser *chooser);

Получает текущую папку для chooser в виде GFile.

gtk_file_chooser_add_filter ()

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

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

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

gtk_file_chooser_remove_filter ()

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

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

gtk_file_chooser_get_filters ()

GListModel *
gtk_file_chooser_get_filters (GtkFileChooser *chooser);

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

Не следует изменять возвращённую модель списка. Будущие изменения chooser могут или не могут повлиять на возвращённую модель.

gtk_file_chooser_set_filter ()

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

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

gtk_file_chooser_get_filter ()

GtkFileFilter *
gtk_file_chooser_get_filter (GtkFileChooser *chooser);

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

gtk_file_chooser_add_shortcut_folder ()

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

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

gtk_file_chooser_remove_shortcut_folder ()

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

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

gtk_file_chooser_get_shortcut_folders ()

GListModel *
gtk_file_chooser_get_shortcut_folders (GtkFileChooser *chooser);

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

Не следует изменять возвращённый список моделей. Будущие изменения в chooser могут или не могут повлиять на возвращаемую модель.

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_remove_choice ()

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

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

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».

gtk_file_chooser_get_choice ()

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

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