Gtk.ShortcutsWindow

Example

Subclasses:

None

Methods

Inherited:

Gtk.Window (62), Gtk.Widget (183), GObject.Object (37), Gtk.Accessible (17), Gtk.Buildable (1), Gtk.Native (6), Gtk.Root (3)

Structs:

Gtk.WidgetClass (18), GObject.ObjectClass (5)

add_section (section)

Virtual Methods

Inherited:

Gtk.Window (5), Gtk.Widget (25), GObject.Object (7), Gtk.Accessible (6), Gtk.Buildable (9), Gtk.ShortcutManager (2)

Properties

Inherited:

Gtk.Window (25), Gtk.Widget (35), Gtk.Accessible (1)

Name	Type	Flags	Short Description
section-name	str	r/w	deprecated
view-name	str	r/w	deprecated

Signals

Inherited:

Gtk.Window (5), Gtk.Widget (13), GObject.Object (1)

Name	Short Description
close	Emitted when the user uses a keybinding to close the window. deprecated
search	Emitted when the user uses a keybinding to start a search. deprecated

Fields

Inherited:

Gtk.Window (5), Gtk.Widget (13), GObject.Object (1)

Class Details

class Gtk.ShortcutsWindow(*args, **kwargs)

Bases:

Gtk.Window

Abstract:

No

A GtkShortcutsWindow shows information about the keyboard shortcuts and gestures of an application.

The shortcuts can be grouped, and you can have multiple sections in this window, corresponding to the major modes of your application.

Additionally, the shortcuts can be filtered by the current view, to avoid showing information that is not relevant in the current application context.

The recommended way to construct a GtkShortcutsWindow is with [class`Gtk`.Builder], by using the <child> tag to populate a GtkShortcutsWindow with one or more [class`Gtk`.ShortcutsSection] objects, which contain one or more [class`Gtk`.ShortcutsGroup] instances, which, in turn, contain [class`Gtk`.ShortcutsShortcut] instances.

If you need to add a section programmatically, use [method`Gtk`.ShortcutsWindow.add_section] instead of [method`Gtk`.Window.set_child], as the shortcuts window manages its children directly.

A simple example:

<picture> <source srcset=”gedit-shortcuts-dark.png” media=”(prefers-color-scheme: dark)”> <img alt=”A simple example” src=”gedit-shortcuts.png”> </picture>

This example has as single section. As you can see, the shortcut groups are arranged in columns, and spread across several pages if there are too many to find on a single page.

The .ui file for this example can be found here.

An example with multiple views:

<picture> <source srcset=”clocks-shortcuts-dark.png” media=”(prefers-color-scheme: dark)”> <img alt=”An example with multiple views” src=”clocks-shortcuts.png”> </picture>

This example shows a GtkShortcutsWindow that has been configured to show only the shortcuts relevant to the “Stopwatch” view.

The .ui file for this example can be found here.

An example with multiple sections:

<picture> <source srcset=”builder-shortcuts-dark.png” media=”(prefers-color-scheme: dark)”> <img alt=”An example with multiple sections” src=”builder-shortcuts.png”> </picture>

This example shows a GtkShortcutsWindow with two sections, “Editor Shortcuts” and “Terminal Shortcuts”.

The .ui file for this example can be found here.

Shortcuts and Gestures

The following signals have default keybindings:

• [signal`Gtk`.ShortcutsWindow::close]

• [signal`Gtk`.ShortcutsWindow::search]

CSS nodes

GtkShortcutsWindow has a single CSS node with the name window and style class .shortcuts.

Deprecated since version 4.18: This widget will be removed in GTK 5

add_section(section)

Parameters:

section (Gtk.ShortcutsSection) – the GtkShortcutsSection to add

Adds a section to the shortcuts window.

This is the programmatic equivalent to using [class`Gtk`.Builder] and a <child> tag to add the child.

Using [method`Gtk`.Window.set_child] is not appropriate as the shortcuts window manages its children internally.

New in version 4.14.

Deprecated since version 4.18: This widget will be removed in GTK 5

Signal Details

Gtk.ShortcutsWindow.signals.close(shortcuts_window)

Signal Name:

close

Flags:

RUN_LAST, ACTION

Parameters:

shortcuts_window (Gtk.ShortcutsWindow) – The object which received the signal

Emitted when the user uses a keybinding to close the window.

This is a keybinding signal.

The default binding for this signal is the <kbd>Escape</kbd> key.

Deprecated since version 4.18: This widget will be removed in GTK 5

Gtk.ShortcutsWindow.signals.search(shortcuts_window)

Signal Name:

search

Flags:

RUN_LAST, ACTION

Parameters:

shortcuts_window (Gtk.ShortcutsWindow) – The object which received the signal

Emitted when the user uses a keybinding to start a search.

This is a keybinding signal.

The default binding for this signal is <kbd>Control</kbd>+<kbd>F</kbd>.

Deprecated since version 4.18: This widget will be removed in GTK 5

Property Details

Gtk.ShortcutsWindow.props.section_name

Name:

section-name

Type:

str

Default Value:

'internal-search'

Flags:

READABLE, WRITABLE

The name of the section to show.

This should be the section-name of one of the GtkShortcutsSection objects that are in this shortcuts window.

Deprecated since version 4.18: This widget will be removed in GTK 5

Gtk.ShortcutsWindow.props.view_name

Name:

view-name

Type:

str

Default Value:

None

Flags:

READABLE, WRITABLE

The view name by which to filter the contents.

This should correspond to the [property`Gtk`.ShortcutsGroup:view] property of some of the [class`Gtk`.ShortcutsGroup] objects that are inside this shortcuts window.

Set this to None to show all groups.

Deprecated since version 4.18: This widget will be removed in GTK 5