GtkShortcutsWindow

说明 [src]

final class Gtk.ShortcutsWindow : Gtk.Window
  implements Gtk.Accessible, Gtk.Buildable, Gtk.ConstraintTarget, Gtk.Native, Gtk.Root, Gtk.ShortcutManager {
  /* No available fields */
}

GtkShortcutsWindow 显示有关应用程序的键盘快捷键和手势的信息。

快捷键可以分组,并且可以在此窗口中有多个节,对应于应用程序的主要模式。

此外,快捷键可以按当前视图进行筛选,以避免显示在当前应用程序上下文中不相关的。

构造 GtkShortcutsWindow 的推荐方法是使用 GtkBuilder,通过使用 <child> 标记使用一个或多个 GtkShortcutsSection 对象填充 GtkShortcutsWindow,其中包含一个或多个 GtkShortcutsGroup 实例,进而包含 GtkShortcutsShortcut 实例。

如果需要以编程方式添加节,请使用 gtk_shortcuts_window_add_section() 代替 gtk_window_set_child(),因为快捷键窗口直接管理其子对象。

一个简单的示例:

此示例只有一个节。如您所见,快捷键组按列排列,如果在一个页面上找不到太多内容,则分布在多个页面上。

此示例的 .ui 文件可在 此处 找到。

包含多个视图的示例:

此示例显示已配置为仅显示与“Stopwatch”视图相关的快捷键的 GtkShortcutsWindow

此示例的 .ui 文件可在 此处 找到。

包含多个节的示例:

此示例显示带有两个节的 GtkShortcutsWindow,“编辑器快捷方式”和“终端快捷方式”。

此示例的 .ui 文件可在 此处 找到。

快捷键和手势

以下信号具有默认键绑定

CSS 节点

GtkShortcutsWindow 具有一个名称为 window 以及样式类 .shortcuts 的单个 CSS 节点。

层次结构

hierarchy this GtkShortcutsWindow implements_0 GtkAccessible this--implements_0 implements_1 GtkBuildable this--implements_1 implements_2 GtkConstraintTarget this--implements_2 implements_3 GtkNative this--implements_3 implements_4 GtkRoot this--implements_4 implements_5 GtkShortcutManager this--implements_5 ancestor_0 GtkWindow ancestor_0--this ancestor_1 GtkWidget ancestor_1--ancestor_0 ancestor_2 GInitiallyUnowned ancestor_2--ancestor_1 ancestor_3 GObject ancestor_3--ancestor_2

实例方法

gtk_shortcuts_window_add_section

在快捷方式窗口中添加一个部分。

since: 4.14

GtkWindow 继承的方法 (55)

有关方法的完整列表,请参阅 GtkWindow

GtkWidget 继承的方法 (162)

有关方法的完整列表,请参阅 GtkWidget

GObject 继承的方法 (43)

有关方法的完整列表,请参阅 GObject

GtkAccessible 继承的方法 (19)
gtk_accessible_announce

请求用户屏幕阅读器播报给定的消息。

since: 4.14

gtk_accessible_get_accessible_parent

检索一个辅助对象的可辅助父对象。

since: 4.10

gtk_accessible_get_accessible_role

检索一个辅助对象的可辅助角色。

gtk_accessible_get_at_context

检索给定辅助对象的实现。

since: 4.10

gtk_accessible_get_bounds

查询此可辅助对象的坐标和维数。

since: 4.10

gtk_accessible_get_first_accessible_child

检索一个辅助对象的第一个辅助子对象。

since: 4.10

gtk_accessible_get_next_accessible_sibling

检索一个辅助对象的下一个辅助兄弟对象。

since: 4.10

gtk_accessible_get_platform_state

查询平台状态,例如焦点。

since: 4.10

gtk_accessible_reset_property

将辅助属性重置为其默认值。

gtk_accessible_reset_relation

将辅助关系重置为其默认值。

gtk_accessible_reset_state

将辅助状态重置为其默认值。

gtk_accessible_set_accessible_parent

设置一个辅助对象的父对象和兄弟对象。

since: 4.10

