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”

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

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

Флаги: Run Last

С версии: 3.10

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

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

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

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

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

Флаги: Run Last

С версии: 3.10

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

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

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

Флаги: Run First

С версии: 3.10

Сигнал “mount”

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

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

Флаги: Run First

С версии: 3.20

Сигнал “open-location”

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

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

Флаги: Run First

С версии: 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 для того, чтобы запросить, что этот сигнал будет также отправлен для заполнения всплывающих меню.

Флаги: Run First

С: 3.10

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

void
user_function (GtkPlacesSidebar *sidebar,
               gpointer          user_data)

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

Флаги: Run First

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

void
user_function (GtkPlacesSidebar *sidebar,
               gpointer          user_data)

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

Флаги: Run First

С: 3.14

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

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

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

Флаги: Run First

С: 3.10

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

void
user_function (GtkPlacesSidebar *sidebar,
               gpointer          user_data)

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

Флаги: Run First

С: 3.18

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

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

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

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

С: 3.20

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

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

Боковая панель мест выводит этот сигнал, когда ей нужно, чтобы вызывающее приложение предоставило способ отображения отмеченных файлов. В GNOME отмеченные файлы реализуются путем установки тега nao:predefined-tag-favorite в базе данных отслеживания.

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

С: 3.22.26

Сигнал “unmount”

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

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

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

С: 3.20