Warning, /plasma/kwin/doc/windowbehaviour/index.docbook is written in an unsupported language. File is not indexed.
0001 <?xml version="1.0" ?> 0002 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" 0003 "dtd/kdedbx45.dtd" [ 0004 <!ENTITY % addindex "IGNORE"> 0005 <!ENTITY % English "INCLUDE" > <!-- change language only here --> 0006 ]> 0007 0008 <!--copy from r308626 Tue May 4 17:11:51 2004 UTC --> 0009 0010 <article id="windowbehaviour" lang="&language;"> 0011 <articleinfo> 0012 <title>Window Behavior</title> 0013 <authorgroup> 0014 <author>&Mike.McBride; &Mike.McBride.mail;</author> 0015 <author>&Jost.Schenck; &Jost.Schenck.mail;</author> 0016 <author><firstname>Natalie</firstname><surname>Clarius</surname><email>natalie_clarius@yahoo.de</email></author> 0017 <!-- TRANS:ROLES_OF_TRANSLATORS --> 0018 </authorgroup> 0019 0020 <date>2022-08-31</date> 0021 <releaseinfo>Plasma 5.26</releaseinfo> 0022 0023 <keywordset> 0024 <keyword>KDE</keyword> 0025 <keyword>KControl</keyword> 0026 <keyword>system settings</keyword> 0027 <keyword>actions</keyword> 0028 <keyword>window</keyword> 0029 <keyword>window placement</keyword> 0030 <keyword>window size</keyword> 0031 <keyword>window management</keyword> 0032 <keyword>window behavior</keyword> 0033 <keyword>focus</keyword> 0034 <keyword>raise</keyword> 0035 <keyword>titlebar</keyword> 0036 <keyword>screen</keyword> 0037 <keyword>snap</keyword> 0038 </keywordset> 0039 </articleinfo> 0040 0041 <sect1 id="window-behavior"> 0042 <title>Window Behavior</title> 0043 0044 <para> In the upper part of this control module you can see several 0045 tabs: <guilabel>Focus</guilabel>, <guilabel>Titlebar Actions</guilabel>, 0046 <guilabel>Window Actions</guilabel>, <guilabel>Movement</guilabel> and 0047 <guilabel>Advanced</guilabel>. In the 0048 <guilabel>Focus</guilabel> panel you can configure how windows gain or 0049 lose focus, &ie; become active or inactive. Using 0050 <guilabel>Titlebar Actions</guilabel> and <guilabel>Window Actions</guilabel> 0051 you can configure how titlebars and windows react to 0052 mouse clicks. <guilabel>Movement</guilabel> allows you to configure how 0053 windows move and place themselves when started. The 0054 <guilabel>Advanced</guilabel> options cover some specialized options 0055 like <quote>window shading</quote>. 0056 </para> 0057 0058 <note> 0059 <para> 0060 Please note that the configuration in this module will not take effect 0061 if you do not use &plasma;'s native window manager, &kwin;. If you do use a 0062 different window manager, please refer to its documentation for how to 0063 customize window behavior. 0064 </para> 0065 </note> 0066 0067 <sect2 id="focus"> 0068 <title>Focus</title> 0069 0070 <para> 0071 The <quote>focus</quote> of the workspace refers to the window which the 0072 user is currently working on. The window with focus is often referred to 0073 as the <quote>active window</quote>. 0074 </para> 0075 0076 <para> 0077 Focus does not necessarily mean the window is the one at the 0078 front — this is referred to as <quote>raised</quote>, and 0079 although this is configured here as well, focus and raising of windows 0080 are configured independently. 0081 </para> 0082 0083 <sect3 id="focus-focuspolicy"> 0084 <title>Windows activation policy</title> 0085 0086 <para> 0087 There are six methods &kwin; can use to determine the current focus: 0088 </para> 0089 0090 <variablelist> 0091 0092 <varlistentry> 0093 <term><guilabel>Click to focus</guilabel></term> 0094 <listitem> 0095 <para> 0096 A window becomes active when you click into it. 0097 This behaviour is common on other operating systems and likely what you want.</para> 0098 </listitem> 0099 </varlistentry> 0100 0101 <varlistentry> 0102 <term><guilabel>Click to focus (mouse precedence)</guilabel></term> 0103 <listitem> 0104 <para> 0105 This is mostly the same as <guilabel>Click to focus</guilabel>. 0106 If an active window has to be chosen by the system 0107 (⪚ because the currently active one was closed) 0108 the window under the mouse is the preferred candidate. 0109 Unusual, but possible variant of <guilabel>Click to focus</guilabel>. 0110 </para> 0111 </listitem> 0112 </varlistentry> 0113 0114 <varlistentry> 0115 <term><guilabel>Focus follows mouse</guilabel></term> 0116 <listitem> 0117 <para> 0118 Moving the mouse pointer actively over a normal window activates it. New 0119 windows such as the mini command line invoked with 0120 <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will receive the focus, 0121 without you having to point the mouse at them explicitly. 0122 ⪚ windows randomly appearing under the mouse will not gain the focus. 0123 Focus stealing prevention takes place as usual. 0124 Think as <guilabel>Click to focus</guilabel> just without having to actually click. 0125 </para> 0126 <para> 0127 In other window managers, this is sometimes known as <quote>Sloppy focus 0128 follows mouse</quote>. 0129 </para> 0130 </listitem> 0131 </varlistentry> 0132 0133 <varlistentry> 0134 <term><guilabel>Focus follows mouse (mouse precedence)</guilabel></term> 0135 <listitem> 0136 <para> 0137 This is mostly the same as <guilabel>Focus follows mouse</guilabel>. 0138 If an active window has to be chosen by the system 0139 (⪚ because the currently active one was closed) 0140 the window under the mouse is the preferred candidate. 0141 Choose this, if you want a hover controlled focus. 0142 </para> 0143 </listitem> 0144 </varlistentry> 0145 0146 <varlistentry> 0147 <term><guilabel>Focus under mouse</guilabel></term> 0148 <listitem> 0149 <para> 0150 The window that happens to be under the mouse pointer becomes active. If 0151 the mouse is not over a window (for instance, it's over the desktop wallpaper) the last 0152 window that was under the mouse has focus. New windows such as the mini 0153 command line invoked with <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will 0154 not receive the focus, you must move the mouse over them to type. 0155 </para> 0156 </listitem> 0157 </varlistentry> 0158 0159 <varlistentry> 0160 <term><guilabel>Focus strictly under mouse</guilabel></term> 0161 <listitem> 0162 <para> 0163 Similar to <guilabel>Focus under mouse</guilabel>, but even more 0164 strict with its interpretation. Only the window under the mouse pointer is 0165 active. If the mouse pointer is not over a window, no window has focus. 0166 New windows such as the mini command line invoked with 0167 <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will not receive the focus, 0168 you must move the mouse over them to type. 0169 </para> 0170 </listitem> 0171 </varlistentry> 0172 0173 </variablelist> 0174 0175 <note> 0176 <para> 0177 Note that <guilabel>Focus under mouse</guilabel> and 0178 <guilabel>Focus strictly under mouse</guilabel> prevent certain 0179 features, such as <guilabel>Focus stealing prevention</guilabel> and the 0180 <keycombo action="simul">&Alt;	</keycombo> 0181 walk-through-windows dialog, from working properly. 0182 </para> 0183 </note> 0184 0185 </sect3> 0186 0187 <sect3 id="focus-focusdelay"> 0188 <title>Delay focus by</title> 0189 0190 <para> 0191 This is the delay after which the window the mouse pointer is over will automatically receive focus. 0192 </para> 0193 0194 </sect3> 0195 0196 <sect3 id="focus-focusstealing"> 0197 <title>Focus stealing prevention</title> 0198 0199 <para> 0200 This option specifies how much KWin will try to prevent unwanted focus 0201 stealing caused by unexpected activation of new windows. 0202 </para> 0203 0204 <variablelist> 0205 0206 <varlistentry> 0207 <term><guilabel>None</guilabel></term> 0208 <listitem><para>Prevention is turned off and new windows always become activated.</para></listitem> 0209 </varlistentry> 0210 0211 <varlistentry> 0212 <term><guilabel>Low</guilabel></term> 0213 <listitem><para>Prevention is enabled; when some window does not have support 0214 for the underlying mechanism and KWin cannot reliably decide whether to activate 0215 the window or not, it will be activated. This setting may have both worse and better 0216 results than the medium level, depending on the applications.</para></listitem> 0217 </varlistentry> 0218 0219 <varlistentry> 0220 <term><guilabel>Medium</guilabel></term> 0221 <listitem><para>Prevention is enabled.</para></listitem> 0222 </varlistentry> 0223 0224 <varlistentry> 0225 <term><guilabel>High</guilabel></term> 0226 <listitem><para>New windows get activated only 0227 if no window is currently active or if they belong to the currently active 0228 application. This setting is probably not really usable when not using mouse 0229 focus policy.</para></listitem> 0230 </varlistentry> 0231 0232 <varlistentry> 0233 <term><guilabel>Extreme</guilabel></term> 0234 <listitem><para>All windows must be explicitly activated by the user.</para></listitem> 0235 </varlistentry> 0236 0237 </variablelist> 0238 0239 <para> 0240 Windows that are prevented from stealing focus are marked as demanding 0241 attention, which by default means their taskbar entry will be highlighted. 0242 This can be changed in the Notifications control module. 0243 </para> 0244 0245 </sect3> 0246 0247 <sect3 id="focus-raisingwindow"> 0248 <title>Raising windows</title> 0249 0250 <para> 0251 Besides receiving focus, you can also control under which conditions windows get raised, &ie; brought to the front. 0252 </para> 0253 0254 <para> 0255 You should make sure that at least one of the raising options is enabled, otherwise windows will not be raised at all. 0256 </para> 0257 0258 <para> 0259 <guilabel>Click raises active window</guilabel> will bring a window to the front when it is clicked on. This is enabled by default with a click to focus policy. 0260 </para> 0261 0262 <para> 0263 By activating <guilabel>Raise on hover, delayed by</guilabel> 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. 0264 </para> 0265 0266 <tip> 0267 <para> 0268 Setting the delay too short will cause a rapid fire changing of 0269 windows, which can be quite distracting. Most people will like a delay 0270 of 100-300 ms. This is responsive, but it will let you slide over the 0271 corners of a window on your way to your destination without bringing 0272 that window to the front. 0273 </para> 0274 </tip> 0275 0276 </sect3> 0277 0278 <sect3 id="focus-multiscreen"> 0279 <title>Multiscreen behavior</title> 0280 0281 <para> 0282 This controls the behavior of window focus with multiple screens. Note that these options appear only when more than one screen is currently connected. 0283 </para> 0284 0285 <variablelist> 0286 0287 <varlistentry> 0288 <term><guilabel>Active screen follows mouse</guilabel></term> 0289 <listitem> 0290 <para> 0291 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. 0292 </para> 0293 </listitem> 0294 </varlistentry> 0295 0296 <varlistentry> 0297 <term><guilabel>Separate screen focus</guilabel></term> 0298 <listitem> 0299 <para> 0300 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. 0301 </para> 0302 </listitem> 0303 </varlistentry> 0304 0305 </variablelist> 0306 0307 </sect3> 0308 0309 </sect2> 0310 0311 <sect2 id="titlebar-actions"> 0312 <title>Titlebar Actions</title> 0313 0314 <para> 0315 In this panel you can configure what happens to windows when a mousebutton is 0316 clicked on their titlebars. 0317 </para> 0318 0319 <sect3 id="actions-titlebar"> 0320 <title><guilabel>Titlebar Actions</guilabel></title> 0321 0322 <para> 0323 This section allows you to determine what happens when you double-click 0324 or scroll the mouse wheel on the titlebar of a window. 0325 </para> 0326 0327 <para> 0328 The following actions are available for <guilabel>Double-click</guilabel>: 0329 </para> 0330 0331 <variablelist> 0332 0333 <varlistentry> 0334 <term><guilabel>Maximize</guilabel></term> 0335 <listitem> 0336 <para> 0337 Resizes the window to fill the height and width of the screen. 0338 </para> 0339 </listitem> 0340 </varlistentry> 0341 0342 <varlistentry> 0343 <term><guilabel>Vertically maximize</guilabel></term> 0344 <listitem> 0345 <para> 0346 Resizes the window to the height of the screen. 0347 </para> 0348 </listitem> 0349 </varlistentry> 0350 0351 <varlistentry> 0352 <term><guilabel>Horizontally maximize</guilabel></term> 0353 <listitem> 0354 <para> 0355 Resizes the window to the width of the screen. 0356 </para> 0357 </listitem> 0358 </varlistentry> 0359 0360 <varlistentry> 0361 <term><guilabel>Minimize</guilabel></term> 0362 <listitem> 0363 <para> 0364 Hides the window into its minimized state, from which it can be restored ⪚ via the Task Manager or Task Switcher. 0365 </para> 0366 </listitem> 0367 </varlistentry> 0368 0369 <varlistentry> 0370 <term><guilabel>Shade</guilabel></term> 0371 <listitem> 0372 <para> 0373 Causes the window to be 0374 reduced to simply the titlebar. Double-clicking on the titlebar again 0375 restores the window to its normal size. 0376 </para> 0377 </listitem> 0378 </varlistentry> 0379 0380 <varlistentry> 0381 <term><guilabel>Close</guilabel></term> 0382 <listitem> 0383 <para> 0384 Closes the window. 0385 </para> 0386 </listitem> 0387 </varlistentry> 0388 0389 <varlistentry> 0390 <term><guilabel>Show on all desktops</guilabel></term> 0391 <listitem> 0392 <para> 0393 Makes the window be visible on all Virtual Desktops. 0394 </para> 0395 </listitem> 0396 </varlistentry> 0397 0398 <varlistentry> 0399 <term><guilabel>Do nothing</guilabel></term> 0400 <listitem> 0401 <para> 0402 Nothing happens on double-click. 0403 </para> 0404 </listitem> 0405 </varlistentry> 0406 0407 </variablelist> 0408 0409 <para> 0410 The <guilabel>Mouse wheel</guilabel> can be used to trigger an action depending on whether it is scrolled up or down: 0411 </para> 0412 0413 <variablelist> 0414 0415 <varlistentry> 0416 <term><guilabel>Raise/lower</guilabel></term> 0417 <listitem> 0418 <para> 0419 Scrolling up will move the window on top of other windows. 0420 </para> 0421 <para> 0422 Scrolling down will move the window below other windows. 0423 </para> 0424 </listitem> 0425 </varlistentry> 0426 0427 <varlistentry> 0428 <term><guilabel>Shade/unshade</guilabel></term> 0429 <listitem> 0430 <para> 0431 Scrolling up will collapse the window to just its titlebar. 0432 </para> 0433 <para> 0434 Scrolling down will restore the window to its normal size. 0435 </para> 0436 </listitem> 0437 </varlistentry> 0438 0439 <varlistentry> 0440 <term><guilabel>Maximize/restore</guilabel></term> 0441 <listitem> 0442 <para> 0443 Scrolling up will maximize the window to fill the whole screen. 0444 </para> 0445 <para> 0446 Scrolling down will restore it to its previous size. 0447 </para> 0448 </listitem> 0449 </varlistentry> 0450 0451 <varlistentry> 0452 <term><guilabel>Keep above/below</guilabel></term> 0453 <listitem> 0454 <para> 0455 Scrolling up will make the window stay on top, covering other windows. 0456 </para> 0457 <para> 0458 Scrolling down will make the window stay covered below other windows. 0459 </para> 0460 </listitem> 0461 </varlistentry> 0462 0463 <varlistentry> 0464 <term><guilabel>Move to previous/next desktop</guilabel></term> 0465 <listitem> 0466 <para> 0467 Scrolling up will move the window to the previous Virtual Desktop. 0468 </para> 0469 <para> 0470 Scrolling down will move the window to the next Virtual Desktop. 0471 </para> 0472 </listitem> 0473 </varlistentry> 0474 0475 <varlistentry> 0476 <term><guilabel>Change opacity</guilabel></term> 0477 <listitem> 0478 <para> 0479 Scrolling up will make the window less transparent. 0480 </para> 0481 <para> 0482 Scrolling down will make the window more transparent. 0483 </para> 0484 </listitem> 0485 </varlistentry> 0486 0487 <varlistentry> 0488 <term><guilabel>Do nothing</guilabel></term> 0489 <listitem> 0490 <para> 0491 Nothing happens when scrolling up or down on the window's titlebar. 0492 </para> 0493 </listitem> 0494 </varlistentry> 0495 0496 </variablelist> 0497 0498 <tip> 0499 <para> 0500 You can have windows automatically unshade when you simply place the 0501 mouse over their shaded titlebar. Just check the <link linkend="advanced-unshading"><guilabel>Window 0502 unshading</guilabel></link> check box in the <guilabel>Advanced</guilabel> tab of 0503 this module. This is a great way to reclaim screen space when you are 0504 cutting and pasting between a lot of windows, for example. 0505 </para> 0506 </tip> 0507 0508 </sect3> 0509 0510 <sect3 id="actions-titlebar-frame"> 0511 <title><guilabel>Titlebar and Frame Actions</guilabel></title> 0512 0513 <para> 0514 This section allows you to determine what happens when you single click 0515 on the titlebar or frame of a window. Notice that you can have 0516 different actions associated with the same click depending on whether 0517 the window is active or not. 0518 </para> 0519 0520 <para> For each combination of mousebuttons, Active and 0521 Inactive, you can select the most appropriate choice. The actions are 0522 as follows: 0523 </para> 0524 0525 <variablelist> 0526 0527 <varlistentry> 0528 <term><guilabel>Raise</guilabel></term> 0529 <listitem> 0530 <para> 0531 Will bring the window to the top of the window stack. All other windows 0532 which overlap with this one will be hidden <quote>below</quote> it. 0533 </para> 0534 </listitem> 0535 </varlistentry> 0536 0537 <varlistentry> 0538 <term><guilabel>Lower</guilabel></term> 0539 <listitem> 0540 <para> 0541 Will move this window to the bottom of the window stack. This will get the 0542 window out of the way. 0543 </para> 0544 </listitem> 0545 </varlistentry> 0546 0547 <varlistentry> 0548 <term><guilabel>Toggle raise and lower</guilabel></term> 0549 <listitem> 0550 <para> 0551 This will raise windows which are not on top, and lower windows which 0552 are already on top. 0553 </para> 0554 </listitem> 0555 </varlistentry> 0556 0557 <varlistentry> 0558 <term><guilabel>Minimize</guilabel></term> 0559 <listitem> 0560 <para> 0561 Hides the window into its minimized state, from which it can be restored ⪚ via the Task Manager or Task Switcher. 0562 </para> 0563 </listitem> 0564 </varlistentry> 0565 <varlistentry> 0566 0567 <term><guilabel>Shade</guilabel></term> 0568 <listitem> 0569 <para> 0570 Causes the window to be 0571 reduced to simply the titlebar. Double-clicking on the titlebar again 0572 restores the window to its normal size. 0573 </para> 0574 </listitem> 0575 </varlistentry> 0576 0577 <varlistentry> 0578 <term><guilabel>Close</guilabel></term> 0579 <listitem> 0580 <para> 0581 Closes the window. 0582 </para> 0583 </listitem> 0584 </varlistentry> 0585 0586 <varlistentry> 0587 <term><guilabel>Show actions menu</guilabel></term> 0588 <listitem> 0589 <para> 0590 Will bring up a small submenu where you can choose window related 0591 commands (&ie; Move to Desktop, Move to Screen, Maximize, Minimize, Close, &etc;). 0592 </para> 0593 </listitem> 0594 </varlistentry> 0595 0596 <varlistentry> 0597 <term><guilabel>Do nothing</guilabel></term> 0598 <listitem> 0599 <para> 0600 Nothing happens on click. 0601 </para> 0602 </listitem> 0603 </varlistentry> 0604 0605 </variablelist> 0606 0607 </sect3> 0608 0609 <sect3 id="actions-maximize-button"> 0610 <title><guilabel>Maximize Button Actions</guilabel></title> 0611 0612 <para> 0613 This section allows you to determine the behavior of the three mouse buttons 0614 onto the maximize button. 0615 </para> 0616 0617 <variablelist> 0618 0619 <varlistentry> 0620 <term><guilabel>Maximize</guilabel></term> 0621 <listitem> 0622 <para> 0623 Resizes the window to the height and width of the screen. 0624 </para> 0625 </listitem> 0626 </varlistentry> 0627 0628 <varlistentry> 0629 <term><guilabel>Vertically maximize</guilabel></term> 0630 <listitem> 0631 <para> 0632 Resizes the window to the height of the screen. 0633 </para> 0634 </listitem> 0635 </varlistentry> 0636 0637 <varlistentry> 0638 <term><guilabel>Horizontally maximize</guilabel></term> 0639 <listitem> 0640 <para> 0641 Resizes the window to the width of the screen. 0642 </para> 0643 </listitem> 0644 </varlistentry> 0645 0646 </variablelist> 0647 0648 </sect3> 0649 0650 </sect2> 0651 0652 <sect2 id="window-actions"> 0653 <title>Window Actions</title> 0654 0655 <sect3 id="actions-inactive-inner-window"> 0656 <title><guilabel>Inactive Inner Window</guilabel></title> 0657 0658 <para> 0659 This part of the module, allows you to configure what happens when you 0660 click on an inactive window, with any of the three mouse buttons or use 0661 the mouse wheel. 0662 </para> 0663 0664 <para> 0665 Your choices are as follows: 0666 </para> 0667 0668 <variablelist> 0669 0670 <varlistentry> 0671 <term><guilabel>Activate, raise and pass click</guilabel></term> 0672 <listitem> 0673 <para> 0674 This makes the clicked window active, raises it to the top of the 0675 display, and passes a mouse click to the application within the window. 0676 </para> 0677 </listitem> 0678 </varlistentry> 0679 0680 <varlistentry> 0681 <term><guilabel>Activate and pass click</guilabel></term> 0682 <listitem> 0683 <para> 0684 This makes the clicked window active and passes a mouse click to the 0685 application within the window. 0686 </para> 0687 </listitem> 0688 </varlistentry> 0689 0690 <varlistentry> 0691 <term><guilabel>Activate</guilabel></term> 0692 <listitem> 0693 <para> 0694 This simply makes the clicked window active. The mouse click is not 0695 passed on to the application within the window. 0696 </para> 0697 </listitem> 0698 </varlistentry> 0699 0700 <varlistentry> 0701 <term><guilabel>Activate and raise</guilabel></term> 0702 <listitem> 0703 <para> 0704 This makes the clicked window active and raises the window to the top of 0705 the display. The mouse click is not passed on to the application within 0706 the window. 0707 </para> 0708 </listitem> 0709 </varlistentry> 0710 0711 </variablelist> 0712 0713 <para> 0714 Your choices for <guilabel>Mouse wheel</guilabel> are as follows: 0715 </para> 0716 0717 <variablelist> 0718 0719 <varlistentry> 0720 <term><guilabel>Scroll</guilabel></term> 0721 <listitem> 0722 <para> 0723 Just scrolls the content within the window. 0724 </para> 0725 </listitem> 0726 </varlistentry> 0727 0728 <varlistentry> 0729 <term><guilabel>Activate and scroll</guilabel></term> 0730 <listitem> 0731 <para> 0732 This makes the clicked window active and scrolls the content. 0733 </para> 0734 </listitem> 0735 </varlistentry> 0736 0737 <varlistentry> 0738 <term><guilabel>Activate, raise and scroll</guilabel></term> 0739 <listitem> 0740 <para> 0741 This makes the clicked window active, raises the window to the top of 0742 the display, and scrolls the content. 0743 </para> 0744 </listitem> 0745 </varlistentry> 0746 0747 </variablelist> 0748 0749 </sect3> 0750 0751 <sect3 id="actions-inner-window-titlebar-frame"> 0752 <title><guilabel>Inner Window, Titlebar and Frame</guilabel></title> 0753 0754 <para> 0755 This bottom section allows you to configure additional actions when 0756 clicking on a window with a modifier key pressed. 0757 </para> 0758 0759 <para> 0760 As a <guilabel>Modifier key</guilabel>, you can select between <guilabel>Meta</guilabel> (default) or <guilabel>Alt</guilabel>. 0761 </para> 0762 0763 <para> 0764 Once again, you can select different actions for 0765 <mousebutton>Left</mousebutton>, <mousebutton>Middle</mousebutton> and 0766 <mousebutton>Right</mousebutton> button clicks and the <guilabel>Mouse 0767 wheel</guilabel>. 0768 </para> 0769 0770 <para> 0771 Your choices for the mouse buttons are: 0772 </para> 0773 0774 <variablelist> 0775 0776 <varlistentry> 0777 <term><guilabel>Move</guilabel></term> 0778 <listitem> 0779 <para> 0780 Allows you to drag the selected window around the workspace. 0781 </para> 0782 </listitem> 0783 </varlistentry> 0784 0785 <varlistentry> 0786 <term><guilabel>Activate, raise and move</guilabel></term> 0787 <listitem> 0788 <para> 0789 This makes the clicked window active, raises it to the top of the 0790 window stack, and drags the window around the workspace. 0791 </para> 0792 </listitem> 0793 </varlistentry> 0794 0795 <varlistentry> 0796 <term><guilabel>Toggle raise and lower</guilabel></term> 0797 <listitem> 0798 <para> 0799 This will raise windows which are not on top, and lower windows which 0800 are already on top. 0801 </para> 0802 </listitem> 0803 </varlistentry> 0804 0805 <varlistentry> 0806 <term><guilabel>Resize</guilabel></term> 0807 <listitem> 0808 <para> 0809 Allows you to change the size of the selected window. 0810 </para> 0811 </listitem> 0812 </varlistentry> 0813 0814 <varlistentry> 0815 <term><guilabel>Raise</guilabel></term> 0816 <listitem> 0817 <para> 0818 Will bring the window to the top of the window stack. All other windows 0819 which overlap with this one will be hidden <quote>below</quote> it. 0820 </para> 0821 </listitem> 0822 </varlistentry> 0823 0824 <varlistentry> 0825 <term><guilabel>Lower</guilabel></term> 0826 <listitem> 0827 <para> 0828 Will move this window to the bottom of the window stack. This will get the 0829 window out of the way. 0830 </para> 0831 </listitem> 0832 </varlistentry> 0833 0834 <varlistentry> 0835 <term><guilabel>Minimize</guilabel></term> 0836 <listitem> 0837 <para> 0838 Hides the window into its minimized state, from which it can be restored ⪚ via the Task Manager or Task Switcher. 0839 </para> 0840 </listitem> 0841 </varlistentry> 0842 0843 <varlistentry> 0844 <term><guilabel>Decrease opacity</guilabel></term> 0845 <listitem> 0846 <para> 0847 Makes the window more transparent. 0848 </para> 0849 </listitem> 0850 </varlistentry> 0851 0852 <varlistentry> 0853 <term><guilabel>Increase opacity</guilabel></term> 0854 <listitem> 0855 <para> 0856 Makes the window less transparent. 0857 </para> 0858 </listitem> 0859 </varlistentry> 0860 0861 <varlistentry> 0862 <term><guilabel>Do nothing</guilabel></term> 0863 <listitem> 0864 <para> 0865 Nothing happens on click. 0866 </para> 0867 </listitem> 0868 </varlistentry> 0869 0870 </variablelist> 0871 0872 <para> 0873 Your choices for the mouse wheel are: 0874 </para> 0875 0876 <variablelist> 0877 0878 <varlistentry> 0879 <term><guilabel>Raise/lower</guilabel></term> 0880 <listitem> 0881 <para> 0882 Scrolling up will move the window on top of other windows. 0883 </para> 0884 <para> 0885 Scrolling down will move the window below other windows. 0886 </para> 0887 </listitem> 0888 </varlistentry> 0889 0890 <varlistentry> 0891 <term><guilabel>Shade/unshade</guilabel></term> 0892 <listitem> 0893 <para> 0894 Scrolling up will collapse the window to just its titlebar. 0895 </para> 0896 <para> 0897 Scrolling down will restore the window to its normal size. 0898 </para> 0899 </listitem> 0900 </varlistentry> 0901 0902 <varlistentry> 0903 <term><guilabel>Maximize/restore</guilabel></term> 0904 <listitem> 0905 <para> 0906 Scrolling up will maximize the window to fill the whole screen. 0907 </para> 0908 <para> 0909 Scrolling down will restore it to its previous size. 0910 </para> 0911 </listitem> 0912 </varlistentry> 0913 0914 <varlistentry> 0915 <term><guilabel>Keep above/below</guilabel></term> 0916 <listitem> 0917 <para> 0918 Scrolling up will make the window stay on top, covering other windows. 0919 </para> 0920 <para> 0921 Scrolling down will make the window stay covered below other windows. 0922 </para> 0923 </listitem> 0924 </varlistentry> 0925 0926 <varlistentry> 0927 <term><guilabel>Move to previous/next desktop</guilabel></term> 0928 <listitem> 0929 <para> 0930 Scrolling up will move the window to the previous Virtual Desktop. 0931 </para> 0932 <para> 0933 Scrolling down will move the window to the next Virtual Desktop. 0934 </para> 0935 </listitem> 0936 </varlistentry> 0937 0938 <varlistentry> 0939 <term><guilabel>Change opacity</guilabel></term> 0940 <listitem> 0941 <para> 0942 Scrolling up will make the window less transparent. 0943 </para> 0944 <para> 0945 Scrolling down will make the window more transparent. 0946 </para> 0947 </listitem> 0948 </varlistentry> 0949 0950 <varlistentry> 0951 <term><guilabel>Do nothing</guilabel></term> 0952 <listitem> 0953 <para> 0954 Nothing happens on when scrolling up or down the window's titlebar. 0955 </para> 0956 </listitem> 0957 </varlistentry> 0958 0959 </variablelist> 0960 0961 </sect3> 0962 0963 </sect2> 0964 0965 <sect2 id="movement"> 0966 <title>Movement</title> 0967 0968 <para>This page allows you to configure the <guilabel>Snap 0969 Zones</guilabel>. These are like a magnetic field along the side of 0970 the screen and each window, which will make windows snap alongside 0971 when moved near. 0972 </para> 0973 0974 <variablelist> 0975 0976 <varlistentry> 0977 <term><guilabel>Screen edge snap zone</guilabel></term> 0978 <listitem> 0979 <para>Here you can set the snap zone for screen borders. Moving a 0980 window within the configured distance will make it snap to the edge of 0981 the screen. 0982 </para> 0983 </listitem> 0984 </varlistentry> 0985 0986 <varlistentry> 0987 <term><guilabel>Window snap zone</guilabel></term> 0988 <listitem> 0989 <para> 0990 Here you can set the snap zone for windows. As with screen 0991 borders, moving a window near to another will make it snap to the edge 0992 as if the windows were magnetized. 0993 </para> 0994 </listitem> 0995 </varlistentry> 0996 0997 <varlistentry> 0998 <term><guilabel>Center snap zone</guilabel></term> 0999 <listitem> 1000 <para> 1001 Here you can set the snap zone for the screen center, &ie; the 1002 <quote>strength</quote> of the magnetic field which will make windows snap 1003 to the center of the screen when moved near it. 1004 </para> 1005 </listitem> 1006 </varlistentry> 1007 1008 <varlistentry> 1009 <term><guilabel>Snap windows: Only when overlapping</guilabel></term> 1010 <listitem> 1011 <para> 1012 If checked, windows will not snap together if they are only near 1013 each other, they must be overlapping, by the configured amount or 1014 less. 1015 </para> 1016 </listitem> 1017 </varlistentry> 1018 1019 </variablelist> 1020 1021 <tip> 1022 <para> 1023 In the <guilabel>Screen Edges</guilabel> settings module in the <guilabel>Workspace Behavior</guilabel> 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. 1024 </para> 1025 </tip> 1026 1027 </sect2> 1028 1029 <sect2 id="advanced"> 1030 <title>Advanced</title> 1031 1032 <para> 1033 In the <guilabel>Advanced</guilabel> panel you can do more advanced fine 1034 tuning to the window behavior. 1035 </para> 1036 1037 <sect3 id="advanced-unshading"> 1038 <title>Window unshading</title> 1039 1040 <variablelist> 1041 <varlistentry> 1042 <term><guilabel>On titlebar hover after</guilabel></term> 1043 <listitem> 1044 <para> 1045 If this option is enabled, a shaded window will un-shade automatically 1046 when the mouse pointer has been over the titlebar for some time. Use 1047 the spinbox to configure the delay un-shading. 1048 </para> 1049 </listitem> 1050 </varlistentry> 1051 </variablelist> 1052 </sect3> 1053 1054 <sect3 id="advanced-placement"> 1055 <title>Window placement</title> 1056 1057 <para> 1058 The placement policy determines where a new window will appear 1059 on the screen. 1060 </para> 1061 1062 <para> 1063 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 <link linkend="focus-multiscreen">Multiscreen behavior</link>), with the exception of windows remembering their previous position (see <link linkend="advanced-remember-positions">below</link>). 1064 </para> 1065 1066 <variablelist> 1067 1068 <varlistentry> 1069 <term><guilabel>Minimal Overlapping</guilabel></term> 1070 <listitem> 1071 <para> 1072 Will place all new windows in such a manner as to overlap existing windows as little as possible. 1073 </para> 1074 </listitem> 1075 </varlistentry> 1076 1077 <varlistentry> 1078 <term><guilabel>Maximized</guilabel></term> 1079 <listitem> 1080 <para> 1081 Will try to maximize all new windows to fill the whole screen. 1082 </para> 1083 </listitem> 1084 </varlistentry> 1085 1086 <varlistentry> 1087 <term><guilabel>Random</guilabel></term> 1088 <listitem> 1089 <para> 1090 Will place all new windows in random locations. 1091 </para> 1092 </listitem> 1093 </varlistentry> 1094 1095 <varlistentry> 1096 <term><guilabel>Centered</guilabel></term> 1097 <listitem> 1098 <para> 1099 Will place all new windows in the center of the screen. 1100 </para> 1101 </listitem> 1102 </varlistentry> 1103 1104 <varlistentry> 1105 <term><guilabel>In Top-Left Corner</guilabel></term> 1106 <listitem> 1107 <para> 1108 Will place all new windows with their top left corner in the top left corner of 1109 the screen. 1110 </para> 1111 </listitem> 1112 </varlistentry> 1113 1114 <varlistentry> 1115 <term><guilabel>Under Mouse</guilabel></term> 1116 <listitem> 1117 <para> 1118 Will place all new windows centered under the mouse pointer. 1119 </para> 1120 </listitem> 1121 </varlistentry> 1122 1123 </variablelist> 1124 1125 <para id="advanced-remember-positions"> 1126 Check the <guilabel>Allow apps to remember the positions of 1127 their own windows</guilabel> 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. 1128 </para> 1129 1130 <tip> 1131 <para> 1132 If you would like some windows to appear on specific positions, screens, or Virtual Desktops, you can set up <guilabel>Window Rules</guilabel> to configure special window or application settings. You can find this by right-clicking on the titlebar of a window and choosing <guimenu>More Actions</guimenu>, or in the <guilabel>Window Rules</guilabel> module in the <guilabel>Window Management</guilabel> section of system settings. 1133 </para> 1134 </tip> 1135 1136 1137 </sect3> 1138 1139 <sect3 id="advanced-special-windows"> 1140 <title>Special windows</title> 1141 1142 <variablelist> 1143 1144 <varlistentry> 1145 <term><guilabel>Hide utility windows for inactive applications</guilabel></term> 1146 <listitem> 1147 <para> 1148 When turned on, utility windows (tool windows, torn-off menus, ...) of 1149 inactive applications will be hidden and will be shown only when the 1150 application becomes active. Note that applications have to mark the windows 1151 with the proper window type for this feature to work. 1152 </para> 1153 </listitem> 1154 </varlistentry> 1155 1156 </variablelist> 1157 1158 </sect3> 1159 1160 <sect3 id="advanced-virtual-desktop-behavior"> 1161 <title>Virtual Desktop behavior</title> 1162 1163 <para> 1164 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. 1165 </para> 1166 1167 <variablelist> 1168 1169 <varlistentry> 1170 <term><guilabel>Switch to that Virtual Desktop</guilabel></term> 1171 <listitem> 1172 <para> 1173 Will switch to the Virtual Desktop where the window is currently located. 1174 </para> 1175 <para> 1176 Choose this option if you would like the active Virtual Desktop to automatically follow windows to their assigned Virtual Desktop. 1177 </para> 1178 </listitem> 1179 </varlistentry> 1180 1181 <varlistentry> 1182 <term><guilabel>Bring window to current Virtual Desktop</guilabel></term> 1183 <listitem> 1184 <para> 1185 Will cause the window to jump to the active Virtual Desktop. 1186 </para> 1187 <para> 1188 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. 1189 </para> 1190 </listitem> 1191 </varlistentry> 1192 1193 <varlistentry> 1194 <term><guilabel>Do nothing</guilabel></term> 1195 <listitem> 1196 <para> 1197 The window stays on the desktop it currently is and the current desktop doesn't change. 1198 </para> 1199 <para> 1200 Choose this option if you would like to keep the windows and desktops as they are. 1201 </para> 1202 </listitem> 1203 </varlistentry> 1204 1205 </variablelist> 1206 1207 </sect3> 1208 1209 </sect2> 1210 1211 </sect1> 1212 1213 </article>