gtk_accessible_update_next_accessible_sibling

更新下一个辅助兄弟对象。

since: 4.10

gtk_accessible_update_property

更新一个辅助属性列表。

gtk_accessible_update_property_value

更新一个辅助属性数组。

gtk_accessible_update_relation

更新一个辅助关系列表。

gtk_accessible_update_relation_value

更新一个辅助关系数组。

gtk_accessible_update_state

更新一个辅助状态列表。

gtk_accessible_update_state_value

更新一个辅助状态数组。

GtkBuildable 继承的方法 (1)
gtk_buildable_get_buildable_id

获取 buildable 对象的 ID

GtkNative 继承的方法 (5)
gtk_native_get_renderer

返回用于此 GtkNative 的渲染。

gtk_native_get_surface

返回此 GtkNative 的表面。

gtk_native_get_surface_transform

检索 self 的表面变换。

gtk_native_realize

实现一个 GtkNative

gtk_native_unrealize

取消实现一个 GtkNative

GtkRoot 继承的方法 (3)
gtk_root_get_display

返回此 GtkRoot 所在的显示。

gtk_root_get_focus

检索根节点内当前获得焦点的微件。

gtk_root_set_focus

如果 focus 不是当前获得焦点的微件,并且可获得焦点,则将其设置为根节点的焦点微件。

属性

Gtk.ShortcutsWindow:section-name

要显示的部分的名称。

Gtk.ShortcutsWindow:view-name

用来过滤内容的视图名称。

GtkWindow 继承的属性 (25)
Gtk.Window:application

与窗口关联的 GtkApplication

Gtk.Window:child

子微件。

Gtk.Window:decorated

窗口是否应带有一个框架(也称为装饰)。

Gtk.Window:default-height

窗口的默认高度。

Gtk.Window:default-widget

默认窗口小部件。

Gtk.Window:default-width

窗口的默认宽度。

Gtk.Window:deletable

窗口框架是否应带有关闭按钮。

Gtk.Window:destroy-with-parent

当父级被销毁时,是否应销毁此窗口。

Gtk.Window:display

将显示此窗口的显示器。

Gtk.Window:focus-visible

是否可以在此窗口中看见“焦点矩形”。

Gtk.Window:focus-widget

焦点窗口小部件。

Gtk.Window:fullscreened

窗口是否为全屏。

Gtk.Window:handle-menubar-accel

窗口框架是否应处理用于激活菜单栏的 F10

since: 4.2

Gtk.Window:hide-on-close

当用户单击关闭按钮时,是否应隐藏此窗口。

Gtk.Window:icon-name

指定要作为窗口图标使用的主题图标的名称。

Gtk.Window:is-active

顶层是否为当前活动窗口。

Gtk.Window:maximized

窗口是否已最大化。

Gtk.Window:mnemonics-visible

是否可以在此窗口中看见助记符。

Gtk.Window:modal

如果为真,则窗口为模态窗口。

Gtk.Window:resizable

如果为真,则用户可以调整窗口大小。

Gtk.Window:startup-id

用于设置窗口启动通知标识符的只写属性。

Gtk.Window:suspended

窗口是否已暂停。

since: 4.12

Gtk.Window:title

窗口的标题。

Gtk.Window:titlebar

标题栏窗口小部件。

since: 4.6

Gtk.Window:transient-for

窗口的瞬态父级。

GtkWidget 继承的属性(34)
Gtk.Widget:can-focus

窗口小部件或其任何子孙代是否可以接受输入焦点。

Gtk.Widget:can-target

窗口小部件是否可以接收指针事件。

Gtk.Widget:css-classes

应用于此窗口小部件的 CSS 类别列表。

Gtk.Widget:css-name

此窗口小部件在 CSS 树中的名称。

Gtk.Widget:cursor

widget 使用的游标。

Gtk.Widget:focus-on-click

当用鼠标单击该窗口小部件时,窗口小部件是否应获取焦点。

Gtk.Widget:focusable

此窗口小部件本身是否接受输入焦点。

Gtk.Widget:halign

如果窗口小部件获得额外的空间,则如何分配水平空间。

