Class: QgsShortcutsManager

class qgis.gui.QgsShortcutsManager(parent: QObject = None, settingsRoot: str = '')

Bases: PyQt5.QtCore.QObject

Constructor for QgsShortcutsManager.

Parameters
  • parent (QObject = None) – parent object

  • settingsRoot (str = '') – root QgsSettings path for storing settings, e.g., “/myplugin/shortcuts”. Leave as the default value to store settings alongside built in QGIS shortcuts, but care must be taken to not register actions which conflict with the built in QGIS actions.

Shortcuts manager is a class that contains a list of QActions and QShortcuts that have been registered and their shortcuts can be changed.

QgsShortcutsManager is not usually directly created, but rather accessed through QgsGui.shortcutsManager()

Methods

actionByName

Returns an action by its name, or None if nothing found.

actionForSequence

Returns the action which is associated for a shortcut sequence, or None if no action is associated.

childEvent

connectNotify

customEvent

defaultKeySequence

Returns the default sequence for an action.

disconnectNotify

isSignalConnected

listActions

Returns a list of all actions in the manager.

listAll

Returns a list of both actions and shortcuts in the manager.

listShortcuts

Returns a list of shortcuts in the manager.

objectDefaultKeySequence

Returns the default sequence for an object (either a QAction or QShortcut).

objectForSequence

Returns the object (QAction or QShortcut) matching the specified key sequence,

receivers

registerAction

Registers an action with the manager so the shortcut can be configured in GUI.

registerAllChildActions

Automatically registers all QActions which are children of the passed object.

registerAllChildShortcuts

Automatically registers all QShortcuts which are children of the passed object.

registerAllChildren

Automatically registers all QActions and QShortcuts which are children of the passed object.

registerShortcut

Registers a QShortcut with the manager so the shortcut can be configured in GUI.

sender

senderSignalIndex

setKeySequence

Modifies an action or shortcut’s key sequence.

setObjectKeySequence

Modifies an object’s (either a QAction or a QShortcut) key sequence.

settingsPath

Returns the root settings path used to store shortcut customization.

shortcutByName

Returns a shortcut by its name, or None if nothing found

shortcutForSequence

Returns the shortcut which is associated for a key sequence, or None if no shortcut is associated.

timerEvent

unregisterAction

Removes an action from the manager.

unregisterShortcut

Removes a shortcut from the manager.

actionByName(self, name: str) → QAction

Returns an action by its name, or None if nothing found.

Parameters

name (str) – action name. Must match QAction’s text.

See also

shortcutByName()

Return type

QAction

actionForSequence(self, sequence: Union[QKeySequence, QKeySequence.StandardKey, str, int]) → QAction

Returns the action which is associated for a shortcut sequence, or None if no action is associated.

Parameters

