GtkPlacesSidebar

gtk_places_sidebar_new ()

GtkWidget *
gtk_places_sidebar_new (void);

Создаёт новый виджет GtkPlacesSidebar.

Приложение должно подключиться, как минимум, к сигналу “open-location”, чтобы получать уведомления о выборе пользователем в боковой панели.

С: 3.10

gtk_places_sidebar_set_open_flags ()

void
gtk_places_sidebar_set_open_flags (GtkPlacesSidebar *sidebar,
                                   GtkPlacesOpenFlags flags);

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

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

При срабатывании сигнала “open-location” его аргумент флагов будет установлен в один из flags переданных в gtk_places_sidebar_set_open_flags().

Передача 0 для flags вызовет отправку GTK_PLACES_OPEN_NORMAL во все обратные вызовы сигнала «open-location».

С: 3.10

gtk_places_sidebar_get_open_flags ()

GtkPlacesOpenFlags
gtk_places_sidebar_get_open_flags (GtkPlacesSidebar *sidebar);

Получает флаги открытия.

С: 3.10

gtk_places_sidebar_set_location ()

void
gtk_places_sidebar_set_location (GtkPlacesSidebar *sidebar,
                                 GFile *location);

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

С: 3.10

gtk_places_sidebar_get_location ()

GFile *
gtk_places_sidebar_get_location (GtkPlacesSidebar *sidebar);

Получает текущее выделенное расположение в sidebar. Может быть NULL, когда ничего не выделено, например, когда gtk_places_sidebar_set_location() был вызван с расположением, отсутствующим в списке мест боковой панели.

Вы можете использовать эту функцию для получения выделения в sidebar. Также, если вы подключитесь к сигналу “populate-popup”, вы можете использовать эту функцию для получения расположения, на которое ссылаются во время обратных вызовов для элементов меню.

С: 3.10

gtk_places_sidebar_set_show_recent ()

void
gtk_places_sidebar_set_show_recent (GtkPlacesSidebar *sidebar,
                                    gboolean show_recent);

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

С: 3.18

gtk_places_sidebar_get_show_recent ()

gboolean
gtk_places_sidebar_get_show_recent (GtkPlacesSidebar *sidebar);

Возвращает значение, установленное ранее с помощью gtk_places_sidebar_set_show_recent()

С: 3.18

gtk_places_sidebar_set_show_desktop ()

void
gtk_places_sidebar_set_show_desktop (GtkPlacesSidebar *sidebar,
                                     gboolean show_desktop);

Устанавливает, отображать ли sidebar элемент для папки Рабочий стол. Значение по умолчанию определяется средой рабочего стола и настройками пользователя, но эту функцию можно использовать для переопределения на уровне приложения.

С: 3.10

gtk_places_sidebar_get_show_desktop ()

gboolean
gtk_places_sidebar_get_show_desktop (GtkPlacesSidebar *sidebar);

Возвращает значение, установленное ранее с помощью gtk_places_sidebar_set_show_desktop()

С: 3.10

gtk_places_sidebar_add_shortcut ()

void
gtk_places_sidebar_add_shortcut (GtkPlacesSidebar *sidebar,
                                 GFile *location);

Приложения могут захотеть отобразить некоторые папки в боковой панели мест, если они могут быть полезны пользователям. Например, программа рисования может добавить расположение «/usr/share/clipart» при использовании боковой панели в диалоговом окне «Вставить клипарт».

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

С: 3.10

gtk_places_sidebar_remove_shortcut ()

void
gtk_places_sidebar_remove_shortcut (GtkPlacesSidebar *sidebar,
                                    GFile *location);

Удаляет ярлык, специфичный для приложения, который ранее был вставлен с помощью gtk_places_sidebar_add_shortcut(). Если location не является ярлыком в боковой панели, ничего не происходит.

С: 3.10

gtk_places_sidebar_list_shortcuts ()

GSList *
gtk_places_sidebar_list_shortcuts (GtkPlacesSidebar *sidebar);

Получает список ярлыков.

g_slist_free_full(list,(GDestroyNotify) g_object_unref);

С: 3.10

gtk_places_sidebar_get_nth_bookmark ()

GFile *
gtk_places_sidebar_get_nth_bookmark (GtkPlacesSidebar *sidebar,
                                     gint n);

Эта функция запрашивает закладки, добавленные пользователем в боковую панель мест, и возвращает одну из них. Эта функция используется GtkFileChooser для реализации ярлыков «Alt-1», «Alt-2» и т. д., которые активируют соответствующую закладку.

С: 3.10

gtk_places_sidebar_get_show_connect-to-server ()

gboolean
gtk_places_sidebar_get_show_connect_to_server
                               (GtkPlacesSidebar *sidebar);

