1
1
mirror of https://github.com/wez/wezterm.git synced 2024-12-25 14:22:37 +03:00
wezterm/docs/config/lua/keyassignment/ActivateWindowRelative.md
Benoit de Chezelles f37c3ae5da
Fix some documentation pages (#3321)
* Update ssh_backend.md

* Update normalize_output_to_unicode_nfc.md

* Update strikethrough_position.md

* Update underline_position.md

* Update underline_thickness.md

* Fix lua config docs titles to be formatted as inline code

* Mention how suggested alphabet for quick select is choosen

* Mention update-status and update-right-status for status_update_interval

* Fix docs for all keyassignments to be formatted as inline code

* Fix Lua object index titles

* Fix titles of `wezterm.*` module index pages

* Fix title of `Color` object & `wezterm.color` functions

We reduce titles from h2 to h1 because mkdocs defaults the page title to
the page file name if no h1 header is found.

* Unify title of all object methods

* Add index page for Gui events
2023-03-22 06:36:03 -07:00

799 B

ActivateWindowRelative(delta)

{{since('20230320-124340-559cb7b0')}}

Activates a GUI window relative to the current window.

ActivateWindowRelative(1) activates the next window, while ActivateWindowRelative(-1) activates the previous window.

This action will wrap around and activate the appropriate window at the start/end.

Here's an example of setting up (not very useful) hotkeys to cycle between windows:

local wezterm = require 'wezterm'
local act = wezterm.action
local config = {}

config.keys = {
  { key = 'r', mods = 'ALT', action = act.ActivateWindowRelative(1) },
  { key = 'e', mods = 'ALT', action = act.ActivateWindowRelative(-1) },
}
return config

See also ActivateWindowRelativeNoWrap, ActivateWindow.