<!--FIXME:
        -general toolbar info
        -basic keyboard shortcuts?
-->

<chapter id="ui">
<title>Finding Your Way Around</title>

<sect1 id="visualdict">
<sect1info>
<authorgroup>
<author><firstname>Claus</firstname> <surname>Christensen</surname></author>
<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</sect1info>

<title>A Visual Dictionary</title>

<para>The &plasma-workspaces; feature many different graphical user interface
elements, commonly known as <quote>widgets</quote>.  This guide will introduce
you to their names and functions.</para>

<sect2 id="visualdict-screens">
<title>The Big Picture</title>

<sect3 id="visualdict-windows">
<title>Windows</title>

<screenshot>
<screeninfo>A Window</screeninfo>
<mediaobjectco>
<imageobjectco>
<areaspec units="other" otherunits="imagemap">
    <!--these ids are used only internally by DocBook so we keep them short-->
    <area id="im-win1a1" linkends="visualdict-statusbar" coords="47,522,752,566" />
    <area id="im-win1a2" linkends="visualdict-scrollbar" coords="720,127,760,513" />
    <area id="im-win1a3" linkends="visualdict-central-widget" coords="48,127,719,515" />
    <area id="im-win1a4" linkends="visualdict-toolbar" coords="51,95,570,128" />
    <area id="im-win1a5" linkends="visualdict-menubar" coords="4,67,46,109" />
    <area id="im-win1a6" linkends="visualdict-menubar" coords="49,75,311,93" />
    <area id="im-win1a7" linkends="visualdict-menu" coords="50,51,72,70" />
    <area id="im-win1a8" linkends="visualdict-button" coords="74,52,93,69" />
    <area id="im-win1a9" linkends="visualdict-button" coords="678,51,747,70" />
    <area id="im-win1a10" linkends="visualdict-titlebar" coords="106,40,676,74" />
    <area id="im-win1a11" linkends="visualdict-button" coords="691,6,740,49" />
    <area id="im-win1a12" linkends="visualdict-titlebar" coords="346,0,388,37" />
    <area id="im-win1a13" linkends="visualdict-button" coords="61,1,103,43" />
    <area id="im-win1a14" linkends="visualdict-menu" coords="14,2,57,45" />
</areaspec>
<imageobject><imagedata fileref="visualdict-window.png" format="PNG"/></imageobject>
</imageobjectco>
</mediaobjectco>
</screenshot>
<para>This is the window of the &kwrite;, a text editor.  Click on
part of the window to learn more about it.</para>

<orderedlist>

<listitem><para>
The <emphasis role="bold">Window Menu</emphasis>
</para></listitem>

<listitem><para>
The <emphasis role="bold"><link linkend="visualdict-titlebar">Titlebar</link></emphasis>
</para></listitem>

<listitem><para>
Buttons to <emphasis>minimize</emphasis>, <emphasis>maximize</emphasis>, or
<emphasis>close</emphasis> the window
</para></listitem>

<listitem><para>
The <emphasis role="bold"><link linkend="visualdict-menubar">Menubar</link></emphasis>
</para></listitem>

<listitem><para>
The <emphasis role="bold"><link linkend="visualdict-toolbar">Toolbar</link></emphasis>
</para></listitem>

<listitem><para>
A very large 
<emphasis role="bold"><link linkend="visualdict-text-area">Text Area</link></emphasis>
that acts as this program's 
<emphasis role="bold"><link linkend="visualdict-central-widget">Central Widget</link></emphasis>
</para></listitem>

<listitem><para>
A vertical <emphasis role="bold"><link linkend="visualdict-scrollbar">Scrollbar</link></emphasis>
(there is also a horizontal scrollbar below the text box)
</para></listitem>

<listitem><para>
The <emphasis role="bold"><link linkend="visualdict-statusbar">Statusbar</link></emphasis>
</para></listitem>

</orderedlist>

<screenshot>
<screeninfo>Another Window</screeninfo>
<mediaobjectco>
<imageobjectco>
<areaspec units="other" otherunits="imagemap">
    <area id="im-win2a1" linkends="visualdict-panel" coords="580,80,763,529" />
    <area id="im-win2a2" linkends="visualdict-slider" coords="383,490,573,536" />
    <area id="im-win2a3" linkends="visualdict-context-menu" coords="199,225,451,462" />
    <area id="im-win2a4" linkends="visualdict-icon" coords="198,187,224,225" />
    <area id="im-win2a5" linkends="visualdict-icon" coords="121,187,197,276" />
    <area id="im-win2a6" linkends="visualdict-icon" coords="282,110,515,165" />
    <area id="im-win2a7" linkends="visualdict-icon" coords="124,111,211,163" />
    <area id="im-win2a8" linkends="visualdict-breadcrumb" coords="108,76,415,109" />
    <area id="im-win2a9" linkends="visualdict-panel" coords="1,73,107,544" />
</areaspec>
<imageobject><imagedata fileref="visualdict-window2.png" format="PNG"/></imageobject>
</imageobjectco>
</mediaobjectco>
</screenshot>

<para>This is the another window, that of the &dolphin; file manager.  Click on
part of the window to learn more about it.</para>

<orderedlist>

<listitem><para>
A <emphasis role="bold"><link linkend="visualdict-panel">panel</link></emphasis>
that contains a list of Places on the computer system
</para></listitem>

<listitem><para>
A <emphasis role="bold"><link linkend="visualdict-breadcrumb">Breadcrumb</link></emphasis>
of the path of the displayed folder
</para></listitem>

<listitem><para>
A folder <emphasis role="bold"><link linkend="visualdict-icon">Icon</link></emphasis>
</para></listitem>

<listitem><para>
A file <emphasis role="bold"><link linkend="visualdict-icon">Icon</link></emphasis>
</para></listitem>

<listitem><para>
A highlighted <emphasis role="bold"><link linkend="visualdict-icon">Icon</link></emphasis>
</para></listitem>

<listitem><para>
A <emphasis role="bold"><link linkend="visualdict-context-menu">Context Menu</link></emphasis>
listing actions that can be performed on a file
</para></listitem>

<listitem><para>
A <emphasis role="bold"><link linkend="visualdict-slider">Slider</link></emphasis>
that changes the size of the <link linkend="visualdict-icon">Icons</link> 
displayed
</para></listitem>

