GtkShortcutsWindow
GtkShortcutsWindow — Окно верхнего уровня, отображающее справку по сочетаниям клавиш
Свойства
| char * | section-name | Чтение / Запись |
| char * | view-name | Чтение / Запись |
Типы и значения
Реализованные интерфейсы
GtkShortcutsWindow реализует GtkAccessible, GtkBuildable, GtkConstraintTarget, GtkNative, GtkShortcutManager и GtkRoot.
Файлы заголовков
#include <gtk/gtk.h>
Описание
Окно GtkShortcutsWindow отображает краткую информацию о сочетаниях клавиш и жестах приложения. Сочетания клавиш могут быть сгруппированы, и в этом окне могут быть несколько разделов, соответствующих основным режимам работы вашего приложения.
Кроме того, сочетания клавиш могут быть отфильтрованы по текущей представлению, чтобы избежать отображения информации, которая не актуальна в текущем контексте приложения.
Рекомендуемый способ создания окна GtkShortcutsWindow — использование GtkBuilder, заполнение окна GtkShortcutsWindow одним или несколькими объектами GtkShortcutsSection, которые содержат объекты GtkShortcutsGroups, которые в свою очередь содержат объекты класса GtkShortcutsShortcut.
Простой пример:
В этом примере один раздел. Как вы можете видеть, группы сочетаний клавиш организованы в столбцы и распределены по нескольким страницам, если их слишком много, чтобы поместиться на одной странице.
Файл .ui для этого примера можно найти здесь.
Пример с несколькими представлениями:
В этом примере показано окно GtkShortcutsWindow, настроенное для отображения только сочетаний клавиш, относящихся к представлению «секундомер».
Файл .ui для этого примера можно найти здесь.
Пример с несколькими разделами:
В этом примере окно GtkShortcutsWindow содержит два раздела: «Сочетания клавиш редактора» и «Сочетания клавиш терминала».
Файл .ui для этого примера можно найти здесь.
Функции
Типы и значения
GtkShortcutsWindow
typedef struct _GtkShortcutsWindow 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-old.gnome.org/gtk4/4.0/GtkShortcutsWindow.html
