Module: awful.keyboard

Utilities related to the keyboard and keybindings.

Info:

  • Copyright: 2018-2019 Emmanuel Lepage Vallee
  • Author: Emmanuel Lepage Vallee <[email protected]>

Functions

awful.keyboard.append_global_keybindings (keys) Add multiple awful.key based keybindings to the global set.

Static module functions

awful.keyboard.emulate_key_combination (modifiers, key) Execute a key combination.
awful.keyboard.append_global_keybinding (key) Add an awful.key based keybinding to the global set.
awful.keyboard.remove_global_keybinding (key) Remove a keybinding from the global set.
awful.keyboard.append_client_keybinding (key) Add an awful.key to the default client keys.
awful.keyboard.append_client_keybindings (keys) Add a awful.keys to the default client keys.
awful.keyboard.remove_client_keybinding (key) Remove a key from the default client keys.


Functions

Methods
awful.keyboard.append_global_keybindings (keys)
Add multiple awful.key based keybindings to the global set.

A global keybinding is one which is always present, even when there is no focused client. If your intent is too add a keybinding which acts on the focused client do not use this

Parameters:

  • keys table A table of awful.key objects. Optionally, it can have a group entry. If set, the group property will be set on all awful.keys objects.

See also:

Static module functions

awful.keyboard.emulate_key_combination (modifiers, key)
Execute a key combination.

If an awesome keybinding is assigned to the combination, it should be executed.

To limit the chances of accidentally leaving a modifier key locked when calling this function from a keybinding, make sure is attached to the release event and not the press event.

Parameters:

  • modifiers table A modified table. Valid modifiers are: Any, Mod1, Mod2, Mod3, Mod4, Mod5, Shift, Lock and Control.
  • key string The key.

See also:

awful.keyboard.append_global_keybinding (key)
Add an awful.key based keybinding to the global set.

A global keybinding is one which is always present, even when there is no focused client. If your intent is too add a keybinding which acts on the focused client do not use this.

Parameters:

  • key awful.key The key object.

See also:

awful.keyboard.remove_global_keybinding (key)
Remove a keybinding from the global set.

Parameters:

  • key awful.key The key object.

See also:

awful.keyboard.append_client_keybinding (key) · 1 signals
Add an awful.key to the default client keys.

Parameters:

  • key awful.key The key.

See also:


Click to display more

Emit signals:

  • client_keybinding::added
awful.keyboard.append_client_keybindings (keys) · 1 signals
Add a awful.keys to the default client keys.

Parameters:

See also:


Click to display more

Emit signals:

  • client_keybinding::added
awful.keyboard.remove_client_keybinding (key)
Remove a key from the default client keys.

Parameters:

  • key awful.key The key.

Returns:

    boolean True if the key was removed and false if it wasn’t found.

See also:

generated by LDoc 1.4.6 Last updated 2030-01-01 00:00:00