<sect1 id="mouse-behav">
<sect1info>

<authorgroup>
<author>
<firstname>Mike</firstname>
<surname>McBride</surname>
</author>
</authorgroup>

<date>02/02/2001</date>
<releaseinfo>1.00.00</releaseinfo>

<keywordset>
<keyword>KDE</keyword>
<keyword>KControl</keyword>
<keyword>mouse</keyword>
</keywordset>
</sect1info>

<title>Mouse Behavior</title>

<para>This module is designed to help you control exactly what happens to
windows when a mouse is clicked on them.  </para>

<para>Because of the design of this panel, you can fine tune the mouse clicks,
so that &kde; does what you want when you want it to.</para>

<sect2 id="mouse-behav-use">
<title>Use</title>

<para>This panel is divided into 4 sections.</para>

<sect3 id="mouse-behav-sec1">
<title><guilabel>Titlebar Doubleclick</guilabel></title>

<para>This section provides a single dropdown box.  You can select either
<guilabel>Shade</guilabel>, or <guilabel>Maximize</guilabel>.</para>

<para>Selecting <guilabel>Maximise</guilabel>, causes &kde; to maximise the
window whenever you doubleclick on the titlebar.  <guilabel>Shade</guilabel>, on
the other hand, causes the window to be reduced to simply the titlebar.
Doublclicking on the titlebar again, restores the window to its normal
size.</para>

</sect3>

<sect3 id="mouse-behav-sec2">
<title><guilabel>Titlebar and Frame</guilabel></title>

<para>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.</para>

<para>For each combination of mousebuttons and Active/Inactive, you can select
the most appropriate choice.  The actions are as follows:</para>

<variablelist>
<varlistentry>
<term><guilabel>Activate</guilabel></term>
<listitem><para>Make this window active.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Lower</guilabel></term>
<listitem><para>Will move this window to the bottom of the display.  This will
get the window out of the way.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Nothing</guilabel></term>
<listitem><para>Just like it says.  Nothing happens.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Operations Menu</guilabel></term>
<listitem><para>Will bring up a small submenu, where you can choose window
related commands (<abbrev>ie</abbrev> Maximize, Minimize, Close,
<abbrev>etc</abbrev>).</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Raise</guilabel></term>
<listitem><para>Will bring the window to the top of the display.  All other
windows which overlap with this one, will be hidden <quote>below</quote>
it.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Toggle Raise and Lower</guilabel></term>
<listitem><para>This will raise windows which are not on top, and lower windows
which are already on top.</para></listitem>
</varlistentry>
</variablelist>
</sect3>

<sect3 id="mouse-behav-sec3">
<title><guilabel>Inactive Inner Window</guilabel></title>

<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.</para>

<para>Your choices are as follows:</para>

<variablelist>
<varlistentry>
<term><guilabel>Activate, Raise and pass click</guilabel></term>
<listitem><para>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.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Activate and pass click</guilabel></term>
<listitem><para>This makes the clicked window active and passes a mouse click to
the application within the window.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Activate</guilabel></term>
<listitem><para>This simply makes the clicked window active.  The mouse click is
not passed on to the application within the window.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Activate and Raise</guilabel></term>
<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 window.</para></listitem>
</varlistentry>
</variablelist>

</sect3>

<sect3 id="mouse-behav-sec4">
<title><guilabel>Inner Window, Titlebar and Frame</guilabel></title>

<para>This bottom section, allows you to configure additional actions, when the
&Alt; key is pressed, and a mouse click is made on a window. </para>

<para>Once again, you can select different actions for
<mousebutton>Left</mousebutton>, <mousebutton>Middle</mousebutton> and
<mousebutton>Right</mousebutton> button clicks.</para>

<para>Your choices are:</para>

<variablelist>
<varlistentry>
<term><guilabel>Lower</guilabel></term>
<listitem><para>Will move this window to the bottom of the display.  This will
get the window out of the way.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Move</guilabel></term>
<listitem><para>Allows you to drag the selected window around the
desktop.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Nothing</guilabel></term>
<listitem><para>Just like it says.  Nothing happens.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Raise</guilabel></term>
<listitem><para>Will bring the window to the top of the display.  All other
windows which overlap with this one, will be hidden "below"
it.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Resize</guilabel></term>
<listitem><para>Allows you to change the size of the selected
window.</para></listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Toggle Raise and Lower</guilabel></term>
<listitem><para>This will raise windows which are not on top, and lower windows
which are already on top.</para></listitem>
</varlistentry>
</variablelist>

</sect3>
</sect2>

<sect2 id="mouse-behav-author">
<title>Section Author</title>

<para>This section written by Mike McBride <email>mpmcbride7@yahoo.com</email>
</para>

</sect2>
</sect1>
