From 3ee5aace33f1b5673ab372afba38480338ba8b90 Mon Sep 17 00:00:00 2001 From: Michael Weiser Date: Sun, 16 Feb 2020 00:40:18 +0100 Subject: commands: Add shortcuts_inhibitor command Add a command to influence keyboard shortcuts inhibitors. In its current form it can be used to activate, deactivate or toggle an existing inhibitor on the surface currently receiving input. This can be used to define an escape shortcut such as: bindsym --inhibited $mod+Escape seat - shortcuts_inhibitor deactivate It also allows the user to configure a per-seat default of whether keyboard inhibitors are honoured by default (the default) or not. Using the activate/toggle command they can then enable the lingering inhibitor at a later time of their choosing. As a side effect this allows to specifically address a named seat for actions as well, whatever use-case that might serve. Signed-off-by: Michael Weiser --- sway/sway-input.5.scd | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) (limited to 'sway/sway-input.5.scd') diff --git a/sway/sway-input.5.scd b/sway/sway-input.5.scd index 9edd9381..c0584241 100644 --- a/sway/sway-input.5.scd +++ b/sway/sway-input.5.scd @@ -243,6 +243,25 @@ correct seat. by default) for the seat. This is primarily useful for video games. The "escape" command can be used at runtime to escape from a captured client. +*seat* shortcuts_inhibitor enable|disable|activate|deactivate|toggle + Enables or disables the ability of clients to inhibit keyboard + shortcuts for the seat. This is primarily useful for virtualization and + remote desktop software. Subcommands _enable_ and _disable_ affect + whether future inhibitors are honoured by default, i.e. activated + automatically, the default being _enable_. When used at runtime, + _disable_ also disables any currently active inhibitors. _activate_, + _deactivate_ and _toggle_ are only useable at runtime and change the + state of a potentially existing inhibitor on the currently focused + window. This can be used with the current seat alias (_-_) to affect + only the currently focused window of the current seat. Subcommand + _deactivate_ is particularly useful in an _--inhibited_ *bindsym* to + escape a state where shortcuts are inhibited and the client becomes + uncooperative. It is worth noting that whether disabled or deactivated + inhibitors are removed is entirely up to the client. Depending on the + client it may therefore be possible to (re-)activate them later. Any + visual indication that an inhibitor is present is currently left to the + client as well. + *seat* xcursor_theme [] Override the system default XCursor theme. The default seat's (_seat0_) theme is also used as the default cursor theme in -- cgit v1.2.3-54-g00ecf