<listitem><para>
More <emphasis role="bold"><link linkend="visualdict-panel">Panels</link></emphasis>
</para></listitem>

</orderedlist>

</sect3>

<sect3 id="visualdict-gui">
<title>Elements of Graphical User Interface (&GUI;)</title>

<screenshot>
<screeninfo>Some &GUI; Elements</screeninfo>
<mediaobjectco>
<imageobjectco>
<areaspec units="other" otherunits="imagemap">
    <area id="im-g1a1" linkends="visualdict-button" coords="15,505,690,549" />
    <area id="im-g1a2" linkends="visualdict-button" coords="683,129,722,170" />
    <area id="im-g1a3" linkends="visualdict-button" coords="636,140,681,161" />
    <area id="im-g1a4" linkends="visualdict-drop-down-box" coords="225,137,631,327" />
    <area id="im-g1a5" linkends="visualdict-tab" coords="581,28,625,71" />
    <area id="im-g1a6" linkends="visualdict-tab" coords="172,112,632,135" />
    <area id="im-g1a7" linkends="visualdict-icon-list" coords="5,58,171,495" />
</areaspec>
<imageobject><imagedata fileref="visualdict-gui1.png" format="PNG"/></imageobject>
</imageobjectco>
</mediaobjectco>
</screenshot>

<para>This screenshot, from the &systemsettings; Formats panel,
shows some &GUI; elements.  Click on part of the window to learn more about it.</para>

<orderedlist>

<listitem><para>
An <emphasis role="bold"><link linkend="visualdict-icon-list">Icon List</link></emphasis>
(the second item is selected)
</para></listitem>

<listitem><para>
An open 
<emphasis role="bold"><link linkend="visualdict-drop-down-box">Drop Down Box</link></emphasis>
</para></listitem>

<listitem><para>
An item in the <link linkend="visualdict-drop-down-box">Drop Down Box</link> that
has been selected
</para>
</listitem>

<listitem><para>
Some more <emphasis role="bold"><link linkend="visualdict-button">Buttons</link></emphasis>
</para></listitem>

</orderedlist>

<screenshot>
<screeninfo>Some More &GUI; Elements</screeninfo>
<mediaobjectco>
<imageobjectco>
<areaspec units="other" otherunits="imagemap">
    <area id="im-gui2a1" linkends="visualdict-menu-button" coords="306,451,349,493" />
    <area id="im-gui2a2" linkends="visualdict-menu-button" coords="172,405,298,538" />
    <area id="im-gui2a3" linkends="visualdict-spin-box" coords="522,204,638,253" />
    <area id="im-gui2a4" linkends="visualdict-check-box" coords="425,98,467,162" />
    <area id="im-gui2a5" linkends="visualdict-tree-view" coords="368,63,411,100" />
    <area id="im-gui2a6" linkends="visualdict-tree-view" coords="164,101,424,403" />
</areaspec>
<imageobject><imagedata fileref="visualdict-gui2.png" format="PNG"/></imageobject>
</imageobjectco>
</mediaobjectco>
</screenshot>

<para>This screenshot, from the &systemsettings; Custom Shortcuts panel,
shows some more &GUI; elements.</para>

<orderedlist>

<listitem><para>
A <emphasis role="bold"><link linkend="visualdict-tree-view">Tree View</link></emphasis>
</para></listitem>

<listitem><para>
A <emphasis role="bold"><link linkend="visualdict-check-box">Check Box</link></emphasis>
that has been selected
</para></listitem>

<listitem><para>
A pair of <emphasis role="bold"><link linkend="visualdict-spin-box">Spin Boxes</link></emphasis>
</para></listitem>

<listitem><para>
A <emphasis role="bold"><link linkend="visualdict-menu-button">Menu Button</link></emphasis>
</para></listitem>

</orderedlist>

<screenshot>
<screeninfo>Even More &GUI; Elements</screeninfo>
<mediaobjectco>
<imageobjectco>
<areaspec units="other" otherunits="imagemap">
    <area id="im-gui3a1" linkends="visualdict-text-box" coords="562,235,603,252" />
    <area id="im-gui3a2" linkends="visualdict-text-box" coords="214,253,767,280" />
    <area id="im-gui3a3" linkends="visualdict-radio-button" coords="187,193,468,252" />
    <area id="im-gui3a4" linkends="visualdict-list-box" coords="8,101,185,547" />
</areaspec>
<imageobject><imagedata fileref="visualdict-gui3.png" format="PNG"/></imageobject>
</imageobjectco>
</mediaobjectco>
</screenshot>

<para>This screenshot, from the &systemsettings; Default Applications panel,
shows even more &GUI; elements.  Click on part of the window to learn more about 
it.</para>

<orderedlist>

<listitem><para>
A <emphasis role="bold"><link linkend="visualdict-list-box">List Box</link></emphasis>
</para></listitem>

<listitem><para>
A pair of <emphasis role="bold"><link linkend="visualdict-radio-button">Radio Buttons</link></emphasis>
</para></listitem>

<listitem><para>
A <emphasis role="bold"><link linkend="visualdict-text-box">Text Box</link></emphasis>
</para></listitem>

</orderedlist>

<screenshot>
<screeninfo>Some Combo Boxes</screeninfo>
<mediaobjectco>
<imageobjectco>
<areaspec units="other" otherunits="imagemap">
    <area id="im-gui4a1" linkends="visualdict-combo-box" coords="268,128,722,288" />
</areaspec>
<imageobject><imagedata fileref="visualdict-gui4.png" format="PNG"/></imageobject>
</imageobjectco>
</mediaobjectco>
</screenshot>

<para>Finally, this screenshot, from the &systemsettings; Colors panel, shows five
<emphasis role="bold"><link linkend="visualdict-tab">Tabs</link></emphasis>
</para>

</sect3>

</sect2>

<sect2 id="visualdict-widgets">
<title>The Widgets</title>

<informaltable>
<tgroup cols="3">
<colspec colnum="1" align="left"/>
<colspec colnum="3" align="center"/>

<thead>
<row>
<entry align="center">Name</entry>
<entry>Description</entry>
<entry>Screenshot</entry>
</row>
</thead>

<tbody valign="top">

<!--I'm using the name QMainWindow uses for these, but perhaps there's a more
    regular-user friendly term?-->
