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);

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

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

Передача 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