From d1c3b2a2612a26f1d944f0ac70174b4b331b2485 Mon Sep 17 00:00:00 2001 From: Yuri Chornoivan Date: Fri, 9 Apr 2021 19:00:15 +0300 Subject: [PATCH] Update window behavior KCM docs --- doc/windowbehaviour/index.docbook | 130 +++++++++++++++++++----------- 1 file changed, 82 insertions(+), 48 deletions(-) diff --git a/doc/windowbehaviour/index.docbook b/doc/windowbehaviour/index.docbook index 75f0305563..bebe41253e 100644 --- a/doc/windowbehaviour/index.docbook +++ b/doc/windowbehaviour/index.docbook @@ -16,8 +16,8 @@ -2015-07-14 -Plasma 5.3 +2021-04-09 +Plasma 5.20 KDE @@ -33,13 +33,13 @@ In the upper part of this control module you can see several tabs: Focus, Titlebar Actions, -Window Actions, Moving and +Window Actions, Movement and Advanced. In the Focus panel you can configure how windows gain or lose focus, &ie; become active or inactive. Using Titlebar Actions and Window Actions you can configure how titlebars and windows react to -mouse clicks. Moving allows you to configure how +mouse clicks. Movement allows you to configure how windows move and place themselves when started. The Advanced options cover some specialized options like window shading. @@ -48,7 +48,7 @@ like window shading. Please note that the configuration in this module will not take effect -if you do not use &kde;'s native window manager, &kwin;. If you do use a +if you do not use &plasma;'s native window manager, &kwin;. If you do use a different window manager, please refer to its documentation for how to customize window behavior. @@ -69,15 +69,15 @@ although this is configured here as well, focus and raising of windows are configured independently. -Focus Policy +Windows activation policy -There are six methods &kde; can use to determine the current focus: +There are six methods &kwin; can use to determine the current focus: -Click To Focus +Click to focus A window becomes active when you click into it. @@ -86,20 +86,20 @@ This behaviour is common on other operating systems and likely what you want.