<row id="visualdict-central-widget">
<entry>Central Widget</entry>
<entry>The main area of the running application.  This might be the document
you are editing in a word processor or the board of a game like Chess.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-central-widget.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-button">
<entry>Button</entry>
<entry>These can be clicked with the &LMB; to perform an action.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-button.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-breadcrumb">
<entry>Breadcrumb</entry>
<entry>Shows the path in a hierarchical system, such as a filesystem.  Click on
any part of the path to go up in the tree to that location.  Click on the arrow
to the right of part of the path to go to another child element of that path.
</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-breadcrumb.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-check-box">
<entry>Check Box</entry>
<entry>These can be clicked to select and unselect items.  They are typically
used in a list of several selections.  Selected items typically display a check
mark, whereas unselected items will have an empty box.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-check-box.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-color-selector">
<entry>Color Selector</entry>
<entry>This allows a color to be selected for various purposes, such as changing
the color of text.  For more information, see <xref linkend="colors"/></entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-color-selector.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-combo-box">
<entry>Combo Box</entry>
<entry>A combination of a 
<link linkend="visualdict-drop-down-box">Drop Down Box</link> and a
<link linkend="visualdict-text-box">Text Box</link>.  You can select an option
from the list, or type in the text box.  Some combo boxes may automatically
complete entries for you, or open the list with a list of choices that match
what you have typed.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-combo-box.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-context-menu">
<entry>Context Menu</entry>
<entry>Many user interface elements in the &plasma; Workspace and in Applications contain a context menu,
which can be opened by clicking on something with the &RMB;.  This menu contains
options and actions that usually affect the user interface element that was
right-clicked.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-context-menu.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-dialog-box">
<entry>Dialog Box</entry>
<entry>A small window that appears above a larger application window.  It may
contain a message, warning, or configuration panel, among others.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-dialog-box.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-drop-down-box">
<entry>Drop Down Box</entry>
<entry>This provides a list of items, from which you may select one.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-drop-down-box.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-icon">
<entry>Icon</entry>
<entry>A graphical representation of something, such as a file or action.  They
typically, but not always, also contain a text description, either beneath or
to the right of the icon.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-icon.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-icon-list">
<entry>Icon List</entry>
<entry>This provides a list of items represented by an 
<link linkend="visualdict-icon">Icon</link> and a description. It is typically 
used in the left panel of configuration panels to allow selection from various 
types of configuration categories.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-icon-list.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-list-box">
<entry>List Box</entry>
<entry>This is a list of items that typically allows multiple items to be
selected.  To select a group of contiguous items, press the &Shift; key and
click the first and last items.  To select multiple items that are not
contiguous, press the &Ctrl; key and select the desired items.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-list-box.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-menu">
<entry>Menu</entry>
<entry>A list of selections, that usually perform an action, set an option, or
opens a window.  These can be opened from 
<link linkend="visualdict-menubar">menubars</link> or 
<link linkend="visualdict-menu-button">menu buttons</link>.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-menu.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-menubar">
<entry>Menubar</entry>
<entry>These are located at the top of nearly every window and provide access
to all the functions of the running application.  For more information, see
<xref linkend="menus"/>.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-menubar.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-menu-button">
<entry>Menu Button</entry>
<entry>A special type of <link linkend="visualdict-button">button</link> that
opens a <link linkend="visualdict-menu">menu</link>.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-menu-button.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-panel">
<entry>Panel <emphasis>or</emphasis> Sidebar <emphasis>or</emphasis> Tool View</entry>
<entry>These are located on the sides or bottom of the
<link linkend="visualdict-central-widget">central widget</link> and allow
you to perform many different tasks in an application.  A text editor might
provide a list of open documents in one, while a word processor might allow you
to select a clip art image.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-panel.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-progress-bar">
<entry>Progress Bar</entry>
<entry>A small bar that indicates that a long-running operation is being
performed.  The bar may indicate how much of the operation has completed, or it
may simply bounce back and forth to indicate that the operation is in progress.
</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-progress-bar.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-radio-button">
<entry>Radio Button</entry>
<entry>These are used in a list of options, and only permit one of the options in
the list to be selected.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-radio-button.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-scrollbar">
<entry>Scrollbar</entry>
<entry>Allows you to navigate a document.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-scrollbar.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-slider">
<entry>Slider</entry>
<entry>Allows a numeric value to be selected by moving a small bar either
horizontally or vertically across a line.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-slider.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-spin-box">
<entry>Spin Box</entry>
<entry>This permits a numerical value to be selected, either by using the up and
down arrows to the right of the box to raise or lower the value, respectively,
or by typing the value into the 
<link linkend="visualdict-text-box">text box</link>.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-spin-box.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-statusbar">
<entry>Status Bar</entry>
<entry>These are located at the bottom of many applications and display
information about what the application is currently doing.  For instance, a web
browser might indicate the progress of loading a web page, while a
word processor might display the current word count.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-statusbar.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-tab">
<entry>Tab</entry>
<entry>These appear at the top of an area of a window, and permit that area of
the window to be changed to a variety of different selections.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-tab.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-text-area">
<entry>Text Area</entry>
<entry>Allows a large amount of text to be typed in, typically multiple lines or
paragraphs.  Unlike a <link linkend="visualdict-text-box">Text Box</link>, 
pressing &Enter; will usually result in a line break.
</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-text-area.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-text-box">
<entry>Text Box</entry>
<entry>A single-line text entry that allows a small amount of text to be typed 
in.  Typically, pressing &Enter; will perform the same action as clicking the 
<guibutton>OK</guibutton> button.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-text-box.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-titlebar">
<entry>Titlebar</entry>
<entry>This is located at the top of every window.  It contains the name of the
application and usually information about what the application is doing, like
the title of the web page being viewed in a web browser or the filename of a
document open in a word processor.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-titlebar.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-toolbar">
<entry>Toolbar</entry>
<entry>These are located near the top of many applications, typically directly
underneath the <link linkend="visualdict-menubar">menu bar</link>.  They
provide access to many common functions of the running application, like
<emphasis>Save</emphasis> or <emphasis>Print</emphasis>.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-toolbar.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