Gtk.Widget:has-default

窗口小部件是否为默认窗口小部件。

Gtk.Widget:has-focus

窗口小部件是否具有输入焦点。

Gtk.Widget:has-tooltip

启用或禁用在 widget 上发出 GtkWidget::query-tooltip 信号。

Gtk.Widget:height-request

窗口小部件的高度请求的替代项。

Gtk.Widget:hexpand

是否水平扩展。

Gtk.Widget:hexpand-set

是否使用 hexpand 属性。

Gtk.Widget:layout-manager

用于计算窗口小部件的首选大小并分配其子级的 GtkLayoutManager 实例。

Gtk.Widget:margin-bottom

窗口小部件底部的边距。

Gtk.Widget:margin-end

窗口小部件末尾的边距(水平)。

Gtk.Widget:margin-start

窗口小部件开始的边距(水平)。

Gtk.Widget:margin-top

窗口小部件顶部的边距。

Gtk.Widget:name

窗口小部件的名称。

Gtk.Widget:opacity

窗口小部件的请求的不透明度。

Gtk.Widget:overflow

如何处理窗口小部件内容区域外的内容。

Gtk.Widget:parent

此窗口小部件的父窗口小部件。

Gtk.Widget:receives-default

当窗口小部件获得焦点时,它是否将接收默认操作。

Gtk.Widget:root

包含该小组件的小组件树的 GtkRoot 小组件。

Gtk.Widget:scale-factor

小组件的缩放系数。

Gtk.Widget:sensitive

小组件是否响应输入。

Gtk.Widget:tooltip-markup

将工具提示的文本设置为指定字符串,该字符串使用 Pango 标记进行标记。

Gtk.Widget:tooltip-text

将工具提示的文本设置为指定字符串。

Gtk.Widget:valign

如何分配垂直空间(如果小组件需要额外空间)。

Gtk.Widget:vexpand

是否垂直扩展。

Gtk.Widget:vexpand-set

是否使用 vexpand 属性。

Gtk.Widget:visible

小组件是否可见。

Gtk.Widget:width-request

小组件的宽度请求的覆盖。

GtkAccessible(1)继承的属性
GtkAccessible:accessible-role

给定 GtkAccessible 实现的可访问角色。

信号

Gtk.ShortcutsWindow::close

当用户使用键盘绑定关闭窗口时发出。

Gtk.ShortcutsWindow::search

当用户使用键盘绑定开始搜索时发出。

GtkWindow(5)继承的信号
GtkWindow::activate-default

当用户激活默认小组件时发出。

GtkWindow::activate-focus

当用户激活 window 当前获得焦点的窗口小组件时发出。

GtkWindow::close-request

当用户单击窗口的关闭按钮时发出。

GtkWindow::enable-debugging

当用户启用或禁用交互式调试时发出。

GtkWindow::keys-changed

当与窗口关联的加速键或助记符集发生更改时发出。

过时:4.10 

GtkWidget(13)继承的信号
GtkWidget::destroy

发出该信号,指示小组件的所有引用持有者应释放他们持有的引用。

GtkWidget::direction-changed

当小组件的文本方向更改时发出。

GtkWidget::hide

当隐藏 widget 时发出。

GtkWidget::keynav-failed

如果键盘导航失败,则发出该信号。

GtkWidget::map

当即将映射 widget 时发出。

GtkWidget::mnemonic-activate

当通过助记符激活小组件时发出。

GtkWidget::move-focus

当焦点移动时发出。

GtkWidget::query-tooltip

当小组件的工具提示即将显示时发出。

GtkWidget::realize

widgetGdkSurface 关联时发出。

GtkWidget::show

当显示 widget 时发出。

GtkWidget::state-flags-changed

当小组件状态发生变化时发出。

GtkWidget::unmap

当即将取消映射 widget 时发出。

GtkWidget::unrealize

当与 widget 关联的 GdkSurface 被销毁时发出。

GObject(1)继承的信号
GObject::notify

在某个对象的一个属性通过 g_object_set_property()、g_object_set() 等设置其值时,会在该对象上发出通知信号。