Internationalisation
Bundled Plugins API
shortcut
​
Shortcut Commands

Submodules

API Overview

  • Functions - API calls offered directly by the extension
  • ​build​
  • ​new​
  • Fields - Variables which can only be accessed from an object returned by a constructor
  • ​isEnabled​
  • Methods - API calls which can only be made on an object returned by a constructor
  • ​bind​
  • ​delete​
  • ​disable​
  • ​enable​
  • ​getKeyCode​
  • ​getModifiers​
  • ​trigger​
  • ​unbind​

API Documentation

Functions

​build​

Signature
cp.commands.shortcut.build(receiverFn) -> cp.commands.shortcut.builder
Type
Function
Description
Creates a new shortcut builder.
Parameters
  • receiverFn - (optional) a function which will get passed the shortcut when the build is complete.
Returns
  • shortcut.builder which can be used to create the shortcut.
Notes
  • If provided, the receiver function will be called when the shortcut has been configured, and passed the new shortcut. The result of that function will be returned to the next stage. If no receiverFn is provided, the shortcut will be returned directly.

​new​

Signature
cp.commands.shortcut.new(modifiers, keyCode) -> shortcut
Type
Function
Description
Creates a new keyboard shortcut, attached to the specified hs.commands.command
Parameters
  • modifiers - The modifiers.
  • keyCode - The key code.
Returns
  • shortcut - The shortcut that was created.

Fields

​isEnabled​

Signature
cp.commands.shortcut:isEnabled <cp.prop: boolean>
Type
Field
Description
If true, the shortcut is enabled.

Methods

​bind​

Signature
cp.commands.shortcut:bind(pressedFn, releasedFn, repeatedFn) -> shortcut
Type
Method
Description
This function binds the shortcut to a hotkey, with the specified callback functions for pressedFn, releasedFn and repeatedFn.
Parameters
  • pressedFn - (optional) If present, this is called when the shortcut combo is pressed.
  • releasedFn - (optional) If present, this is called when the shortcut combo is released.
  • repeatedFn - (optional) If present, this is called when the shortcut combo is repeated.
Returns
  • self
Notes
  • If the shortcut is enabled, the hotkey will also be enabled at this point.

​delete​

Signature
cp.commands.shortcut:delete() -> shortcut
Type
Method
Description
Deletes a shortcut.
Parameters
  • None
Returns
  • self

​disable​

Signature
cp.commands.shortcut:disable() -> shortcut
Type
Method
Description
This disables the shortcut. If a hotkey has been bound, it will be disabled also.
Parameters
  • None
Returns
  • self

​enable​

Signature
cp.commands.shortcut:enable() -> shortcut
Type
Method
Description
This enables the shortcut. If a hotkey has been bound, it will be enabled also.
Parameters
  • None
Returns
  • self

​getKeyCode​

Signature
cp.commands.shortcut:getKeyCode() -> string
Type
Method
Description
Returns a string containing the keycode of the shortcut.
Parameters
  • None
Returns
  • string containing the keycode of the shortcut.

​getModifiers​

Signature
cp.commands.shortcut:getModifiers() -> table
Type
Method
Description
Returns a table containing the modifiers for a shortcut.
Parameters
  • None
Returns
  • table containing the modifiers of the shortcut.

​trigger​

Signature
cp.commands.shortcut:trigger() -> shortcut
Type
Method
Description
This will trigger the keystroke specified in the shortcut.
Parameters
  • None
Returns
  • self

​unbind​

Signature
cp.commands.shortcut:unbind() -> shortcut
Type
Method
Description
Unbinds a shortcut.
Parameters
  • None
Returns
  • self