<row id="visualdict-tree-view">
<entry>Tree View</entry>
<entry>A Tree View allows you to select from a hierarchical list of options. A
section, or category, of the Tree View may be unexpanded, in which case no
options will appear beneath it and the arrow to the left of the title will be
pointing right, toward the title.  It may also be expanded, in which case several
options will be listed below it, and the arrow to the left of the title will be
pointing down, toward the options.  To expand a portion of the tree view, click
the arrow to the left of the title of the section you wish to expand, 
double-click on the title, or select the title using your keyboard's arrow keys
and press the &Enter; or <keycap>+</keycap> key.  To minimize a portion of the
tree view, you may also click the arrow, double-click on the title, or press the
&Enter; or <keycap>-</keycap> key.</entry>
<entry>
<inlinemediaobject>
<imageobject>
<imagedata fileref="visualdict-tree-view.png" format="PNG"/>
</imageobject>
</inlinemediaobject>
</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</sect2>

</sect1>

<sect1 id="menus">
<sect1info>
<authorgroup>
<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</sect1info>

<title>Common Menus</title>

<para>Many &kde; applications contain these menus.  However, most
applications will have more menu entries than those listed here, and others may
be missing some of the entries listed here.</para>

<screenshot id="screenshot-menus">
<screeninfo>A Menu Bar</screeninfo>
<mediaobject>
<imageobject><imagedata fileref="menus.png" format="PNG"/></imageobject>
<textobject><phrase>A menubar</phrase></textobject>
<caption><para>The menubar in
<ulink url="https://www.kde.org/applications/graphics/gwenview/">&gwenview;</ulink>.
</para></caption>
</mediaobject>
</screenshot>

<para>Some applications, like &dolphin;, do not show a menubar by default.  You
can show it by pressing <keycombo>&Ctrl;<keycap>M</keycap></keycombo>.  You can
also use this to hide the menubar in applications that support doing so.</para>

<sect2 id="menus-file">
<title>The File Menu</title>
<para>The <guimenu>File</guimenu> menu allows you to perform operations on the
currently open file and access common tasks in applications.</para>

<para>Common menu items include:</para>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></shortcut>
<guimenu>File</guimenu><guimenuitem>New</guimenuitem>
</menuchoice></term>
<listitem><para>
Creates a new file.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu><guimenuitem>New Window</guimenuitem>
</menuchoice></term>
<listitem><para>
Opens a new window.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>O</keycap></keycombo></shortcut>
<guimenu>File</guimenu><guimenuitem>Open...</guimenuitem>
</menuchoice></term>
<listitem><para>
Opens an already existing file.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></shortcut>
<guimenu>File</guimenu><guimenuitem>Save</guimenuitem>
</menuchoice></term>
<listitem><para>
Saves the file. If the file already exists it will be overwritten.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu><guimenuitem>Save As...</guimenuitem>
</menuchoice></term>
<listitem><para>
  Saves the file with a new filename. 
  <!--FIXME some apps allow to save in a different format by changing the Filter (gwenview) or encoding (kate) -->
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu><guimenuitem>Save All</guimenuitem>
</menuchoice></term>
<listitem><para>
Saves all open files.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>F5</keycap></shortcut>
<guimenu>File</guimenu><guimenuitem>Reload</guimenuitem>
</menuchoice></term>
<listitem><para>
Reloads the current file.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu><guimenuitem>Reload All</guimenuitem>
</menuchoice></term>
<listitem><para>
Reloads all open files.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></shortcut>
<guimenu>File</guimenu><guimenuitem>Print...</guimenuitem>
</menuchoice></term>
<listitem><para>
Prints the file. Use <guilabel>Print to File (PDF)</guilabel> to generate a &PDF; file
or select a range of pages to print only these pages to a new &PDF; file
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></shortcut>
<guimenu>File</guimenu><guimenuitem>Close</guimenuitem>
</menuchoice></term>
<listitem><para>
Closes the current file.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>File</guimenu><guimenuitem>Close All</guimenuitem>
</menuchoice></term>
<listitem><para>
Closes all open files.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></shortcut>
<guimenu>File</guimenu><guimenuitem>Quit</guimenuitem>
</menuchoice></term>
<listitem><para>
Exits the program.
</para></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="menus-edit">
<title>The Edit Menu</title>
<para>The <guimenu>Edit</guimenu> menu allows you to modify the currently
open file.</para>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Undo</guimenuitem>
</menuchoice></term>
<listitem><para>
Undo the last action you performed in the file.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Redo</guimenuitem>
</menuchoice></term>
<listitem><para>
Redo the last action you performed in the file.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Cut</guimenuitem>
</menuchoice></term>
<listitem><para>
Removes the currently selected portion of the file, if any, and places a copy of
it in the clipboard buffer.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Copy</guimenuitem>
</menuchoice></term>
<listitem><para>
Places a copy of the currently selected portion of the file, if any, in the
clipboard buffer.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Paste</guimenuitem>
</menuchoice></term>
<listitem><para>
Copies the first item in the clipboard buffer to the current location in the
file, if any.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Select All</guimenuitem>
</menuchoice></term>
<listitem><para>
Selects the entire contents of the currently open file.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Find...</guimenuitem>
</menuchoice></term>
<listitem><para>
Allows you to search for text in the currently open file.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Replace...</guimenuitem>
</menuchoice></term>
<listitem><para>
Allows you to search for text in the currently open file and replace it with
something else.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycap>F3</keycap></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Find Next</guimenuitem>
</menuchoice></term>
<listitem><para>
Go to the next match of the last Find operation.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Shift;<keycap>F3</keycap></keycombo></shortcut>
<guimenu>Edit</guimenu><guimenuitem>Find Previous</guimenuitem>
</menuchoice></term>
<listitem><para>
Go to the previous match of the last Find operation.
</para></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="menus-view">
<title>The View Menu</title>
<para>The <guimenu>View</guimenu> menu allows you to change the layout of the
currently open file and/or the running application.</para>

<para>This menu has different options depending on the application you are
using.</para>
</sect2>

<sect2 id="menus-tools">
<title>The Tools Menu</title>
<para>The <guimenu>Tools</guimenu> menu allows you to perform certain actions
on the currently open file.</para>

