5. Windows

Command: next

Go to the next window in the window list.

Command: prev

Go to the previous window in the window list.

Command: delete-window &optional (window (current-window))

Delete a window. By default delete the current window. This is a request sent to the window. The window’s client may decide not to grant the request or may not be able to if it is unresponsive.

Command: kill-window &optional (window (current-window))

Tell X to disconnect the client that owns the specified window. Default to the current window. if delete-window didn’t work, try this.

Command: echo-windows &optional (fmt *window-format*) (group (current-group)) (windows (group-windows group))

Display a list of managed windows. The optional argument fmt can be used to override the default window formatting.

Command: other-window &optional (group (current-group))

Switch to the window last focused.

Command: pull-hidden-next

Pull the next hidden window into the current frame.

Command: pull-hidden-previous

Pull the next hidden window into the current frame.

Command: pull-hidden-other

Pull the last focused, hidden window into the current frame.

Command: pull-from-windowlist

Pulls a window selected from the list of windows. This allows a behavior similar to Emacs’ switch-to-buffer when selecting another window.

Command: renumber nt &optional (group (current-group))

Change the current window’s number to the specified number. If another window is using the number, then the windows swap numbers. Defaults to current group.

Command: meta key

Send a fake key to the current window. key is a typical StumpWM key, like C-M-o.

Command: select-window query

Switch to the first window that starts with query.

Command: select-window-by-number num &optional (group (current-group))

Find the window with the given number and focus it in its frame.

Command: select-window-by-name name

Switch to the first window whose name is exactly name.

Command: repack-window-numbers &optional preserved

Ensure that used window numbers do not have gaps; ignore PRESERVED window numbers.

Command: title title

Override the current window’s title.

Command: windowlist &optional (fmt *window-format*) window-list

Allow the user to select a window from the list of windows and focus the selected window. For information of menu bindings see Menus. The optional argument fmt can be specified to override the default window formatting. The optional argument window-list can be provided to show a custom window list (see windowlist-by-class). The default window list is the list of all window in the current group. Also note that the default window list is sorted by number and if the windows-list is provided, it is shown unsorted (as-is).

Command: windowlist-by-class &optional (fmt *window-format-by-class*)

Allow the user to select a window from the list of windows (sorted by class) and focus the selected window. For information of menu bindings see Menus. The optional argument fmt can be specified to override the default window formatting. This is a simple wrapper around the command windowlist.

Command: fullscreen

Toggle the fullscreen mode of the current widnow. Use this for clients with broken (non-NETWM) fullscreen implementations, such as any program using SDL.

Command: info &optional (fmt *window-info-format*)

Display information about the current window.

Command: refresh

Refresh current window without changing its size.

Command: redisplay

Refresh current window by a pair of resizes, also make it occupy entire frame.

Command: float-this

Transforms a tile-window into a float-window

Command: unfloat-this

Transforms a float-window into a tile-window

Command: unmaximize

Use the size the program requested for current window (if any) instead of maximizing it.

Command: toggle-always-on-top

Toggle whether the current window always appears over other windows. The order windows are added to this list determines priority.

Command: toggle-always-show

Toggle whether the current window is shown in all groups.

Variable: *window-format*

This variable decides how the window list is formatted. It is a string with the following formatting options:

%n

Substitutes the window’s number translated via *window-number-map*, if there are more windows than *window-number-map* then will use the window-number.

%s

Substitute the window’s status. * means current window, + means last window, and - means any other window.

%t

Substitute the window’s name.

%c

Substitute the window’s class.

%i

Substitute the window’s resource ID.

%m

Draw a # if the window is marked.

Note, a prefix number can be used to crop the argument to a specified size. For instance, ‘%20t’ crops the window’s title to 20 characters.

Variable: *window-info-format*

The format used in the info command. See *window-format* for formatting details.

Variable: *window-name-source*

This variable controls what is used for the window’s name. The default is :title.

:title

Use the window’s title given to it by its owner.

:class

Use the window’s resource class.

:resource-name

Use the window’s resource name.

Variable: *new-window-prefered-frame*

nil

This document was generated on January 28, 2024 using texi2html 1.82.