GtkShortcutsWindow
GtkShortcutsWindow — Окно верхнего уровня, отображающее справку по сочетаниям клавиш
Свойства
| char * | section-name | Чтение/Запись |
| char * | view-name | Чтение/Запись |
Типы и значения
| struct | GtkShortcutsWindow |
Иерархия объектов
GObject
╰── GInitiallyUnowned
╰── GtkWidget
╰── GtkContainer
╰── GtkBin
╰── GtkWindow
╰── GtkShortcutsWindow
Реализованные интерфейсы
GtkShortcutsWindow реализует AtkImplementorIface и GtkBuildable.
Включаемые файлы
#include <gtk/gtk.h>
Описание
GtkShortcutsWindow отображает краткую информацию о сочетаниях клавиш и жестах приложения. Сочетания клавиш могут быть сгруппированы, и в этом окне могут быть несколько разделов, соответствующих основным режимам работы приложения.
Кроме того, сочетания клавиш могут быть отфильтрованы по текущему представлению, чтобы избежать отображения информации, которая неактуальна в текущем контексте приложения.
Рекомендуемый способ создания GtkShortcutsWindow — с помощью GtkBuilder, заполняя GtkShortcutsWindow одним или несколькими объектами GtkShortcutsSection, которые содержат объекты GtkShortcutsGroups, которые в свою очередь содержат объекты класса GtkShortcutsShortcut.
Простой пример:
В этом примере содержится один раздел. Как вы можете видеть, группы сочетаний клавиш расположены в столбцах и распределены по нескольким страницам, если их слишком много для одной страницы.
Файл .ui для этого примера можно найти здесь.
Пример с несколькими представлениями:
Этот пример показывает GtkShortcutsWindow, который настроен для отображения только сочетаний клавиш, относящихся к представлению «секундомер».
Файл .ui для этого примера можно найти здесь.
Пример с несколькими разделами:
Этот пример показывает GtkShortcutsWindow с двумя разделами: «Сочетания клавиш редактора» и «Сочетания клавиш терминала».
Файл .ui для этого примера можно найти здесь.
Функции
Типы и значения
struct GtkShortcutsWindow
struct GtkShortcutsWindow;
Подробности свойств
Свойство “section-name”
“section-name” char *
Имя раздела для отображения.
Должно соответствовать имени раздела одного из объектов GtkShortcutsSection, находящихся в этом окне сочетаний клавиш.
Владелец: GtkShortcutsWindow
Флаги: Чтение/Запись
Значение по умолчанию: «internal-search»
Свойство “view-name”
“view-name” char *
Имя представления для фильтрации содержимого.
Должно соответствовать свойству «view» некоторых объектов GtkShortcutsGroup, находящихся внутри этого окна сочетаний клавиш.
Установите в значение NULL для отображения всех групп.
Владелец: GtkShortcutsWindow
Флаги: Чтение/Запись
Значение по умолчанию: NULL
Подробности сигналов
Сигнал “close”
void user_function (GtkShortcutsWindow *shortcutswindow, gpointer user_data)
Сигнал ::close — это сигнал сочетания клавиш, который генерируется, когда пользователь использует сочетание клавиш для закрытия окна.
По умолчанию для этого сигнала задана клавиша Escape.
Параметры
user_data | данные пользователя, заданные при подключении обработчика сигналов. |
Флаги: Действие
Сигнал “search”
void user_function (GtkShortcutsWindow *shortcutswindow, gpointer user_data)
Сигнал ::search — это сигнал сочетания клавиш, который генерируется, когда пользователь использует сочетание клавиш для запуска поиска.
По умолчанию для этого сигнала заданы клавиши Control-F.
Параметры
user_data | данные пользователя, заданные при подключении обработчика сигналов. |
Флаги: Действие
© 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/GtkShortcutsWindow.html