<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut><keycombo action="simul">&Ctrl;&Shift;<keycap>O</keycap></keycombo></shortcut>
<guimenu>Tools</guimenu><guimenuitem>Automatic Spell Checking</guimenuitem>
</menuchoice></term>
<listitem><para>
Check for spelling errors as you type.  For more information, see
<xref linkend="spellcheck-auto"/>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Spelling...</guimenuitem>
</menuchoice></term>
<listitem><para>
This initiates the spellchecking program - a program designed to help the user
catch and correct any spelling errors.  For more information, see
<xref linkend="spellcheck-check"/>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Spelling (from cursor)...</guimenuitem>
</menuchoice></term>
<listitem><para>
This initiates the spellchecking program, but only checks the portion of the
document from the current location of the cursor to the end.  For more information,
see <xref linkend="spellcheck-check"/>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Spellcheck Selection...</guimenuitem>
</menuchoice></term>
<listitem><para>
This initiates the spellchecking program, but only checks the currently selected
text in the document.  For more information, see <xref linkend="spellcheck-check"/>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Tools</guimenu><guimenuitem>Change Dictionary...</guimenuitem>
</menuchoice></term>
<listitem><para>
This allows you to change the dictionary used to check spellings.  For more
information, see <xref linkend="spellcheck-config"/>.
</para></listitem>
</varlistentry>

</variablelist>

</sect2>
<!--FIXME add bookmarks menu ?-->
<sect2 id="menus-settings">
<title>The Settings Menu</title>
<para>The <guimenu>Settings</guimenu> allows you to customize the application.</para>

<para>This menu typically contains the following items:</para>
<variablelist>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo>
</shortcut>
<guimenu>Settings</guimenu>
<guimenuitem>Show Menubar</guimenuitem>
</menuchoice></term>
<listitem><para>
<action>Toggle the Menubar display</action> on and off. Once
hidden it can be made visible using the shortcut
<keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo> again.
If the menubar is hidden, the context menu opened with a right mouse button
click anywhere in the view area has an extra entry <guimenuitem>Show Menubar</guimenuitem>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu>
<guimenuitem>Show Statusbar</guimenuitem>
</menuchoice></term>
<listitem>
<para>
Toggles the display of the statusbar on and off. Some &kde; applications use statusbar at the bottom of their screen to display useful information. 
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guisubmenu>Toolbars Shown</guisubmenu>
</menuchoice></term>
<listitem><para>
Allows you to show and hide the various toolbars supported by the application.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Show
Statusbar</guimenuitem></menuchoice></term>
<listitem>
<para>When checked, this displays a small bar at the bottom of the application
containing information about the status. When unchecked
the status bar is hidden.</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure Shortcuts...</guimenuitem>
</menuchoice></term>
<listitem><para>
Allows you to enable, disable, and modify keyboard shortcuts.  For more
information, see <xref linkend="shortcuts"/>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure Toolbars...</guimenuitem>
</menuchoice></term>
<listitem><para>
Allows you to customize the contents, layout, text, and icons of toolbars.  For
more information, see <xref linkend="toolbars"/>.
</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
Notifications...</guimenuitem></menuchoice></term>
<listitem><para>This item displays a standard &kde; notifications configuration
dialog, where you can change the notifications (sounds, visible messages,
&etc;) used by the application.</para>
<para>For more information how to configure notifications please read the documentation for
the &systemsettings; module <ulink url="help:/kcontrol/kcmnotify/index.html"
>Manage Notifications</ulink>.
</para>
</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Settings</guimenu><guimenuitem>Configure <replaceable>Application</replaceable>...</guimenuitem>
</menuchoice></term>
<listitem><para>
Opens the configuration panel for the currently running application.
</para></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="menus-help">
<title>The Help Menu</title>
<para>The <guimenu>Help</guimenu> menu gives you access to the application's
documentation and other useful resources.</para>

<!--taken from kdelibs.git/kdoctools/customization/en/entities/help-menu.docbook
    and edited slightly to fit into buildingblocks-->
<variablelist>
<varlistentry>
<term>
<menuchoice>
<shortcut>
<keycombo action="simul"><keycap>F1</keycap></keycombo>
</shortcut>
<guimenu>Help</guimenu>
<guimenuitem><replaceable>Application</replaceable> Handbook</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>Invokes the KDE Help system</action> starting at the
running application's handbook.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<shortcut>
<keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo>
</shortcut>
<guimenu>Help</guimenu>
<guimenuitem>What's This?</guimenuitem>
</menuchoice>
</term>
<listitem><para><action>Changes the mouse cursor to a combination arrow and
question mark.</action>  Clicking on items within the application; will open a help
window (if one exists for the particular item) explaining the item's
function.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>Tip of the Day</guimenuitem>
</menuchoice></term>
<listitem>
<para>This command <action>opens the <guilabel>Tip of the Day</guilabel> dialog</action>.
You can page through all the tips by using the buttons on the dialog
and select to show the tips at startup.</para>
<para>Note: Not all applications provide these tips.</para>

</listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>Report Bug...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens the Bug report dialog</action> where you can
report a bug or request a <quote>wishlist</quote> feature.</para></listitem>
</varlistentry>
<!--FIXME two different dialogs, either via web (default if aboutData->bugAddress() == "" or == "submit@bugs.kde.org" ) 
or via email (see krecipes doc rev 1306076)
-->

<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>Donate</guimenuitem>
</menuchoice></term>
<listitem><para>Opens the <ulink url="https://www.kde.org/community/donations">Donations page</ulink>
where you can support &kde; and its projects.</para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>Switch Application Language...</guimenuitem>
</menuchoice></term>
<listitem><para><action>Opens a dialog</action> where you can
edit the <guilabel>Primary language</guilabel> and <guilabel>Fallback language</guilabel>
for this application.</para></listitem>
</varlistentry>
<!--FIXME: which languages are available here? how is that determined?
-->
<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>About <replaceable>Application</replaceable></guimenuitem>
</menuchoice></term>
<listitem><para><action>This will display version and author
information for the running application.</action></para></listitem>
</varlistentry>

<varlistentry>
<term><menuchoice>
<guimenu>Help</guimenu>
<guimenuitem>About KDE</guimenuitem>
</menuchoice></term>
<listitem><para><action>This displays the &kde; Development Platform version
and other basic information.</action></para></listitem>
</varlistentry>
</variablelist>
<!--FIXME Tip of the Day missing-->
</sect2>

<sect2 id="menus-ack">
<title>Thanks and Acknowledgments</title>

<para>Special thanks to an anonymous Google Code-In 2011 participant for writing
much of this documentation.</para>

</sect2>

</sect1>