Возвращает значение, установленное ранее с помощью gtk_places_sidebar_set_show_connect_to_server()

gtk_places_sidebar_set-show-connect-to-server ()

void
gtk_places_sidebar_set_show_connect_to_server
                               (GtkPlacesSidebar *sidebar,
                                gboolean show_connect_to_server);

Устанавливает, нужно ли sidebar отображать элемент для подключения к сетевому серверу; по умолчанию выключено. Приложение может включить это, если оно реализует способ для пользователя подключаться к сетевым серверам напрямую.

Если вы включите это, вы должны подключиться к сигналу “show-connect-to-server”.

С: 3.10

gtk_places_sidebar_get_local-only ()

gboolean
gtk_places_sidebar_get_local_only (GtkPlacesSidebar *sidebar);

Возвращает значение, установленное ранее с помощью gtk_places_sidebar_set_local_only().

С: 3.12

gtk_places_sidebar_set-local-only ()

void
gtk_places_sidebar_set_local_only (GtkPlacesSidebar *sidebar,
                                   gboolean local_only);

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

С: 3.12

gtk_places_sidebar_get-show-enter-location ()

gboolean
gtk_places_sidebar_get_show_enter_location
                               (GtkPlacesSidebar *sidebar);

Возвращает значение, установленное ранее с помощью gtk_places_sidebar_set_show_enter_location()

С: 3.14

gtk_places_sidebar_set_show_enter_location ()

void
gtk_places_sidebar_set_show_enter_location
                               (GtkPlacesSidebar *sidebar,
                                gboolean show_enter_location);

Устанавливает, должен ли sidebar отображать элемент для ввода местоположения; по умолчанию это выключено. Приложение может включить это, если ожидается, что пользователь будет вручную вводить URL-адреса.

Если вы включите это, вам следует подключиться к сигналу “show-enter-location”.

С момента: 3.14

gtk_places_sidebar_get_show_trash ()

gboolean
gtk_places_sidebar_get_show_trash (GtkPlacesSidebar *sidebar);

Возвращает значение, ранее заданное с помощью gtk_places_sidebar_set_show_trash()

С момента: 3.18

gtk_places_sidebar_set_show_trash ()

void
gtk_places_sidebar_set_show_trash (GtkPlacesSidebar *sidebar,
                                   gboolean show_trash);

Устанавливает, должен ли sidebar отображать элемент для расположения Корзины.

С момента: 3.18

gtk_places_sidebar_get_show_other_locations ()

gboolean
gtk_places_sidebar_get_show_other_locations
                               (GtkPlacesSidebar *sidebar);

Возвращает значение, ранее заданное с помощью gtk_places_sidebar_set_show_other_locations()

С момента: 3.18

gtk_places_sidebar_set_show_other_locations ()

void
gtk_places_sidebar_set_show_other_locations
                               (GtkPlacesSidebar *sidebar,
                                gboolean show_other_locations);

Устанавливает, должен ли sidebar отображать элемент для отображения приложения в представлении «Другие расположения»; по умолчанию выключено. При установке в TRUE, постоянные устройства, такие как жёсткие диски, скрываются, в противном случае они отображаются на панели. Приложение может включить это, если оно реализует способ для пользователя видеть и взаимодействовать с дисками и сетевыми серверами напрямую.

Если вы включите это, вам следует подключиться к сигналу “show-other-locations”.

С момента: 3.18

gtk_places_sidebar_set_drop_targets_visible ()

void
gtk_places_sidebar_set_drop_targets_visible
                               (GtkPlacesSidebar *sidebar,
                                gboolean visible,
                                GdkDragContext *context);

Заставляет GtkPlacesSidebar отображать целевые области для перетаскивания, чтобы он мог отображать доступные целевые области и строку «новая закладка». Это улучшает опыт перетаскивания и позволяет приложениям отображать все доступные целевые области сразу.

Это необходимо вызывать, когда приложение знает о текущем перетаскивании, которое может быть направлено на панель. Состояние drop-targets-visible будет автоматически снято, если перетаскивание завершится в GtkPlacesSidebar. Вам нужно снять состояние только при завершении перетаскивания на другом виджете вашего приложения.

С момента: 3.18

Сигнал “drag-action-ask”

gint
user_function (GtkPlacesSidebar *sidebar,
               gint              actions,
               gpointer          user_data)

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

Флаги: Запуск последним

С: 3.10

Сигнал “drag-action-requested”

gint
user_function (GtkPlacesSidebar *sidebar,
               GdkDragContext   *context,
               GObject          *dest_file,
               gpointer          source_file_list,
               gpointer          user_data)

Когда пользователь начинает операцию перетаскивания и опускания, и панель должна запросить у приложения, какое действие перетаскивания выполнить, панель отправляет этот сигнал.

