GtkFileChooserWidget

GtkFileChooserWidget — Виджет выбора файла

Функции

Свойства

gboolean	режим-поиска	Чтение / Запись
char *	подпись	Чтение

Сигналы

void	папка-на-рабочем-столе	Действие
void	папка-вниз	Действие
void	папка-мой-компьютер	Действие
void	выпадающее-меню-расположения	Действие
void	выпадающее-меню-расположения-при-вставке	Действие
void	переключатель-выпадающего-меню-расположения	Действие
void	ярлык-мест	Действие
void	быстрый-закладкa	Действие
void	ярлык-недавних	Действие
void	ярлык-поиска	Действие
void	показать-скрытые	Действие
void	папка-вверх	Действие

Типы и значения

GtkFileChooserWidget

Иерархия объектов

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkFileChooserWidget

Реализованные интерфейсы

GtkFileChooserWidget реализует GtkAccessible, GtkBuildable, GtkConstraintTarget и GtkFileChooser.

Включаемые файлы

#include <gtk/gtk.h>

Описание

GtkFileChooserWidget — это виджет для выбора файлов. Он предоставляет интерфейс GtkFileChooser, и вы должны использовать методы этого интерфейса для взаимодействия с виджетом.

Узлы CSS

GtkFileChooserWidget имеет единственный узел CSS с именем filechooser.

Функции

GtkWidget *
gtk_file_chooser_widget_new (GtkFileChooserAction action);

Создаёт новый виджет GtkFileChooserWidget. Это виджет выбора файла, который можно встроить в пользовательские окна, и он тот же виджет, что используется GtkFileChooserDialog.

Параметры

действие

Режим открытия или сохранения для виджета

Возвращает

новый GtkFileChooserWidget

Типы и значения

GtkFileChooserWidget

typedef struct _GtkFileChooserWidget GtkFileChooserWidget;

Подробное описание свойств

Свойство `“search-mode”`

  “search-mode”              gboolean

Режим поиска.

Владелец: GtkFileChooserWidget

Флаги: Чтение / Запись

Значение по умолчанию: FALSE

Свойство `“subtitle”`

  “subtitle”                 char *

Подпись.

Владелец: GtkFileChooserWidget

Флаги: Чтение

Значение по умолчанию: ""

Подробности сигналов

Сигнал `“desktop-folder”`

void
user_function (GtkFileChooserWidget *widget,
               gpointer              user_data)

Сигнал ::desktop-folder — это сигнал для привязки сочетания клавиш, который генерируется, когда пользователь его запросит.

Он используется для отображения папки «Рабочий стол» пользователя в списке файлов менеджера файлов.

Стандартная привязка для этого сигнала — Alt + D.

Параметры

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

Флаги: Действие

Сигнал `“down-folder”`

void
user_function (GtkFileChooserWidget *widget,
               gpointer              user_data)

Сигнал ::down-folder — это сигнал для привязки сочетания клавиш, который генерируется, когда пользователь его запросит.

Он используется для перехода к дочерней папке текущей папки в иерархии файлов. Подпапка, которая будет использована, отображается в строке пути виджета менеджера файлов. Например, если в строке пути отображается "/foo/bar/baz", а в данный момент отображается "bar", то этот сигнал приведет к переключению менеджера файлов на подпапку "baz".

Стандартная привязка для этого сигнала — Alt + Down.

Параметры

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

Флаги: Действие

Сигнал `“home-folder”`

void
user_function (GtkFileChooserWidget *widget,
               gpointer              user_data)

Сигнал ::home-folder — это сигнал для привязки сочетания клавиш, который генерируется, когда пользователь его запросит.

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

Стандартная привязка для этого сигнала — Alt + Home.

Параметры

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

Флаги: Действие

Сигнал `“location-popup”`

void
user_function (GtkFileChooserWidget *widget,
               char                 *path,
               gpointer              user_data)

Сигнал ::location-popup — это сигнал для привязки сочетания клавиш, который генерируется, когда пользователь его запросит.

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

Стандартные привязки для этого сигнала — Control + L со строкой path равной "" (пустая строка). Также он привязан к / со строкой path равной "/" (слеш): это позволяет ввести / и сразу ввести имя пути. В системах Unix он привязан к ~ (тильда) со строкой path равной "~" для доступа к домашним каталогам.

Параметры

widget	объект, получивший сигнал
path	строка, которая отображается в поле ввода имени файла
user_data	данные пользователя, заданные при подключении обработчика сигнала.

Флаги: Действие

Сигнал `“location-popup-on-paste”`

void
user_function (GtkFileChooserWidget *widget,
               gpointer              user_data)

Сигнал ::location-popup-on-paste — это сигнал для привязки сочетания клавиш, который генерируется, когда пользователь его запросит.

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

Стандартная привязка для этого сигнала — Control + V.