<sect1 id="kbd">
<sect1info>
<authorgroup>
<author>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</sect1info>

<title>Common Keyboard Shortcuts</title>

<para>The &plasma-workspaces; provide keyboard shortcuts that allow you to
perform many tasks without touching your mouse.  If you use your keyboard
frequently, using these can save you lots of time.</para>

<para>This list contains the most common shortcuts supported by the workspace
itself and many applications available within.  Every application also provides
its own shortcuts, so be sure to check their manuals for a comprehensive
listing.</para>

<note><para>
The <keysym>Meta</keysym> key described below is a generic name for
the custom key found on many different keyboards. On keyboards
designed for &Microsoft; &Windows;, this key is usually called the
<keysym>Windows</keysym> key, and will have a picture of the &Windows;
logo.  On keyboards designed for &Mac; computers, this key is known as
the <keysym>Command</keysym> key and will have a picture of the
<trademark class="registered">Apple</trademark> logo and/or the
<keycap>⌘</keycap> symbol.  On keyboards designed for &UNIX; systems, this key
is really known as the <keysym>Meta</keysym> key and is typically labeled with a
diamond: <keycap>◆</keycap>.
</para></note>

<sect2 id="kbd-windows">
<title>Working with Windows</title>

<para>These shortcuts allow you to perform all kinds of operations with windows,
whether it be opening, closing, moving, or switching between them.</para>

<sect3 id="kbd-windows-start-stop">
<title>Starting and Stopping Applications</title>

<para>These shortcuts make it easy to start and stop programs.</para>

<informaltable>
<tgroup cols="2">

<thead>
<row>
<entry>Shortcut</entry>
<entry>Description</entry>
</row>
</thead>

<tbody>

<row>
<entry><keysym>Meta</keysym></entry>
<entry>Open the Application Launcher</entry>
</row>

<row>
<entry><keycombo action="simul">&Alt;<keycap>Space</keycap></keycombo> / <keycombo action="simul">&Alt;<keycap>F2</keycap></keycombo></entry>
<entry><ulink url="help:/plasma-desktop/krunner.html">Run Command Interface</ulink></entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>Esc</keycap></keycombo></entry>
<entry>System Activity</entry>
</row>

<row>
<entry><keycombo action="simul">&Alt;<keycap>F4</keycap></keycombo></entry>
<entry>Close</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo></entry>
<entry>Quit</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;&Alt;&Esc;</keycombo></entry>
<entry>Force Quit</entry>
</row>

</tbody>
</tgroup>
</informaltable>
</sect3>

<sect3 id="kbd-windows-moving">
<title>Moving Around</title>

<para>These shortcuts allow you to navigate between windows, activities, and
desktops efficiently.</para>

<informaltable>
<tgroup cols="2">

<thead>
<row>
<entry>Shortcut</entry>
<entry>Description</entry>
</row>
</thead>

<tbody>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>F10</keycap></keycombo></entry><!--[kwin][Global Shortcuts] ExposeAll=Ctrl+F10; Launch (C) -->
<entry>Present Windows</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>F9</keycap></keycombo></entry><!--[kwin][Global Shortcuts] Expose=Ctrl+F9 -->
<entry>Present Windows on current desktop</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>F7</keycap></keycombo></entry><!--[kwin][Global Shortcuts] ExposeClass=Ctrl+F7 -->
<entry>Present Windows of current application only</entry>
</row>
<!--FIXME not in 5.6.4
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>F11</keycap></keycombo></entry>
<entry>Desktop Cube</entry>
</row>
-->
<row>
<entry><keycombo action="simul">&Ctrl;<keycap>F12</keycap></keycombo></entry><!--[plasmashell][Global Shortcuts] show dashboard=Ctrl+F12-->
<entry>Show Desktop</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;&Alt;<keycap>A</keycap></keycombo></entry><!--[kwin][Global Shortcuts] Activate Window Demanding Attention=Ctrl+Alt+A -->
<entry>Activate Window Demanding Attention</entry>
</row>

<row>
<entry><keycombo action="simul">&Alt;&Tab;</keycombo></entry><!--[kwin][Global Shortcuts] Walk Through Windows=Alt+Tab-->
<entry>Walk through windows</entry>
</row>

<row>
<entry><keycombo action="simul">&Alt;&Shift;&Tab;</keycombo></entry><!--[kwin][Global Shortcuts] Walk Through Windows (Reverse)=Alt+Shift+Backtab-->
<entry>Walk through windows (Reverse)</entry>
</row>

<row>
<entry><keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo></entry><!--FIXME source ?-->
<entry>Open the Window Operations menu</entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;&Alt;<keysym>Up</keysym></keycombo></entry><!--[kwin][Global Shortcuts] Switch Window Up=Meta+Alt+Up-->
<entry>Switch to Window Above</entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;&Alt;<keysym>Down</keysym></keycombo></entry><!--[kwin][Global Shortcuts] Switch Window Down=Meta+Alt+Down-->
<entry>Switch to Window Below</entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;&Alt;<keysym>Left</keysym></keycombo></entry><!--[kwin][Global Shortcuts] Switch Window Left=Meta+Alt+Left-->
<entry>Switch to Window to the Left</entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;&Alt;<keysym>Right</keysym></keycombo></entry><!--[kwin][Global Shortcuts] Switch Window Right=Meta+Alt+Right-->
<entry>Switch to Window to the Right</entry>
</row>

</tbody>
</tgroup>
</informaltable>
</sect3>

<sect3 id="kbd-activity-pan-zoom">
<title>Panning and Zooming</title><!--FIXME nothing works for me-->

<para>Need to get a closer look?  The &plasma-workspaces; allow you to zoom in
and out and move your entire desktop around, so you can zoom in even when the
application you are using doesn't support it.</para>

<informaltable>
<tgroup cols="2">

<thead>
<row>
<entry>Shortcut</entry>
<entry>Description</entry>
</row>
</thead>

<tbody>

<!--
<row>
<entry><keycombo action="simul">&Meta;<keycap></keycap></keycombo></entry>
<entry></entry>
</row>
-->

