Spec-Zone.ru › GTK 3.24

GtkFileChooserWidget

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

Функции

GtkWidget * gtk_file_chooser_widget_new ()

Свойства

gboolean режим_поиска Чтение / Запись
char * подзаголовок Чтение

Сигналы

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

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

struct GtkFileChooserWidget
struct GtkFileChooserWidgetClass

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

    GObject
    ╰── GInitiallyUnowned
        ╰── GtkWidget
            ╰── GtkContainer
                ╰── GtkBox
                    ╰── GtkFileChooserWidget

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

GtkFileChooserWidget реализует AtkImplementorIface, GtkBuildable, GtkOrientable, GtkFileChooser и GtkFileChooserEmbed.

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

#include <gtk/gtk.h>

Описание

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

CSS узлы

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

Функции

gtk_file_chooser_widget_new ()

GtkWidget *
gtk_file_chooser_widget_new (GtkFileChooserAction action);

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

Параметры

действие

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

Возвращает

новый GtkFileChooserWidget

С: 2.4

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

struct GtkFileChooserWidget

struct GtkFileChooserWidget;

struct GtkFileChooserWidgetClass

struct GtkFileChooserWidgetClass {
  GtkBoxClass parent_class;
};

Члены

Подробности свойств

Свойство “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 — это сигнал привязки клавиш, который генерируется, когда пользователь его запрашивает.

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

По умолчанию для этого сигнала установлена привязка 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.gnome.org/gtk3/3.24/GtkFileChooserWidget.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API