dwww Home | Show directory contents | Find package

<FILENAME filename="index.html"><html><head><title>Window Behavior</title><link rel="stylesheet" type="text/css" href="help:/kdoctools5-common/kde-default.css"><link rel="stylesheet" type="text/css" href="help:/kdoctools5-common/kde-docs.css"><link rel="stylesheet" type="text/css" href="help:/kdoctools5-common/kde-localised.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><meta name="keywords" content="KDE, KControl, system settings, actions, window, window placement, window size, window management, window behavior, focus, raise, titlebar, screen, snap"><link rel="home" href="index.html" title="Window Behavior"><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta name="GENERATOR" content="KDE XSL Stylesheet V1.14 using libxslt"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div id="content"><div id="header"><div id="header_content"><div id="header_left"><div id="header_right"><img src="help:/kdoctools5-common/top-kde.jpg" width="36" height="34"> Window Behavior</div></div></div></div><div class="navCenter"><table class="navigation"><tr><td class="prevCell"></td><td class="upCell"> </td><td class="nextCell"></td></tr></table></div><div id="contentBody"><div lang="en" class="article"><div class="titlepage"><div><div><h2 class="title"><a name="windowbehaviour"></a>Window Behavior</h2></div><div><div class="authorgroup"><p class="author"><span class="firstname">Mike</span> <span class="surname">McBride</span> <code class="email">&lt;no mail&gt;</code></p><p class="author"><span class="firstname">Jost</span> <span class="surname">Schenck</span> <code class="email">&lt;jost@schenck.de&gt;</code></p><p class="author"><span class="firstname">Natalie</span> <span class="surname">Clarius</span> <code class="email">&lt;natalie_clarius@yahoo.de&gt;</code></p></div></div><div>Revision <span class="releaseinfo">Plasma 5.26 (<span class="date">2022-08-31</span>)</span></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="index.html#window-behavior">Window Behavior</a></span></dt><dd><dl><dt><span class="sect2"><a href="index.html#focus">Focus</a></span></dt><dt><span class="sect2"><a href="index.html#titlebar-actions">Titlebar Actions</a></span></dt><dt><span class="sect2"><a href="index.html#window-actions">Window Actions</a></span></dt><dt><span class="sect2"><a href="index.html#movement">Movement</a></span></dt><dt><span class="sect2"><a href="index.html#advanced">Advanced</a></span></dt></dl></dd></dl></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="window-behavior"></a>Window Behavior</h2></div></div></div><p> In the upper part of this control module you can see several
tabs: <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Focus</span></span>, <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Titlebar Actions</span></span>,
<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Window Actions</span></span>, <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Movement</span></span> and
<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Advanced</span></span>. In the
<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Focus</span></span> panel you can configure how windows gain or
lose focus, <abbr class="abbrev">i.e.</abbr> become active or inactive. Using
<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Titlebar Actions</span></span> and <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Window Actions</span></span>
you can configure how titlebars and windows react to
mouse clicks. <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Movement</span></span> allows you to configure how
windows move and place themselves when started. The
<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Advanced</span></span> options cover some specialized options
like <span class="quote">“<span class="quote">window shading</span>”</span>.
</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
Please note that the configuration in this module will not take effect
if you do not use <span class="productname">Plasma</span>'s native window manager, <span class="application">KWin</span>. If you do use a
different window manager, please refer to its documentation for how to
customize window behavior.
</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="focus"></a>Focus</h3></div></div></div><p>
The <span class="quote">“<span class="quote">focus</span>”</span> of the workspace refers to the window which the
user is currently working on. The window with focus is often referred to
as the <span class="quote">“<span class="quote">active window</span>”</span>.
</p><p>
Focus does not necessarily mean the window is the one at the
front — this is referred to as <span class="quote">“<span class="quote">raised</span>”</span>, and
although this is configured here as well, focus and raising of windows
are configured independently.
</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="focus-focuspolicy"></a>Windows activation policy</h4></div></div></div><p>
There are six methods <span class="application">KWin</span> can use to determine the current focus:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Click to focus</span></span></span></dt><dd><p>
A window becomes active when you click into it.
This behaviour is common on other operating systems and likely what you want.</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Click to focus (mouse precedence)</span></span></span></dt><dd><p>
This is mostly the same as <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Click to focus</span></span>.
If an active window has to be chosen by the system
(<abbr class="abbrev">e.g.</abbr> because the currently active one was closed) 
the window under the mouse is the preferred candidate.
Unusual, but possible variant of <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Click to focus</span></span>.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Focus follows mouse</span></span></span></dt><dd><p>
Moving the mouse pointer actively over a normal window activates it. New
windows such as the mini command line invoked with
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>F2</strong></span> will receive the focus,
without you having to point the mouse at them explicitly.
<abbr class="abbrev">e.g.</abbr> windows randomly appearing under the mouse will not gain the focus.
Focus stealing prevention takes place as usual.
Think as <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Click to focus</span></span> just without having to actually click.
</p><p>
In other window managers, this is sometimes known as <span class="quote">“<span class="quote">Sloppy focus
follows mouse</span>”</span>.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Focus follows mouse (mouse precedence)</span></span></span></dt><dd><p>
This is mostly the same as <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Focus follows mouse</span></span>.
If an active window has to be chosen by the system
(<abbr class="abbrev">e.g.</abbr> because the currently active one was closed) 
the window under the mouse is the preferred candidate.
Choose this, if you want a hover controlled focus.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Focus under mouse</span></span></span></dt><dd><p>
The window that happens to be under the mouse pointer becomes active. If
the mouse is not over a window (for instance, it's over the desktop wallpaper) the last
window that was under the mouse has focus. New windows such as the mini
command line invoked with <span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>F2</strong></span> will
not receive the focus, you must move the mouse over them to type.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Focus strictly under mouse</span></span></span></dt><dd><p>
Similar to <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Focus under mouse</span></span>, but even more
strict with its interpretation. Only the window under the mouse pointer is
active. If the mouse pointer is not over a window, no window has focus.
New windows such as the mini command line invoked with
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>F2</strong></span> will not receive the focus,
you must move the mouse over them to type. 
</p></dd></dl></div><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
Note that <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Focus under mouse</span></span> and
<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Focus strictly under mouse</span></span> prevent certain
features, such as <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Focus stealing prevention</span></span> and the 
<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>Tab</strong></span>
walk-through-windows dialog, from working properly.
</p></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="focus-focusdelay"></a>Delay focus by</h4></div></div></div><p>
This is the delay after which the window the mouse pointer is over will automatically receive focus.
</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="focus-focusstealing"></a>Focus stealing prevention</h4></div></div></div><p>
This option specifies how much KWin will try to prevent unwanted focus 
stealing caused by unexpected activation of new windows.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">None</span></span></span></dt><dd><p>Prevention is turned off and new windows always become activated.</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Low</span></span></span></dt><dd><p>Prevention is enabled; when some window does not have support 
for the underlying mechanism and KWin cannot reliably decide whether to activate 
the window or not, it will be activated. This setting may have both worse and better 
results than the medium level, depending on the applications.</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Medium</span></span></span></dt><dd><p>Prevention is enabled.</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">High</span></span></span></dt><dd><p>New windows get activated only 
if no window is currently active or if they belong to the currently active 
application. This setting is probably not really usable when not using mouse 
focus policy.</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Extreme</span></span></span></dt><dd><p>All windows must be explicitly activated by the user.</p></dd></dl></div><p>
Windows that are prevented from stealing focus are marked as demanding 
attention, which by default means their taskbar entry will be highlighted. 
This can be changed in the Notifications control module.
</p></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="focus-raisingwindow"></a>Raising windows</h4></div></div></div><p>
Besides receiving focus, you can also control under which conditions windows get raised, <abbr class="abbrev">i.e.</abbr> brought to the front.
</p><p>
You should make sure that at least one of the raising options is enabled, otherwise windows will not be raised at all.
</p><p>
<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Click raises active window</span></span> will bring a window to the front when it is clicked on. This is enabled by default with a click to focus policy.
</p><p>
By activating <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Raise on hover, delayed by</span></span> you can alternatively bring a window to the front if the mouse pointer is over that window for a specified period of time. You can determine the delay for this option by using the spin box control. This auto-raising option is only available with a hover to focus policy.
</p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>
Setting the delay too short will cause a rapid fire changing of
windows, which can be quite distracting. Most people will like a delay
of 100-300 ms. This is responsive, but it will let you slide over the
corners of a window on your way to your destination without bringing
that window to the front. 
</p></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="focus-multiscreen"></a>Multiscreen behavior</h4></div></div></div><p>
This controls the behavior of window focus with multiple screens. Note that these options appear only when more than one screen is currently connected.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Active screen follows mouse</span></span></span></dt><dd><p>
When this option is enabled, the active screen (where new windows appear, for example) is the screen containing the mouse pointer. When disabled, the active screen is the screen containing the focused window.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Separate screen focus</span></span></span></dt><dd><p>
When this option is enabled, focus operations are limited only to the active screen. For instance, when you close a window, then the next window to receive focus will be a window on the active screen, even if there is a more recently used window on a different screen.
</p></dd></dl></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="titlebar-actions"></a>Titlebar Actions</h3></div></div></div><p>
In this panel you can configure what happens to windows when a mousebutton is
clicked on their titlebars.
</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="actions-titlebar"></a><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Titlebar Actions</span></span></h4></div></div></div><p>
This section allows you to determine what happens when you double-click
or scroll the mouse wheel on the titlebar of a window.
</p><p>
The following actions are available for <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Double-click</span></span>:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Maximize</span></span></span></dt><dd><p>
Resizes the window to fill the height and width of the screen.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Vertically maximize</span></span></span></dt><dd><p>
Resizes the window to the height of the screen.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Horizontally maximize</span></span></span></dt><dd><p>
Resizes the window to the width of the screen.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Minimize</span></span></span></dt><dd><p>
Hides the window into its minimized state, from which it can be restored <abbr class="abbrev">e.g.</abbr> via the Task Manager or Task Switcher.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Shade</span></span></span></dt><dd><p>
Causes the window to be
reduced to simply the titlebar. Double-clicking on the titlebar again
restores the window to its normal size.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Close</span></span></span></dt><dd><p>
Closes the window.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Show on all desktops</span></span></span></dt><dd><p>
Makes the window be visible on all Virtual Desktops.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Do nothing</span></span></span></dt><dd><p>
Nothing happens on double-click.
</p></dd></dl></div><p>
The <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Mouse wheel</span></span> can be used to trigger an action depending on whether it is scrolled up or down:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Raise/lower</span></span></span></dt><dd><p>
Scrolling up will move the window on top of other windows.
</p><p>
Scrolling down will move the window below other windows.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Shade/unshade</span></span></span></dt><dd><p>
Scrolling up will collapse the window to just its titlebar.
</p><p>
Scrolling down will restore the window to its normal size.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Maximize/restore</span></span></span></dt><dd><p>
Scrolling up will maximize the window to fill the whole screen.
</p><p>
Scrolling down will restore it to its previous size.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Keep above/below</span></span></span></dt><dd><p>
Scrolling up will make the window stay on top, covering other windows.
</p><p>
Scrolling down will make the window stay covered below other windows.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Move to previous/next desktop</span></span></span></dt><dd><p>
Scrolling up will move the window to the previous Virtual Desktop.
</p><p>
Scrolling down will move the window to the next Virtual Desktop.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Change opacity</span></span></span></dt><dd><p>
Scrolling up will make the window less transparent.
</p><p>
Scrolling down will make the window more transparent.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Do nothing</span></span></span></dt><dd><p>
Nothing happens when scrolling up or down on the window's titlebar.
</p></dd></dl></div><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>
You can have windows automatically unshade when you simply place the
mouse over their shaded titlebar. Just check the <a class="link" href="index.html#advanced-unshading" title="Window unshading"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Window
unshading</span></span></a> check box in the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Advanced</span></span> tab of
this module. This is a great way to reclaim screen space when you are
cutting and pasting between a lot of windows, for example.
</p></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="actions-titlebar-frame"></a><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Titlebar and Frame Actions</span></span></h4></div></div></div><p>
This section allows you to determine what happens when you single click
on the titlebar or frame of a window. Notice that you can have
different actions associated with the same click depending on whether
the window is active or not.
</p><p> For each combination of mousebuttons, Active and
Inactive, you can select the most appropriate choice. The actions are
as follows:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Raise</span></span></span></dt><dd><p>
Will bring the window to the top of the window stack. All other windows
which overlap with this one will be hidden <span class="quote">“<span class="quote">below</span>”</span> it.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Lower</span></span></span></dt><dd><p>
Will move this window to the bottom of the window stack. This will get the
window out of the way.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Toggle raise and lower</span></span></span></dt><dd><p>
This will raise windows which are not on top, and lower windows which
are already on top.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Minimize</span></span></span></dt><dd><p>
Hides the window into its minimized state, from which it can be restored <abbr class="abbrev">e.g.</abbr> via the Task Manager or Task Switcher.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Shade</span></span></span></dt><dd><p>
Causes the window to be
reduced to simply the titlebar. Double-clicking on the titlebar again
restores the window to its normal size.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Close</span></span></span></dt><dd><p>
Closes the window.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Show actions menu</span></span></span></dt><dd><p>
Will bring up a small submenu where you can choose window related
commands (<abbr class="abbrev">i.e.</abbr> Move to Desktop, Move to Screen, Maximize, Minimize, Close, <abbr class="abbrev">etc.</abbr>).
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Do nothing</span></span></span></dt><dd><p>
Nothing happens on click.
</p></dd></dl></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="actions-maximize-button"></a><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Maximize Button Actions</span></span></h4></div></div></div><p>
This section allows you to determine the behavior of the three mouse buttons 
onto the maximize button.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Maximize</span></span></span></dt><dd><p>
Resizes the window to the height and width of the screen.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Vertically maximize</span></span></span></dt><dd><p>
Resizes the window to the height of the screen.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Horizontally maximize</span></span></span></dt><dd><p>
Resizes the window to the width of the screen.
</p></dd></dl></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="window-actions"></a>Window Actions</h3></div></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="actions-inactive-inner-window"></a><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Inactive Inner Window</span></span></h4></div></div></div><p>
This part of the module, allows you to configure what happens when you
click on an inactive window, with any of the three mouse buttons or use
the mouse wheel.
</p><p>
Your choices are as follows:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Activate, raise and pass click</span></span></span></dt><dd><p>
This makes the clicked window active, raises it to the top of the
display, and passes a mouse click to the application within the window.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Activate and pass click</span></span></span></dt><dd><p>
This makes the clicked window active and passes a mouse click to the
application within the window.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Activate</span></span></span></dt><dd><p>
This simply makes the clicked window active. The mouse click is not
passed on to the application within the window.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Activate and raise</span></span></span></dt><dd><p>
This makes the clicked window active and raises the window to the top of
the display. The mouse click is not passed on to the application within
the window.
</p></dd></dl></div><p>
Your choices for <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Mouse wheel</span></span> are as follows:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Scroll</span></span></span></dt><dd><p>
Just scrolls the content within the window.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Activate and scroll</span></span></span></dt><dd><p>
This makes the clicked window active and scrolls the content.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Activate, raise and scroll</span></span></span></dt><dd><p>
This makes the clicked window active, raises the window to the top of
the display, and scrolls the content.
</p></dd></dl></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="actions-inner-window-titlebar-frame"></a><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Inner Window, Titlebar and Frame</span></span></h4></div></div></div><p>
This bottom section allows you to configure additional actions when
clicking on a window with a modifier key pressed.
</p><p>
As a <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Modifier key</span></span>, you can select between <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Meta</span></span> (default) or <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Alt</span></span>.
</p><p>
Once again, you can select different actions for
<span class="mousebutton">Left</span>, <span class="mousebutton">Middle</span> and
<span class="mousebutton">Right</span> button clicks and the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Mouse 
wheel</span></span>.
</p><p>
Your choices for the mouse buttons are:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Move</span></span></span></dt><dd><p>
Allows you to drag the selected window around the workspace.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Activate, raise and move</span></span></span></dt><dd><p>
This makes the clicked window active, raises it to the top of the
window stack, and drags the window around the workspace.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Toggle raise and lower</span></span></span></dt><dd><p>
This will raise windows which are not on top, and lower windows which
are already on top.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Resize</span></span></span></dt><dd><p>
Allows you to change the size of the selected window.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Raise</span></span></span></dt><dd><p>
Will bring the window to the top of the window stack. All other windows
which overlap with this one will be hidden <span class="quote">“<span class="quote">below</span>”</span> it.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Lower</span></span></span></dt><dd><p>
 Will move this window to the bottom of the window stack. This will get the
window out of the way.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Minimize</span></span></span></dt><dd><p>
Hides the window into its minimized state, from which it can be restored <abbr class="abbrev">e.g.</abbr> via the Task Manager or Task Switcher.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Decrease opacity</span></span></span></dt><dd><p>
Makes the window more transparent.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Increase opacity</span></span></span></dt><dd><p>
Makes the window less transparent.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Do nothing</span></span></span></dt><dd><p>
Nothing happens on click.
</p></dd></dl></div><p>
Your choices for the mouse wheel are:
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Raise/lower</span></span></span></dt><dd><p>
Scrolling up will move the window on top of other windows.
</p><p>
Scrolling down will move the window below other windows.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Shade/unshade</span></span></span></dt><dd><p>
Scrolling up will collapse the window to just its titlebar.
</p><p>
Scrolling down will restore the window to its normal size.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Maximize/restore</span></span></span></dt><dd><p>
Scrolling up will maximize the window to fill the whole screen.
</p><p>
Scrolling down will restore it to its previous size.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Keep above/below</span></span></span></dt><dd><p>
Scrolling up will make the window stay on top, covering other windows.
</p><p>
Scrolling down will make the window stay covered below other windows.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Move to previous/next desktop</span></span></span></dt><dd><p>
Scrolling up will move the window to the previous Virtual Desktop.
</p><p>
Scrolling down will move the window to the next Virtual Desktop.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Change opacity</span></span></span></dt><dd><p>
Scrolling up will make the window less transparent.
</p><p>
Scrolling down will make the window more transparent.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Do nothing</span></span></span></dt><dd><p>
Nothing happens on when scrolling up or down the window's titlebar.
</p></dd></dl></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="movement"></a>Movement</h3></div></div></div><p>This page allows you to configure the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Snap
Zones</span></span>. These are like a magnetic field along the side of
the screen and each window, which will make windows snap alongside
when moved near.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Screen edge snap zone</span></span></span></dt><dd><p>Here you can set the snap zone for screen borders. Moving a
window within the configured distance will make it snap to the edge of
the screen.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Window snap zone</span></span></span></dt><dd><p>
Here you can set the snap zone for windows. As with screen
borders, moving a window near to another will make it snap to the edge
as if the windows were magnetized.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Center snap zone</span></span></span></dt><dd><p>
Here you can set the snap zone for the screen center, <abbr class="abbrev">i.e.</abbr> the 
<span class="quote">“<span class="quote">strength</span>”</span> of the magnetic field which will make windows snap 
to the center of the screen when moved near it.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Snap windows: Only when overlapping</span></span></span></dt><dd><p>
If checked, windows will not snap together if they are only near
each other, they must be overlapping, by the configured amount or
less.
</p></dd></dl></div><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>
In the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Screen Edges</span></span> settings module in the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Workspace Behavior</span></span> section of the system settings, you can configure windows to be quick-tiled to the whole, half, or quarter of the screen when dragged near the screen edges.
</p></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="advanced"></a>Advanced</h3></div></div></div><p>
In the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Advanced</span></span> panel you can do more advanced fine
tuning to the window behavior.
</p><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="advanced-unshading"></a>Window unshading</h4></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">On titlebar hover after</span></span></span></dt><dd><p>
If this option is enabled, a shaded window will un-shade automatically
when the mouse pointer has been over the titlebar for some time. Use
the spinbox to configure the delay un-shading.
</p></dd></dl></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="advanced-placement"></a>Window placement</h4></div></div></div><p>
The placement policy determines where a new window will appear
on the screen.
</p><p>
In a multi-monitor setup, the screen for windows to appear on is always the active screen (that is, the screen that has the mouse pointer or the focused window; see <a class="link" href="index.html#focus-multiscreen" title="Multiscreen behavior">Multiscreen behavior</a>), with the exception of windows remembering their previous position (see <a class="link" href="index.html#advanced-remember-positions">below</a>).
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Minimal Overlapping</span></span></span></dt><dd><p>
Will place all new windows in such a manner as to overlap existing windows as little as possible.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Maximized</span></span></span></dt><dd><p>
Will try to maximize all new windows to fill the whole screen.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Random</span></span></span></dt><dd><p>
Will place all new windows in random locations.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Centered</span></span></span></dt><dd><p>
Will place all new windows in the center of the screen.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">In Top-Left Corner</span></span></span></dt><dd><p>
Will place all new windows with their top left corner in the top left corner of
the screen. 
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Under Mouse</span></span></span></dt><dd><p>
Will place all new windows centered under the mouse pointer.
</p></dd></dl></div><p><a name="advanced-remember-positions"></a>
Check the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Allow apps to remember the positions of
their own windows</span></span> item to open windows where they previously were rather than by the placement method chosen above. Note that this remembered position includes the screen assignment, so windows may open on a screen other than the active one if this is where they were last located. Note also that this option is only available on X11, not on Wayland, and is only supported by some KDE applications.
</p><div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Tip</h3><p>
If you would like some windows to appear on specific positions, screens, or Virtual Desktops, you can set up <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Window Rules</span></span> to configure special window or application settings. You can find this by right-clicking on the titlebar of a window and choosing <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guimenu">More Actions</span></span>, or in the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Window Rules</span></span> module in the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Window Management</span></span> section of system settings.
</p></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="advanced-special-windows"></a>Special windows</h4></div></div></div><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Hide utility windows for inactive applications</span></span></span></dt><dd><p>
When turned on, utility windows (tool windows, torn-off menus, ...) of 
inactive applications will be hidden and will be shown only when the 
application becomes active. Note that applications have to mark the windows 
with the proper window type for this feature to work.
</p></dd></dl></div></div><div class="sect3"><div class="titlepage"><div><div><h4 class="title"><a name="advanced-virtual-desktop-behavior"></a>Virtual Desktop behavior</h4></div></div></div><p>
Sometimes calling an application will activate an existing window rather than opening a new window. This setting controls what should happen if that activated window is located on a Virtual Desktop other than the current one.
</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Switch to that Virtual Desktop</span></span></span></dt><dd><p>
Will switch to the Virtual Desktop where the window is currently located.
</p><p>
Choose this option if you would like the active Virtual Desktop to automatically follow windows to their assigned Virtual Desktop.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Bring window to current Virtual Desktop</span></span></span></dt><dd><p>
Will cause the window to jump to the active Virtual Desktop.
</p><p>
Choose this option if you would like windows to always open on the current Virtual Desktop, and the active Virtual Desktop to only switch when navigating there manually.
</p></dd></dl></div></div></div></div></div></div><div id="footer"><div class="navCenter"><table class="navigation"><tr><td class="prevCell"></td><td class="upCell"> </td><td class="nextCell"></td></tr><tr><td class="prevCell"> </td><td class="upCell"> </td><td class="nextCell"> </td></tr></table></div><div id="footer_text">Would you like to make a comment or contribute an update to this page?<br>Send feedback to the <a href="mailto:kde-doc-english@kde.org" class="footer_email">KDE Docs Team</a></div></div></div></body></html></FILENAME>

Generated by dwww version 1.15 on Thu Jun 27 10:07:06 CEST 2024.