mirror of
https://github.com/labwc/labwc.git
synced 2025-10-29 05:40:24 -04:00
0430f6f818
This is a useful (if lesser-known) feature of at least a few popular X11 window managers, for example Openbox and XFWM4. Typically right-click on the maximize button toggles horizontal maximize, while middle-click toggles vertical maximize. Support in labwc uses the same configuration syntax as Openbox, where the Maximize/ToggleMaximize actions have an optional "direction" argument: horizontal, vertical, or both (default). The default mouse bindings match the XFWM4 defaults (not sure what Openbox has by default). Most of the external protocols still assume "maximized" is a Boolean, which is no longer true internally. For the sake of the outside world, a view is only "maximized" if maximized in both directions. Internally, I've taken the following approach: - SSD code decorates the view as "maximized" (i.e. hiding borders) only if maximized in both directions. - Layout code (interactive move/resize, tiling, etc.) generally treats the view as "maximized" (with the restrictions that entails) if maximized in either direction. For example, moving a vertically- maximized view first restores the natural geometry (this differs from Openbox, which instead allows the view to move only horizontally.) v2: use enum view_axis for view->maximized v3: - update docs - allow resizing if partly maximized - add TODOs & corrections noted by Consolatis
225 lines
7 KiB
Markdown
225 lines
7 KiB
Markdown
labwc-actions(5)
|
|
|
|
# NAME
|
|
|
|
labwc - actions
|
|
|
|
# ACTIONS
|
|
|
|
Actions are used in menus and keyboard/mouse bindings.
|
|
|
|
*<action name="Close" />*
|
|
Close top-most window.
|
|
|
|
*<action name="Kill" />*
|
|
Kill the process associated with the current window by sending it the
|
|
SIGTERM signal.
|
|
|
|
*<action name="Execute" command="value" />*
|
|
Execute command. Note that in the interest of backward compatibility,
|
|
labwc supports <execute> as an alternative to <command> even though
|
|
openbox documentation states that it is deprecated.
|
|
Note: Tilde (~) is expanded in the command before passing to execvp()
|
|
|
|
*<action name="Exit" />*
|
|
Exit labwc.
|
|
|
|
*<action name="Focus" />*
|
|
Give focus to window under cursor.
|
|
|
|
*<action name="Raise" />*
|
|
Restack the current window above other open windows.
|
|
|
|
*<action name="Lower" />*
|
|
Restack the current window below other open windows.
|
|
|
|
*<action name="Iconify" />*
|
|
Iconify (minimize) focused window.
|
|
|
|
*<action name="Move" />*
|
|
Begin interactive move of window under cursor
|
|
|
|
*<action name="MoveToEdge" direction="value" snapWindows="value" />*
|
|
Move window until it hits the next edge.
|
|
|
|
*direction* [left|up|right|down] Direction in which to move.
|
|
|
|
*snapWindows* [yes|no] Move window until it hits an edge of
|
|
another window or screen edge. If set to "no", only move to
|
|
the next screen edge. Default is yes.
|
|
|
|
*<action name="Resize" />*
|
|
Begin interactive resize of window under cursor
|
|
|
|
*<action name="ResizeRelative" left="" right="" top="" bottom="" />*
|
|
Resize window relative to its current size. Values of left, right,
|
|
top or bottom tell how much to resize on that edge of window,
|
|
positive values grow window, negative shrink window.
|
|
|
|
*<action name="GrowToEdge" direction="value" />*
|
|
Resize window to fill the space between its edge and any other
|
|
window edge.
|
|
|
|
*direction* [left|up|right|down] Direction in which to grow.
|
|
|
|
*<action name="ShrinkToEdge" direction="value" />*
|
|
Reverse of GrowToEdge. Shrinks by a maximum of 50%.
|
|
|
|
*direction* [left|up|right|down] Direction in which to shrink.
|
|
|
|
*<action name="MoveTo" x="" y="" />*
|
|
Move to position (x, y)
|
|
|
|
*<action name="MoveToCursor" />*
|
|
Move to be centered on cursor.
|
|
Tries to prevent any part of the window from going off-screen.
|
|
|
|
*<action name="MoveRelative" x="" y="" />*
|
|
Move window relative to its current position. Positive value of x moves
|
|
it right, negative left. Positive value of y moves it down, negative up.
|
|
|
|
*<action name="SnapToEdge" direction="value" />*
|
|
Resize window to fill half the output in the given direction. Supports
|
|
directions "left", "up", "right", "down" and "center".
|
|
|
|
*<action name="SnapToRegion" region="value" />*
|
|
Resize and move active window according to the given region.
|
|
See labwc-config(5) for further information on how to define regions.
|
|
|
|
*<action name="NextWindow" />*
|
|
Cycle focus to next window.
|
|
|
|
*<action name="PreviousWindow" />*
|
|
Cycle focus to previous window.
|
|
|
|
*<action name="Reconfigure" />*
|
|
Re-load configuration and theme files.
|
|
|
|
*<action name="ShowMenu" menu="value" />*
|
|
Show menu. Valid menu names are "root-menu" and "client-menu".
|
|
|
|
*<action name="ToggleDecorations" />*
|
|
Toggle decorations of focused window.
|
|
|
|
This is a 3-state action which can be executed multiple times:
|
|
- Only the titlebar will be hidden, borders and resize area are kept
|
|
- Remaining decorations will be disabled
|
|
- Decorations will be shown normally
|
|
|
|
By disabling the theme configuration 'keepBorder' the first step
|
|
will be removed and the action only toggles between on and off.
|
|
|
|
*<action name="ToggleFullscreen" />*
|
|
Toggle fullscreen state of focused window.
|
|
|
|
*<action name="ToggleMaximize" direction="value" />*
|
|
Toggle maximize state of focused window. Supported directions are
|
|
"both" (default), "horizontal", and "vertical".
|
|
|
|
*<action name="Maximize" direction="value" />*
|
|
Maximize focused window. Supported directions are "both" (default),
|
|
"horizontal", and "vertical".
|
|
|
|
*<action name="ToggleAlwaysOnTop" />*
|
|
Toggle always-on-top of focused window.
|
|
|
|
*<action name="ToggleAlwaysOnBottom" />*
|
|
Toggle between layers 'always-on-bottom' and 'normal'. When a window is
|
|
in the 'always-on-bottom' layer, it is rendered below all other
|
|
top-level windows. It is anticipated that this action will be useful
|
|
when defining window-rules for desktop-management tools that do not
|
|
support the wlr-layer-shell protocol.
|
|
|
|
*<action name="ToggleKeybinds" />*
|
|
Stop handling keybinds other than ToggleKeybinds itself.
|
|
This can be used to allow A-Tab and similar keybinds to be delivered
|
|
to Virtual Machines, VNC clients or nested compositors.
|
|
A second call will restore all original keybinds.
|
|
|
|
This action will only affect the window that had keyboard focus when
|
|
the binding was executed. Thus when switching to another window, all
|
|
the usual keybinds will function again until switching back to the
|
|
original window. There can be multiple windows with this mode set.
|
|
|
|
*<action name="FocusOutput" output="HDMI-A-1" />*
|
|
Give focus to topmost window on given output and warp the cursor
|
|
to the center of the window. If the given output does not contain
|
|
any windows, the cursor is centered on the given output.
|
|
|
|
*<action name="GoToDesktop" to="value" wrap="yes" />*
|
|
Switch to workspace.
|
|
|
|
*to* The workspace to switch to. Supported values are "current", "last",
|
|
"left", "right" or the full name of a workspace or its index (starting
|
|
at 1) as configured in rc.xml.
|
|
|
|
*wrap* [yes|no] Wrap around from last desktop to first, and vice
|
|
versa. Default yes.
|
|
|
|
*<action name="SendToDesktop" to="value" follow="yes" wrap="yes" />*
|
|
Send active window to workspace.
|
|
|
|
*to* The workspace to send the window to. Supported values are the same
|
|
as for GoToDesktop.
|
|
|
|
*follow* [yes|no] Also switch to the specified workspace. Default yes.
|
|
|
|
*wrap* [yes|no] Wrap around from last desktop to first, and vice
|
|
versa. Default yes.
|
|
|
|
*<action name="None" />*
|
|
If used as the only action for a binding: clear an earlier defined binding.
|
|
|
|
# CONDITIONAL ACTIONS
|
|
|
|
Actions that execute other actions. Used in keyboard/mouse bindings.
|
|
|
|
*<action name="If">*
|
|
This action will execute one set of actions if the focused window
|
|
matches the criteria, or another if it does not.
|
|
|
|
The arguments are as follows:
|
|
|
|
```
|
|
<action name="If">
|
|
<query/>
|
|
<then><action/></then>
|
|
<else><action/></else>
|
|
</action>
|
|
```
|
|
|
|
*query*
|
|
Define a query with zero or more conditions. All conditions must
|
|
be evaluated as true in order for the window to match this
|
|
query. Multiple queries can be defined.
|
|
|
|
Pattern matching is done according to glob(7) and is
|
|
case-insensitive.
|
|
|
|
Conditions are as follows:
|
|
|
|
*identifier*
|
|
XDG shell app_id for Wayland clients, WM_CLASS for
|
|
XWayland clients.
|
|
|
|
*title*
|
|
XDG shell title for Wayland clients, WM_NAME for
|
|
XWayland clients.
|
|
|
|
This argument is optional.
|
|
|
|
*then*
|
|
A list of actions to be executed if the window matches any
|
|
query. This argument is optional.
|
|
|
|
*else*
|
|
A list of actions to be executed if the window does not match
|
|
any query. This argument is optional.
|
|
|
|
*<action name="ForEach">*
|
|
Identical to "If" action, but applies to all windows, not just the
|
|
focused one.
|
|
|
|
# SEE ALSO
|
|
|
|
labwc(1), labwc-config(5), labwc-theme(5), glob(7)
|