Параметры

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

Флаги: Действие

Сигнал `“location-toggle-popup”`

void
user_function (GtkFileChooserWidget *widget,
               gpointer              user_data)

Сигнал ::location-toggle-popup — это сигнал для привязки сочетания клавиш, который генерируется, когда пользователь его запросит.

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

Стандартная привязка для этого сигнала — Control + L.

Параметры

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

Флаги: Действие

Сигнал `“places-shortcut”`

void
user_function (GtkFileChooserWidget *widget,
               gpointer              user_data)

Сигнал ::places-shortcut — это сигнал для привязки сочетания клавиш, который генерируется, когда пользователь его запросит.

Он используется для перевода фокуса на боковую панель с местами.

Стандартная привязка для этого сигнала — Alt + P.

Параметры

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

Флаги: Действие

Сигнал `“quick-bookmark”`

void
user_function (GtkFileChooserWidget *widget,
               int                   bookmark_index,
               gpointer              user_data)

Сигнал ::quick-bookmark — это сигнал для привязки сочетания клавиш, который генерируется, когда пользователь его запросит.

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

Стандартные привязки для этого сигнала — Alt + 1, Alt + 2, и так далее до Alt + 0. Обратите внимание, что в стандартной привязке Alt + 1 фактически определяет переключение на закладку с индексом 0, и так далее последовательно; Alt + 0 определяет переключение на закладку с индексом 10.

Параметры

widget	объект, получивший сигнал
bookmark_index	номер закладки, на которую нужно переключиться
user_data	данные пользователя, заданные при подключении обработчика сигнала.

Флаги: Действие

Сигнал `“recent-shortcut”`

void
user_function (GtkFileChooserWidget *widget,
               gpointer              user_data)

Сигнал ::recent-shortcut — это сигнал для привязки сочетания клавиш, который генерируется, когда пользователь его запросит.

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

Стандартная привязка для этого сигнала — Alt + R.

Параметры

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

Флаги: Действие

Сигнал `“search-shortcut”`

void
user_function (GtkFileChooserWidget *widget,
               gpointer              user_data)

Сигнал ::search-shortcut — это сигнал для привязки сочетаний клавиш, который генерируется при запросе пользователя.

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

По умолчанию для этого сигнала установлена привязка Alt + S.

Параметры

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

Флаги: Action

Сигнал `“show-hidden”`

void
user_function (GtkFileChooserWidget *widget,
               gpointer              user_data)

Сигнал ::show-hidden — это сигнал для привязки сочетаний клавиш, который генерируется при запросе пользователя.

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

По умолчанию для этого сигнала установлена привязка Control + H.

Параметры

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

Флаги: Action

Сигнал `“up-folder”`

void
user_function (GtkFileChooserWidget *widget,
               gpointer              user_data)

Сигнал ::up-folder — это сигнал для привязки сочетаний клавиш, который генерируется при запросе пользователя.

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

По умолчанию для этого сигнала установлена привязка Alt + Up.

Параметры

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

Флаги: Action

См. также

GtkFileChooserDialog

© 2005–2020 The GNOME Project
Licensed under the GNU Lesser General Public License version 2.1 or later.
https://developer-old.gnome.org/gtk4/4.0/GtkFileChooserWidget.html

GtkFileChooserWidget

Функции

Свойства

Сигналы

Типы и значения

Иерархия объектов

Реализованные интерфейсы

Включаемые файлы

Описание

Узлы CSS

Функции

gtk_file_chooser_widget_new ()

Параметры

Возвращает

Типы и значения

GtkFileChooserWidget

Подробное описание свойств

Свойство “search-mode”

Свойство “subtitle”

Подробности сигналов

Сигнал “desktop-folder”

Параметры

Сигнал “down-folder”

Параметры

Сигнал “home-folder”

Параметры

Сигнал “location-popup”

Параметры

Сигнал “location-popup-on-paste”

Параметры

Сигнал “location-toggle-popup”

Параметры

Сигнал “places-shortcut”

Параметры

Сигнал “quick-bookmark”

Параметры

Сигнал “recent-shortcut”

Параметры

Сигнал “search-shortcut”

Параметры

Сигнал “show-hidden”

Параметры

Сигнал “up-folder”

Параметры

См. также

Свойство `“search-mode”`

Свойство `“subtitle”`

Сигнал `“desktop-folder”`

Сигнал `“down-folder”`

Сигнал `“home-folder”`

Сигнал `“location-popup”`

Сигнал `“location-popup-on-paste”`

Сигнал `“location-toggle-popup”`

Сигнал `“places-shortcut”`

Сигнал `“quick-bookmark”`

Сигнал `“recent-shortcut”`

Сигнал `“search-shortcut”`

Сигнал `“show-hidden”`

Сигнал `“up-folder”`