Git commit 8632c280954637a401c5cd0db2d84985ffbeec10 by Burkhard L?ck. Committed on 15/11/2013 at 20:10. Pushed by lueck into branch 'KDE/4.11'.
windowbehaviour kcm update to 4.12 CCBUG:305297 (cherry picked from commit 244f3162eb37a169a4e9a64e26f29422a5ec9965) backport for 4.12 M +126 -204 doc/kcontrol/windowbehaviour/index.docbook http://commits.kde.org/kde-workspace/8632c280954637a401c5cd0db2d84985ffbeec10 diff --git a/doc/kcontrol/windowbehaviour/index.docbook b/doc/kcontrol/windowbehaviour/index.docbook index 83e06c5..f98efd3 100644 --- a/doc/kcontrol/windowbehaviour/index.docbook +++ b/doc/kcontrol/windowbehaviour/index.docbook @@ -16,8 +16,8 @@ <!-- TRANS:ROLES_OF_TRANSLATORS --> </authorgroup> -<date>2010-10-28</date> -<releaseinfo>&kde; 4.5</releaseinfo> +<date>2013-11-15</date> +<releaseinfo>&kde; 4.12</releaseinfo> <keywordset> <keyword>KDE</keyword> @@ -42,7 +42,7 @@ you can configure how titlebars and windows react to mouse clicks. <guilabel>Moving</guilabel> allows you to configure how windows move and place themselves when started. The <guilabel>Advanced</guilabel> options cover some specialized options -involving moving windows between desktops and <quote>window +like <quote>window tabbing</quote> and <quote>window shading</quote>. </para> @@ -69,60 +69,32 @@ front — this is referred to as <quote>raised</quote>, and although this is configured here as well, focus and raising of windows are configured independently.</para> -<sect3 id="action-focus-focusstealin"> -<title>Focus stealing prevention level</title> - -<para>This option specifies how much KWin will try to prevent unwanted focus -stealing caused by unexpected activation of new windows.</para> -<note><para>This feature does not work with the <guilabel>Focus Under Mouse</guilabel> -or <guilabel>Focus Strictly Under Mouse</guilabel> focus policies.</para></note> -<variablelist> -<varlistentry> -<term><guilabel>None</guilabel></term> -<listitem><para>Prevention is turned off and new windows always become activated.</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Low</guilabel></term> -<listitem><para>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.</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Medium</guilabel></term> -<listitem><para>Prevention is enabled.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>High</guilabel></term> -<listitem><para>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.</para></listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Extreme</guilabel></term> -<listitem><para>All windows must be explicitly activated by the user.</para></listitem> -</varlistentry> -</variablelist> -<para>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.</para> -</sect3> - <sect3 id="action-focus-focuspolicy"> <title>Focus Policy</title> <para> -There are four methods &kde; can use to determine the current focus: +There are six methods &kde; can use to determine the current focus: </para> <variablelist> <varlistentry> -<term><guilabel>Click to Focus</guilabel></term> +<term><guilabel>Click To Focus</guilabel></term> <listitem> <para> A window becomes active when you click into it. +This behaviour is common on other operating systems and likely what you want.</para> +</listitem> +</varlistentry> + +<varlistentry> +<term><guilabel>Click To Focus - Mouse Precedence</guilabel></term> +<listitem> +<para> +This is mostly the same as <guilabel>Click To Focus</guilabel>. +If an active window has to be chosen by the system +(eg. because the currently active one was closed) +the window under the mouse is the preferred candidate. +Unusual, but possible variant of <guilabel>Click To Focus</guilabel>. </para> </listitem> </varlistentry> @@ -135,6 +107,9 @@ Moving the mouse pointer actively over a normal window activates it. New windows such as the mini command line invoked with <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will receive the focus, 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 <guilabel>Click To Focus</guilabel> just without having to actually click. </para> <para> @@ -145,6 +120,19 @@ follows mouse</quote>. </varlistentry> <varlistentry> +<term><guilabel>Focus Follows Mouse - Mouse Precedence</guilabel></term> +<listitem> +<para> +This is mostly the same as <guilabel>Focus Follows Mouse</guilabel>. +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. +Choose this, if you want a hover controlled focus. +</para> +</listitem> +</varlistentry> + +<varlistentry> <term><guilabel>Focus Under Mouse</guilabel></term> <listitem> <para> @@ -152,7 +140,7 @@ The window that happens to be under the mouse pointer becomes active. If the mouse is not over a window (for instance, it's on the desktop) the last window that was under the mouse has focus. New windows such as the mini command line invoked with <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo> will -not receive the focus, you must move the mouse over them to type. +ot receive the focus, you must move the mouse over them to type. </para> </listitem> </varlistentry> @@ -168,29 +156,70 @@ New windows such as the mini command line invoked with you must move the mouse over them to type. </para> +</listitem> +</varlistentry> +</variablelist> + <note><para>Note that <guilabel>Focus Under Mouse</guilabel> and <guilabel>Focus Strictly Under Mouse</guilabel> prevent certain -features, such as the <keycombo action="simul">&Alt;	</keycombo> +features, such as <guilabel>Focus stealing prevention</guilabel> and the +<keycombo action="simul">&Alt;	</keycombo> walk-through-windows dialog, from working properly.</para> </note> -</listitem> +</sect3> + +<sect3 id="action-focus-focusstealin"> +<title>Focus stealing prevention level</title> + +<para>This option specifies how much KWin will try to prevent unwanted focus +stealing caused by unexpected activation of new windows.</para> + +<variablelist> +<varlistentry> +<term><guilabel>None</guilabel></term> +<listitem><para>Prevention is turned off and new windows always become activated.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Low</guilabel></term> +<listitem><para>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.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Medium</guilabel></term> +<listitem><para>Prevention is enabled.</para></listitem> </varlistentry> -</variablelist> +<varlistentry> +<term><guilabel>High</guilabel></term> +<listitem><para>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.</para></listitem> +</varlistentry> +<varlistentry> +<term><guilabel>Extreme</guilabel></term> +<listitem><para>All windows must be explicitly activated by the user.</para></listitem> +</varlistentry> +</variablelist> +<para>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.</para> +</sect3> + +<sect3 id="action-focus-raisingwindow"> +<title>Raising window</title> <para> Once you have determined the focus policy, there are the window raising options. </para> <para> -By placing a mark in front of <guilabel>Raise, with the following delay</guilabel>, &kde; can +By placing a mark in front of <guilabel>Raise on hover, delayed by</guilabel>, &kde; can bring a window to the front if the mouse is over that window for a -specified period of time. When <guilabel>Delay focus by</guilabel> is enabled, -there will be a delay after which the window the mouse pointer is over will become -active (receive focus). -This is very useful with the <guilabel>Focus Follows Mouse</guilabel> option. -You can determine the delay for both options by using the spin box controls. +specified period of time. You can determine the delay for this option by using the spin box control. </para> <tip> @@ -205,7 +234,7 @@ that window to the front. <para> If you do not use auto raise, make sure the -<guilabel>Click raise active window</guilabel> option has a mark in front of it. You +<guilabel>Click raises active window</guilabel> option has a mark in front of it. You will not be happy with both auto raise and <guilabel>Click raise active window</guilabel> disabled, the net effect is that windows are not raised at all. @@ -213,52 +242,6 @@ windows are not raised at all. </sect3> -<!-- not in 4.5 -<sect3 id="action-focus-keyboard"> -<title><guilabel>Navigation</guilabel></title> - -<para> -In the <guilabel>Navigation</guilabel> frame you can configure the way -switching between applications or desktops using <keycombo -action="simul"> &Alt;	</keycombo> or <keycombo -action="simul"> &Ctrl;	</keycombo>. -</para> - -<para> -Switching applications using <keycombo action="simul">&Alt; -	</keycombo>, &ie; holding down &Alt; while -repeatedly pressing the 	 key, can take place in -&kde; mode or in &CDE; mode: in &kde; mode you will see -a box in the middle of the screen showing you the currently selected -application while you are still holding down the &Alt; key. In -&CDE; mode focus goes to each new window as it's selected. -</para> - -<para> -<guilabel>Show window list while switching windows</guilabel> missing -Next there is an option where you can choose to <guilabel>Traverse -windows on all desktops</guilabel> or not. With this enabled, switching -windows with <keycombo action="simul"> -&Alt;	</keycombo> will show all windows, on all -desktops, and take you to the appropriate desktop for the window you -select. With it disabled, only windows on your current desktop are -selectable with <keycombo action="simul"> -&Alt;	</keycombo>, and you must use <keycombo -action="simul">&Ctrl;	</keycombo> to switch to other -desktops yourself. -</para> - -<para>If you check the <guilabel>Desktop navigation wraps -around</guilabel> checkbox, then after you reach the -<quote>last</quote> desktop, pressing 	 again will -select the first desktop again.</para> - -<para>Many people name their virtual desktops according to their -purpose or some other naming scheme. You may find it convenient to -select the <guilabel>Popup desktop name on desktop switch</guilabel>, -so you can quickly tell that you have switched to the right one.</para> -</sect3> ---> </sect2> <sect2 id="titlebar-actions"> @@ -270,7 +253,7 @@ clicked on their titlebars. </para> <sect3 id="action-actions-sec1"> -<title><guilabel>Titlebar double-click</guilabel></title> +<title>Titlebar double-click</title> <para> In this drop down box you can select either @@ -289,7 +272,7 @@ reduced to simply the titlebar. Double clicking on the titlebar again, restores the window to its normal size. </para> -<!-- <guilabel>Titlebar wheel event</guilabel> missing --> +<!--FIXME <guilabel>Wheel event</guilabel> missing --> <tip> <para> @@ -313,7 +296,7 @@ different actions associated with the same click depending on whether the window is active or not. </para> -<para> For each combination of mousebuttons, modifiers, Active and +<para> For each combination of mousebuttons, Active and Inactive, you can select the most appropriate choice. The actions are as follows: </para> @@ -367,7 +350,7 @@ which overlap with this one, will be hidden <quote>below</quote> it. </varlistentry> <varlistentry> -<term>Toggle Raise & Lower</term> +<term><guilabel>Toggle Raise & Lower</guilabel></term> <listitem> <para> This will raise windows which are not on top, and lower windows which @@ -375,6 +358,9 @@ are already on top. </para> </listitem> </varlistentry> +<!--FIXME missing: +Shade, Close, Start Window Tab Drag +--> </variablelist> </sect3> @@ -397,7 +383,8 @@ only or both directions. <para> 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. +click on an inactive window, with any of the three mouse buttons or use +the mouse wheel. </para> <para> @@ -429,7 +416,7 @@ application within the window. <term><guilabel>Activate</guilabel></term> <listitem> <para> -This simply makes the clicked window active. The mouse click is not +This simply makes the clicked window active. The mouse click is not passed on to the application within the window. </para> </listitem> @@ -440,13 +427,15 @@ passed on to the application within the window. <listitem> <para> 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 display. The mouse click is not passed on to the application within the window. </para> </listitem> </varlistentry> -</variablelist> +<!--FIXME Mouse wheel Scroll, Activate & Scroll, Activate, Raise & Scroll--> + +</variablelist> </sect3> <sect3 id="action-actions-sec4"> @@ -524,6 +513,17 @@ are already on top. </listitem> </varlistentry> </variablelist> +<!-- FIXME missing: +Activate, Raise & Move +Minimize +Increase Opacity + Decrease Opacity +--> +<!--FIXME +Mouse Wheel has different choices: +Raise/Lower, Shade/Unshade, Maximize/Restore, Keep Above/Below, +Move to Previous/Next Desktop, Change Opacity, Switch to Window Tab to the Left/Right +Nothing +--> </sect3> @@ -534,48 +534,17 @@ are already on top. <sect3> <title><guilabel>Windows</guilabel></title> - -<para>The options here determine how windows appear on screen when you -are moving them. Most of these options exact a price in performance, -so if you want to streamline your desktop, you should turn them off. -However, if you have a fast computer, they may make your day a little -more pleasant, so leave them on.</para> +<para> +The options here determine how windows appear on screen when you +are moving them.</para> <variablelist> <varlistentry> -<term><guilabel>Display content in moving windows</guilabel></term> -<listitem> -<para>Enable this option if you want a window's content to be fully -shown while moving it, instead of just showing a window -<quote>skeleton</quote>. The result may not be satisfying on slow -computers without graphic acceleration.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Display content in resizing windows</guilabel></term> +<term><guilabel>Display window geometry when moving or resizing</guilabel></term> <listitem> -<para>Enable this option if you want a window's content to be shown -while resizing it, instead of just showing a window -<quote>skeleton</quote>. The result, again, may not be satisfying on -slower computers.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Display window geometry when moving or -resizing</guilabel></term> -<listitem> -<para>Enable this option if you want a popup tooltip to tell you the -size in pixels of a window as you resize it.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Display borders on maximized windows</guilabel></term> -<listitem> -<para>When enabled, this feature activates the border of maximized -windows, and allows you to move or resize them just as you can normal -windows.</para> +<para>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 +corner of the screen is displayed together with its size.</para> </listitem> </varlistentry> </variablelist> @@ -647,21 +616,13 @@ tuning to the window behavior. <variablelist> <title>Shading</title> -<!--not in 4.5 varlistentry> -<term><guilabel>Animate</guilabel></term> -<listitem> -<para>If this option is enabled, shading, or rolling up a window until just -the title bar is shown, will be animated.</para> -</listitem> -</varlistentry--> - <varlistentry> <term><guilabel>Enable hover</guilabel></term> <listitem> <para> 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 slider to configure the delay un-shading. +the spinbox to configure the delay un-shading. </para> </listitem> </varlistentry> @@ -671,10 +632,9 @@ the slider to configure the delay un-shading. <title>Window Tabbing</title> <varlistentry> -<term>When turned on attempt to automatically detect when a newly opened window is -related to an existing one and place them in the same window group.</term> -<listitem><para> -</para></listitem> +<term><guilabel>Automatically group similar windows</guilabel></term> +<listitem><para>When turned on attempt to automatically detect when a newly opened window is +related to an existing one and place them in the same window group.</para></listitem> </varlistentry> <varlistentry> @@ -695,6 +655,10 @@ open all windows with their top left corner in the top left corner of the screen.</para></listitem> </varlistentry> +</variablelist> + +<variablelist> +<title>Special Window</title> <varlistentry> <term><guilabel>Hide utility windows for inactive applications</guilabel></term> <listitem><para>When turned on, utility windows (tool windows, torn-off menus,...) of @@ -705,48 +669,6 @@ with the proper window type for this feature to work.</para></listitem> </variablelist> -<variablelist> -<title>Tiling</title> - -<varlistentry> -<term><guilabel>Enable Tiling</guilabel></term> -<listitem><para>A tiling window manager lays out all the windows in a -non-overlapping manner. This way all windows are always visible. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Default Tiling Layout</guilabel></term> -<listitem><para>Select <guilabel>Spiral</guilabel>, <guilabel>Columns</guilabel> -(Two-column horizontal tiling layout) or <guilabel>Floating</guilabel> (Floating -layout, windows are not tiled at all) as default here. -</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Floating Windows Raising</guilabel></term> -<listitem><para>The window raising policy determines how floating windows are stacked. -<guilabel>Raise/Lower floating windows</guilabel> all will raise all floating -windows when a floating window is activated. <guilabel>Raise/Lower current -window only</guilabel> will raise only the current window. <guilabel>Floating windows -are always on top</guilabel> keep floating windows on top, even when a tiled window -is activated.</para></listitem> -</varlistentry> - -</variablelist> - -<!--not in 4.5 in this module -<para>Finally, you can configure <guilabel>Active Desktop -Borders</guilabel>. If this is enabled, moving the mouse to a screen -border will change your desktop. This is useful if you want to drag -windows from one desktop to another.</para> - -<para>You can set this option to <guilabel>Disabled</guilabel>, which -is the default, to <guilabel>Only when moving windows</guilabel>, or -to <guilabel>Always enabled</guilabel> in which case just pushing your -mouse against the side of the screen will switch you to a new -desktop.</para> ---> </sect2> </sect1>