-Click To Focus - Mouse Precedence +Click to focus (mouse precedence) -This is mostly the same as Click To Focus. +This is mostly the same as Click to focus. If an active window has to be chosen by the system (⪚ because the currently active one was closed) the window under the mouse is the preferred candidate. -Unusual, but possible variant of Click To Focus. +Unusual, but possible variant of Click to focus. -Focus Follows Mouse +Focus follows mouse Moving the mouse pointer actively over a normal window activates it. New @@ -108,7 +108,7 @@ windows such as the mini command line invoked with without you having to point the mouse at them explicitly. ⪚ windows randomly appearing under the mouse will not gain the focus. Focus stealing prevention takes place as usual. -Think as Click To Focus just without having to actually click. +Think as Click to focus just without having to actually click. @@ -119,10 +119,10 @@ follows mouse. -Focus Follows Mouse - Mouse Precedence +Focus follows mouse (mouse precedence) -This is mostly the same as Focus Follows Mouse. +This is mostly the same as Focus follows mouse. If an active window has to be chosen by the system (⪚ because the currently active one was closed) the window under the mouse is the preferred candidate. @@ -132,7 +132,7 @@ Choose this, if you want a hover controlled focus. -Focus Under Mouse +Focus under mouse The window that happens to be under the mouse pointer becomes active. If @@ -145,9 +145,9 @@ not receive the focus, you must move the mouse over them to type. -Focus Strictly Under Mouse +Focus strictly under mouse -Similar to Focus Under Mouse, but even more +Similar to Focus under mouse, 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 @@ -159,8 +159,8 @@ you must move the mouse over them to type. -Note that Focus Under Mouse and -Focus Strictly Under Mouse prevent certain +Note that Focus under mouse and +Focus strictly under mouse prevent certain features, such as Focus stealing prevention and the &Alt; walk-through-windows dialog, from working properly. @@ -169,7 +169,7 @@ walk-through-windows dialog, from working properly. -Focus stealing prevention level +Focus stealing prevention This option specifies how much KWin will try to prevent unwanted focus stealing caused by unexpected activation of new windows. @@ -220,7 +220,7 @@ is enabled and raise on hover is not available. With a hover to focus policy you can alternatively use auto raise. -By placing a mark in front of Raise on hover, delayed by, &kde; can +By placing a mark in front of Raise on hover, delayed by, &kwin; can bring a window to the front if the mouse is over that window for a specified period of time. You can determine the delay for this option by using the spin box control. @@ -256,7 +256,7 @@ clicked on their titlebars. -Titlebar double-click +Double-click In this drop down box you can select either @@ -266,7 +266,7 @@ In this drop down box you can select either -Selecting Maximize causes &kde; to maximize the +Selecting Maximize causes &kwin; to maximize the window whenever you doubleclick on the titlebar. You can further choose to maximize windows only horizontally or only vertically. @@ -276,15 +276,15 @@ reduced to simply the titlebar. Double clicking on the titlebar again, restores the window to its normal size. -Similar options are available for Wheel event. +Similar options are available for Mouse wheel. You can have windows automatically unshade when you simply place the -mouse over their shaded titlebar. Just check the Enable -hover check box in the Advanced tab of +mouse over their shaded titlebar. Just check the Window +unshading check box in the Advanced tab of this module. This is a great way to reclaim desktop space when you are cutting and pasting between a lot of windows, for example. @@ -293,7 +293,7 @@ cutting and pasting between a lot of windows, for example. -<guilabel>Titlebar & Frame</guilabel> +<guilabel>Titlebar and Frame Actions</guilabel> This section allows you to determine what happens when you single click @@ -329,7 +329,7 @@ window out of the way. -Toggle Raise & Lower +Toggle raise and lower This will raise windows which are not on top, and lower windows which @@ -343,7 +343,7 @@ Minimize, Shade, Close --> -Nothing +Do nothing Just like it says. Nothing happens. @@ -352,7 +352,7 @@ Just like it says. Nothing happens. -Operations Menu +Show actions menu Will bring up a small submenu, where you can choose window related @@ -365,7 +365,7 @@ commands (&ie; Maximize, Minimize, Close, &etc;). -<guilabel>Maximize Button</guilabel> +<guilabel>Maximize Button Actions</guilabel> This section allows you to determine the behavior of the three mouse buttons onto the maximize button. You have the choice between vertical only, horizontal @@ -393,7 +393,7 @@ Your choices are as follows: -Activate, Raise & Pass Click +Activate, raise and pass click This makes the clicked window active, raises it to the top of the @@ -403,7 +403,7 @@ display, and passes a mouse click to the application within the window. -Activate & Pass Click +Activate and pass click This makes the clicked window active and passes a mouse click to the @@ -423,7 +423,7 @@ passed on to the application within the window. -Activate & Raise +Activate and raise This makes the clicked window active and raises the window to the top of @@ -432,14 +432,45 @@ the window. + - + +Your choices for Mouse wheel are as follows: + + + +Scroll + + +Just scrolls the content within the window. + + + + + +Activate and scroll + + +This makes the clicked window active and scrolls the content. + + + + + +Activate, raise and scroll + + +This makes the clicked window active, raises the window to the top of +the display, and scrolls the content. + + + -<guilabel>Inner Window, Titlebar & Frame</guilabel> +<guilabel>Inner Window, Titlebar and Frame</guilabel> This bottom section, allows you to configure additional actions, when @@ -504,7 +535,7 @@ Allows you to change the size of the selected window. -Toggle Raise & Lower +Toggle raise and lower This will raise windows which are not on top, and lower windows which @@ -539,17 +570,18 @@ Nothing -Moving +Movement - -<guilabel>Windows</guilabel> The options here determine how windows appear on screen when you are moving them. + +<guilabel>Window geometry</guilabel> + -Display window geometry when moving or resizing +Display when moving or resizing Enable this option if you want a window's geometry to be displayed while it is being moved or resized. The window position relative to the top-left @@ -570,7 +602,7 @@ when moved near. -Border snap zone: +Screen edge snap zone: Here you can set the snap zone for screen borders. Moving a @@ -601,7 +633,7 @@ to the center of the screen when moved near it. -Snap windows only when overlapping +Snap windows: Only when overlapping If checked, windows will not snap together if they are only near @@ -623,10 +655,10 @@ tuning to the window behavior. -Shading +Window unshading -Enable hover +On titlebar hover after If this option is enabled, a shaded window will un-shade automatically @@ -640,7 +672,7 @@ the spinbox to configure the delay un-shading. -Placement +Window placement The placement policy determines where a new window will appear on the desktop. Minimal Overlapping will try to achieve a minimum overlap of windows, Cascaded will cascade the @@ -648,7 +680,9 @@ windows, and Random will use a random position. Centered will open all new windows in the center of the screen, and In Top-Left Corner will open all windows with their top left corner in the top left corner of -the screen. +the screen. Check the Allow KDE apps to remember the positions of +their own windows item to keep the data on the &plasma; windows +positions.