Приложение может оценить context для стандартных действий или проверить тип файлов, указанных в source_file_list, относительно возможных действий для целевого dest_file.

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

Флаги: Запуск последним

С: 3.10

Сигнал “drag-perform-drop”

void
user_function (GtkPlacesSidebar *sidebar,
               GObject          *dest_file,
               gpointer          source_file_list,
               gint              action,
               gpointer          user_data)

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

Флаги: Запуск первым

С: 3.10

Сигнал “mount”

void
user_function (GtkPlacesSidebar *sidebar,
               GMountOperation  *mount_operation,
               gpointer          user_data)

Панель мест отправляет этот сигнал, когда начинает новую операцию, так как пользователь щелкнул по расположению, которое требуется смонтировать. Таким образом, приложение, использующее GtkPlacesSidebar, может отслеживать ход операции и, например, отображать уведомление.

Флаги: Запуск первым

С: 3.20

Сигнал “open-location”

void
user_function (GtkPlacesSidebar  *sidebar,
               GObject           *location,
               GtkPlacesOpenFlags open_flags,
               gpointer           user_data)

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

Флаги: Запуск первым

С: 3.10

Сигнал “populate-popup”

void
user_function (GtkPlacesSidebar *sidebar,
               GtkWidget        *container,
               GFile            *selected_item,
               GVolume          *selected_volume,
               gpointer          user_data)

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

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

Аргумент selected_item может быть NULL в случае, если выделение относится к тому. В этом случае selected_volume будет не-NULL. В этом случае вызывающему приложению необходимо g_object_ref() selected_volume и сохранить его, чтобы использовать его в обратном вызове.

Аргумент container и всё его содержимое уничтожаются после того, как пользователь закрывает всплывающее меню. Всплывающее меню создаётся заново (и, следовательно, этот сигнал испускается) каждый раз, когда пользователь активирует контекстное меню.

До версии 3.18 container всегда был GtkMenu, и ожидалось, что вы будете добавлять свои элементы как GtkMenuItems. С версии 3.18 всплывающее меню может быть реализовано как GtkPopover, в этом случае container будет чем-то другим, например, GtkBox, к которому вы можете добавить GtkModelButtons или другие виджеты, такие как GtkEntries, GtkSpinButtons и т. д. Если ваше приложение может справиться с этой ситуацией, вы можете установить “populate-all” на TRUE, чтобы запросить, чтобы этот сигнал испускался для всплывающих окон.

Флаги: Выполнить сначала

С: 3.10

Сигнал “show-connect-to-server”

void
user_function (GtkPlacesSidebar *sidebar,
               gpointer          user_data)

Панель боковой панели мест выдает этот сигнал, когда ей необходимо, чтобы вызывающее приложение представило способ прямого подключения к сетевому серверу. Например, приложение может вывести диалоговое окно, запрашивающее URL-адрес, например, «sftp://ftp.example.com». Приложение должно создать соответствующую точку монтирования, например, используя g_file_mount_enclosing_volume().

Флаги: Выполнить сначала

Сигнал “show-enter-location”

void
user_function (GtkPlacesSidebar *sidebar,
               gpointer          user_data)

Панель боковой панели мест выдает этот сигнал, когда ей необходимо, чтобы вызывающее приложение представило способ прямого ввода расположения. Например, приложение может вывести диалоговое окно, запрашивающее URL-адрес, например, «http://http.example.com».

Флаги: Выполнить сначала

С: 3.14

Сигнал “show-error-message”

void
user_function (GtkPlacesSidebar *sidebar,
               gchar            *primary,
               gchar            *secondary,
               gpointer          user_data)

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

Флаги: Выполнить сначала

С: 3.10

Сигнал “show-other-locations”

void
user_function (GtkPlacesSidebar *sidebar,
               gpointer          user_data)

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

Флаги: Выполнить сначала

С: 3.18

Сигнал “show-other-locations-with-flags”

void
user_function (GtkPlacesSidebar  *sidebar,
               GtkPlacesOpenFlags open_flags,
               gpointer           user_data)

Панель «Места» отправляет этот сигнал, когда приложению-отправителю необходимо предоставить способ отображения других расположений, например, дисков и сетевых точек доступа. Например, приложение может отобразить страницу со постоянными томами и обнаруженными сетевыми адресами.

Флаги: Выполнить сначала

С: 3.20

Сигнал “unmount”

void
user_function (GtkPlacesSidebar *sidebar,
               GMountOperation  *mount_operation,
               gpointer          user_data)

Панель «Места» отправляет этот сигнал, когда начинает новую операцию, например, когда пользователь извлечёт диск или отмонтирует раздел. Таким образом, приложение, использующее GtkPlacesSidebar, может отслеживать ход операции и, например, отображать уведомление.

Флаги: Выполнить сначала

С: 3.20