ShortcutsSection#

class ShortcutsSection(**properties: Any)#

Superclasses: Box, Widget, InitiallyUnowned, Object

Implemented Interfaces: Accessible, Buildable, ConstraintTarget, Orientable

A GtkShortcutsSection collects all the keyboard shortcuts and gestures for a major application mode.

If your application needs multiple sections, you should give each section a unique section_name and a title that can be shown in the section selector of the ShortcutsWindow.

The max_height property can be used to influence how the groups in the section are distributed over pages and columns.

This widget is only meant to be used with ShortcutsWindow.

The recommended way to construct a GtkShortcutsSection is with Builder, by using the <child> tag to populate a GtkShortcutsSection with one or more ShortcutsGroup instances, which in turn contain one or more ShortcutsShortcut objects.

If you need to add a group programmatically, use add_group.

Shortcuts and Gestures#

Pan gestures allow to navigate between sections.

The following signals have default keybindings:

Methods#

class ShortcutsSection
add_group(group: ShortcutsGroup) → None#

Adds a group to the shortcuts section.

This is the programmatic equivalent to using Builder and a <child> tag to add the child.

Adding children with the GtkBox API is not appropriate, as GtkShortcutsSection manages its children internally.

Added in version 4.14.

Parameters:

group – the GtkShortcutsGroup to add

Properties#

class ShortcutsSection
props.max_height: int#

The type of the None singleton.

props.section_name: str#

The type of the None singleton.

props.title: str#

The type of the None singleton.

props.view_name: str#

The type of the None singleton.

Signals#

class ShortcutsSection.signals
change_current_page(offset: int) → bool#

The type of the None singleton.

Parameters:

offset – the offset