Gtk.ShortcutsSection¶

A Gtk.ShortcutsSection 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 Gtk.ShortcutsSection :section-name and a Gtk.ShortcutsSection :title that can be shown in the section selector of the Gtk.ShortcutsWindow.

The Gtk.ShortcutsSection :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 Gtk.ShortcutsWindow.

Signal Details¶

Gtk.ShortcutsSection.signals.change_current_page(shortcuts_section, object)¶

Signal Name:

change-current-page

Flags:

RUN_LAST, ACTION

Parameters:

shortcuts_section (Gtk.ShortcutsSection) – The object which received the signal
object (int) –

Return type:

bool

Property Details¶

Gtk.ShortcutsSection.props.max_height¶

Name:: max-height
Type:: int
Default Value:: 15
Flags:: READABLE, WRITABLE, EXPLICIT_NOTIFY

The maximum number of lines to allow per column. This property can be used to influence how the groups in this section are distributed across pages and columns. The default value of 15 should work in most cases.

Gtk.ShortcutsSection.props.section_name¶

Name:: section-name
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

A unique name to identify this section among the sections added to the Gtk.ShortcutsWindow. Setting the Gtk.ShortcutsWindow :section-name property to this string will make this section shown in the Gtk.ShortcutsWindow.

Gtk.ShortcutsSection.props.title¶

Name:: title
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE

The string to show in the section selector of the Gtk.ShortcutsWindow for this section. If there is only one section, you don’t need to set a title, since the section selector will not be shown in this case.

Gtk.ShortcutsSection.props.view_name¶

Name:: view-name
Type:: str
Default Value:: None
Flags:: READABLE, WRITABLE, EXPLICIT_NOTIFY

A view name to filter the groups in this section by. See Gtk.ShortcutsGroup :view.

Applications are expected to use the Gtk.ShortcutsWindow :view-name property for this purpose.