sequence (Union[QKeySequence) – shortcut key sequence

Return type

QAction

childEvent()
connectNotify()
customEvent()
defaultKeySequence(self, action: QAction) → str

Returns the default sequence for an action. An empty return string indicates no default sequence.

Parameters

action (QAction) – action to return default key sequence for

defaultKeySequence(self, shortcut: QShortcut) -> str Returns the default sequence for a shortcut. An empty return string indicates no default sequence.

Parameters

shortcut – shortcut to return default key sequence for

Return type

str

disconnectNotify()
isSignalConnected()
listActions(self) → List[QAction]

Returns a list of all actions in the manager.

See also

listShortcuts()

See also

listAll()

Return type

List[QAction]

listAll(self) → List[QObject]

Returns a list of both actions and shortcuts in the manager.

See also

listActions()

See also

listShortcuts()

Return type

List[QObject]

listShortcuts(self) → object

Returns a list of shortcuts in the manager.

See also

listActions()

See also

listAll()

Return type

object

objectDefaultKeySequence(self, object: QObject) → str

Returns the default sequence for an object (either a QAction or QShortcut). An empty return string indicates no shortcut.

Parameters

object (QObject) – QAction or QShortcut to return default key sequence for

Return type

str

objectForSequence(self, sequence: Union[QKeySequence, QKeySequence.StandardKey, str, int]) → QObject

Returns the object (QAction or QShortcut) matching the specified key sequence,

Parameters

sequence (Union[QKeySequence) – key sequence to find

Return type

QObject

Returns

object with matching sequence, or None if not found

receivers()
registerAction(self, action: QAction, defaultShortcut: str = '') → bool

Registers an action with the manager so the shortcut can be configured in GUI.

Parameters
  • action (QAction) – action to register. The action must have a unique text string for identification.

  • defaultShortcut (str = '') – default key sequence for action

Return type

bool

Returns

true if action was successfully registered

registerAllChildActions(self, object: QObject, recursive: bool = False)

Automatically registers all QActions which are children of the passed object.

Parameters
  • object (QObject) – parent object containing actions to register

  • recursive (bool = False) – set to true to recursively add child actions

See also

registerAction()

registerAllChildShortcuts(self, object: QObject, recursive: bool = False)

Automatically registers all QShortcuts which are children of the passed object.

Parameters
  • object (QObject) – parent object containing shortcuts to register

  • recursive (bool = False) – set to true to recursively add child shortcuts

registerAllChildren(self, object: QObject, recursive: bool = False)

Automatically registers all QActions and QShortcuts which are children of the passed object.

Parameters
  • object (QObject) – parent object containing actions and shortcuts to register

  • recursive (bool = False) – set to true to recursively add child actions and shortcuts

registerShortcut(self, shortcut: QShortcut, defaultSequence: str = '') → bool

Registers a QShortcut with the manager so the shortcut can be configured in GUI.

Parameters
  • shortcut (QShortcut) – QShortcut to register. The shortcut must have a unique QObject.objectName() for identification.

  • defaultSequence (str = '') – default key sequence for shortcut

Return type

bool

Returns

true if shortcut was successfully registered

See also

registerAction()

sender()
senderSignalIndex()
setKeySequence(self, name: str, sequence: str) → bool

Modifies an action or shortcut’s key sequence.

Parameters
  • name (str) – name of action or shortcut to modify. Must match the action’s QAction.text() or the shortcut’s QObject.objectName()

  • sequence (str) – new shortcut key sequence

setKeySequence(self, action: QAction, sequence: str) -> bool Modifies an action’s key sequence.

Parameters
  • action – action to modify

  • sequence – new shortcut key sequence

setKeySequence(self, shortcut: QShortcut, sequence: str) -> bool Modifies a shortcuts’s key sequence.

Parameters
  • shortcut – QShortcut to modify

  • sequence – new shortcut key sequence

Return type

bool

setObjectKeySequence(self, object: QObject, sequence: str) → bool

Modifies an object’s (either a QAction or a QShortcut) key sequence.

Parameters
  • object (QObject) – QAction or QShortcut to modify

  • sequence (str) – new shortcut key sequence

See also

setKeySequence()

Return type

bool

settingsPath(self) → str

Returns the root settings path used to store shortcut customization.

Return type

str

shortcutByName(self, name: str) → QShortcut

Returns a shortcut by its name, or None if nothing found

Parameters

name (str) – shortcut name. Must match QShortcut’s QObject.objectName() property.

See also

actionByName()

Return type

QShortcut

shortcutForSequence(self, sequence: Union[QKeySequence, QKeySequence.StandardKey, str, int]) → QShortcut

Returns the shortcut which is associated for a key sequence, or None if no shortcut is associated.

Parameters

sequence (Union[QKeySequence) – shortcut key sequence

Return type

QShortcut

timerEvent()
unregisterAction(self, action: QAction) → bool

Removes an action from the manager.

Parameters

action (QAction) – action to remove

Return type

bool

Returns

true if action was previously registered in manager and has been removed, or false if action was not previously registered in manager

See also

registerAction()

unregisterShortcut(self, shortcut: QShortcut) → bool

Removes a shortcut from the manager.

Parameters

shortcut (QShortcut) – shortcut to remove

Return type

bool

Returns

true if shortcut was previously registered in manager and has been removed, or false if shortcut was not previously registered in manager