<row>
<entry><keycombo action="simul">&Meta;<keycap>=</keycap></keycombo></entry><!--[kwin][Global Shortcuts] view_zoom_in=Meta+= -->
<entry>Zoom In</entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;<keycap>-</keycap></keycombo></entry><!--[kwin][Global Shortcuts] view_zoom_out=Meta+- -->
<entry>Zoom Out</entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;<keycap>0</keycap></keycombo></entry><!--[kwin][Global Shortcuts] view_actual_size=Meta+0 -->
<entry>Zoom Normal</entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;<keysym>Up</keysym></keycombo></entry><!--[kwin][Global Shortcuts] MoveZoomUp=Meta+Up -->
<entry>Pan Up</entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;<keysym>Down</keysym></keycombo></entry><!--[kwin][Global Shortcuts] MoveZoomDown=Meta+Down -->
<entry>Pan Down</entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;<keysym>Left</keysym></keycombo></entry><!--[kwin][Global Shortcuts] MoveZoomLeft=Meta+Left -->
<entry>Pan left, move window to monitor to the left<footnote id="fn1"><para>In a multi-monitor environment</para></footnote></entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;<keysym>Right</keysym></keycombo></entry><!--[kwin][Global Shortcuts] MoveZoomRight=Meta+Right -->
<entry>Pan right, move window to monitor to the right<footnoteref linkend="fn1"/></entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;<keysym>PgUp</keysym></keycombo></entry>
<entry>Maximize/Restore window</entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;<keysym>PgDn</keysym></keycombo></entry>
<entry>Minimize window</entry>
</row>

</tbody>
</tgroup>
</informaltable>
</sect3>
</sect2>

<sect2 id="kbd-activities">
<title>Working with Activities and Virtual Desktops</title>

<para>These shortcuts allow you to switch between and manage
<ulink url="help:/plasma-desktop/activities-interface.html">Activities</ulink>
and <ulink url="help:/kcontrol/desktop/">virtual desktops</ulink>.</para>

<informaltable>
<tgroup cols="2">

<thead>
<row>
<entry>Shortcut</entry>
<entry>Description</entry>
</row>
</thead>

<tbody>

<row>
<entry><keycombo action="simul">&Meta;<keycap>Q</keycap></keycombo> /<!-- [plasmashell][Global Shortcuts] manage activities=Meta+Q -->
<keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>,<keycombo action="simul">&Alt;<keycap>A</keycap></keycombo><!--FIXME source ?-->
</entry>
<entry>Manage Activities</entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;&Tab;</keycombo></entry><!-- [plasmashell][Global Shortcuts] next activity=Meta+Tab -->
<entry>Next Activity</entry>
</row>

<row>
<entry><keycombo action="simul">&Meta;&Shift;&Tab;</keycombo></entry><!-- [plasmashell][Global Shortcuts] previous activity=Meta+Shift+Tab -->
<entry>Previous Activity</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>F1</keycap></keycombo></entry><!--[kwin][Global Shortcuts] Switch to Desktop 1=Ctrl+F1 -->
<entry>Switch to Desktop 1</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>F2</keycap></keycombo></entry><!--[kwin][Global Shortcuts] Switch to Desktop 2=Ctrl+F2 -->
<entry>Switch to Desktop 2</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>F3</keycap></keycombo></entry><!--[kwin][Global Shortcuts] Switch to Desktop 2=Ctrl+F3 -->
<entry>Switch to Desktop 3</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>F4</keycap></keycombo></entry><!--[kwin][Global Shortcuts] Switch to Desktop 2=Ctrl+F4 -->
<entry>Switch to Desktop 4</entry>
</row>

</tbody>
</tgroup>
</informaltable>
</sect2>

<sect2 id="kbd-desktop">
<title>Working with the Desktop</title>

<para>These shortcuts allow you to work with the &plasma-desktop; and panels.
</para>

<informaltable>
<tgroup cols="2">

<thead>
<row>
<entry>Shortcut</entry>
<entry>Description</entry>
</row>
</thead>

<tbody>

<row>
<entry><keycombo action="seq">
<keycombo action="simul">&Alt;<keycap>D</keycap></keycombo><!--plasma-framework/src/plasma/private/containment_p.cpp-->
<keycap>A</keycap>
</keycombo></entry>
<entry>Add Widgets</entry>
</row>

<row>
<entry><keycombo action="seq">
<keycombo action="simul">&Alt;<keycap>D</keycap></keycombo><!--FIXME source ?-->
<keycap>R</keycap>
</keycombo></entry>
<entry>Remove this <replaceable>Widget</replaceable></entry>
</row>

<row>
<entry><keycombo action="seq">
<keycombo action="simul">&Alt;<keycap>D</keycap></keycombo><!--FIXME source ?-->
<keycap>L</keycap>
</keycombo></entry>
<entry>Lock/Unlock Widgets</entry>
</row>
<!--FIXME source ? No >Next Widget< nor >Previous Widget< in kde-workspace or frameworks code
<row>
<entry><keycombo action="seq">
<keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>
<keycap>N</keycap>
</keycombo></entry>
<entry>Next Widget</entry>
</row>

<row>
<entry><keycombo action="seq">
<keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>
<keycap>P</keycap>
</keycombo></entry>
<entry>Previous Widget</entry>
</row>
-->
<row>
<entry><keycombo action="seq">
<keycombo action="simul">&Alt;<keycap>D</keycap></keycombo><!--FIXME source ?-->
<keycap>S</keycap>
</keycombo></entry>
<entry><replaceable>Widget</replaceable> Settings</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>F12</keycap></keycombo></entry><!--[plasmashell][Global Shortcuts] show dashboard=Ctrl+F12-->
<entry>Show Desktop</entry>
</row>

<row>
<entry><keycombo action="seq">
<keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>
<keycap>T</keycap>
</keycombo></entry>
<entry>Run the Associated Application</entry>
</row>
<!--FIXME obsolete?
<row>
<entry><keycombo action="simul">&Alt;&Shift;<keycap>F12</keycap></keycombo></entry>
<entry>Enable/Disable Desktop Effects</entry>
</row>
-->

<row>
<entry><keycombo action="simul">&Alt;<keycap>D</keycap></keycombo>,<keycombo action="simul">&Alt;<keycap>S</keycap></keycombo><!--FIXME source ?-->
</entry>
<entry>Desktop Settings</entry>
</row>

</tbody>
</tgroup>
</informaltable>

</sect2>

<sect2 id="kbd-help">
<title>Getting Help</title>

<para>Need some help?  The manual for the current application is only a keypress
away, and some programs even have additional help that explains the element in
focus.</para>

<informaltable>
<tgroup cols="2">

<thead>
<row>
<entry>Shortcut</entry>
<entry>Description</entry>
</row>
</thead>

<tbody>

<row>
<entry><keycap>F1</keycap></entry>
<entry>Help</entry>
</row>

<row>
<entry><keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo></entry>
<entry>What's This?</entry>
</row>

</tbody>
</tgroup>
</informaltable>
</sect2>

<sect2 id="kbd-docs">
<title>Working with Documents</title>

<para>Whether it's a text document, spreadsheet, or web site, these shortcuts
make performing many kinds of tasks with them easy.</para>

<informaltable>
<tgroup cols="2">

<thead>
<row>
<entry>Shortcut</entry>
<entry>Description</entry>
</row>
</thead>

<tbody>

<row>
<entry><keycap>F5</keycap></entry>
<entry>Refresh</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></entry>
<entry>Select All</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></entry>
<entry>Undo</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></entry>
<entry>Redo</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></entry>
<entry>Cut</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></entry>
<entry>Copy</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></entry>
<entry>Paste</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></entry>
<entry>New</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>P</keycap></keycombo></entry>
<entry>Print</entry>
</row>


<row>
<entry><keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo></entry>
<entry>Save</entry>
</row>


<row>
<entry><keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo></entry>
<entry>Find</entry>
</row>


<row>
<entry><keycombo action="simul">&Ctrl;<keycap>W</keycap></keycombo></entry>
<entry>Close Document/Tab</entry>
</row>

</tbody>
</tgroup>
</informaltable>
</sect2>

<sect2 id="kbd-files">
<title>Working with Files</title>

<para>Whether you are in an Open/Save dialog or the &dolphin; file manager, these
shortcuts save you time when performing operations on files.  Note that some of
the concepts used with files are the same as with documents, so several of the
shortcuts are identical to their counterparts listed above.</para>

<informaltable>
<tgroup cols="2">

<thead>
<row>
<entry>Shortcut</entry>
<entry>Description</entry>
</row>
</thead>

<tbody>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>Z</keycap></keycombo></entry>
<entry>Undo</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>X</keycap></keycombo></entry>
<entry>Cut</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>C</keycap></keycombo></entry>
<entry>Copy</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>V</keycap></keycombo></entry>
<entry>Paste</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>A</keycap></keycombo></entry>
<entry>Select All</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></entry>
<entry>Replace Location</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo></entry>
<entry>Invert Selection</entry>
</row>

<row>
<entry><keycombo action="simul">&Alt;<keycap>Left</keycap></keycombo></entry>
<entry>Back</entry>
</row>

<row>
<entry><keycombo action="simul">&Alt;<keycap>Right</keycap></keycombo></entry>
<entry>Forward</entry>
</row>

<row>
<entry><keycombo action="simul">&Alt;<keycap>Up</keycap></keycombo></entry>
<entry>Up (to folder that contains this one)</entry>
</row>

<row>
<entry><keycombo action="simul">&Alt;<keycap>Home</keycap></keycombo></entry>
<entry>Home Folder</entry>
</row>

<row>
<entry><keycap>Delete</keycap></entry>
<entry>Move to Trash</entry>
</row>

<row>
<entry><keycombo action="simul">&Shift;<keycap>Delete</keycap></keycombo></entry>
<entry>Delete Permanently</entry>
</row>

</tbody>
</tgroup>
</informaltable>
</sect2>

<sect2 id="kbd-vol-bright">
<title>Changing Volume and Brightness</title>

<para>In addition to the standard keys, many computer keyboards and laptops
nowadays have special keys or buttons to change the speaker volume, as well as
the brightness of your monitor if applicable.  If present, you can use these
keys in the &plasma-workspaces; to perform those tasks.</para>

<para>If you do not have such keys, see <xref linkend="kbd-modifying"/> for
information on how to assign keys for these tasks.</para>

</sect2>

<sect2 id="kbd-leaving">
<title>Leaving Your Computer</title>

<para>All done?  Use these shortcuts and put your computer away!</para>

<informaltable>
<tgroup cols="2">

<thead>
<row>
<entry>Shortcut</entry>
<entry>Description</entry>
</row>
</thead>

<tbody>
<!--FIXME obsolete?
<row>
<entry><keycombo action="simul">&Ctrl;&Alt;<keycap>Insert</keycap></keycombo></entry>
<entry>Switch User</entry>
</row>
-->
<row>
<entry><keycombo action="simul">&Ctrl;&Alt;<keycap>L</keycap></keycombo></entry><!--workspace/kscreenlocker/ksmserver/server.cpp-->
<entry>Lock Screen</entry>
</row>

<row>
<entry><keycombo action="simul">&Ctrl;&Alt;<keycap>Del</keycap></keycombo></entry><!--plasma-workspace/ksmserver/server.cpp-->
<entry>Leave</entry>
</row>

</tbody>
</tgroup>
</informaltable>
</sect2>

<sect2 id="kbd-modifying">
<title>Modifying Shortcuts</title>

<para>The shortcuts described in <link linkend="kbd-windows">Working With
Windows</link>, <link linkend="kbd-leaving">Leaving Your Computer</link>,
<link linkend="kbd-vol-bright">Changing Volume and Brightness</link> and
<link linkend="kbd-activities">Working with
Activities and Virtual Desktops</link> are called
<emphasis>global shortcuts</emphasis>, since they work regardless of which
window you have open on your screen.  These can be modified in the
<ulink url="help:/kcontrol/keys/">Global Shortcuts panel of
&systemsettings;</ulink>, where they are separated by &kde; component.</para>

<para>The shortcuts described <link linkend="kbd-desktop">Working
with the Desktop</link> are immutable and cannot be modified.</para>

<para>The shortcuts described in <link linkend="kbd-docs">Working with
Documents</link> and <link linkend="kbd-help">Getting Help</link> are set by
individual programs.  Most &kde; programs allow you to use the
<link linkend="shortcuts">common shortcut editing dialog</link> to modify these.
The shortcuts described in <link linkend="kbd-files">Working With Files</link>
can be edited in the same manner when used inside a file manager like &dolphin;
or &konqueror;, but cannot be modified in the case of Open/Save dialogs, &etc;
</para>

</sect2>
</sect1>

</chapter>
