[kde-doc-english] [khelpcenter] doc/fundamentals: provide a Visual Dictionary of GUI elements

Aleix Pol aleixpol at kde.org
Thu Apr 17 15:20:29 UTC 2014 

Git commit 624eefe8591f45043dc60f4b1061ee8c881234f4 by Aleix Pol, on behalf of T.C. Hollingsworth.
Committed on 03/07/2013 at 12:46.
Pushed by apol into branch 'master'.

provide a Visual Dictionary of GUI elements

M  +746  -2    doc/fundamentals/ui.docbook
A  +-    --    doc/fundamentals/visualdict-breadcrumb.png
A  +-    --    doc/fundamentals/visualdict-button.png
A  +-    --    doc/fundamentals/visualdict-central-widget.png
A  +-    --    doc/fundamentals/visualdict-check-box.png
A  +-    --    doc/fundamentals/visualdict-color-selector.png
A  +-    --    doc/fundamentals/visualdict-combo-box.png
A  +-    --    doc/fundamentals/visualdict-context-menu.png
A  +-    --    doc/fundamentals/visualdict-dialog-box.png
A  +-    --    doc/fundamentals/visualdict-drop-down-box.png
A  +-    --    doc/fundamentals/visualdict-gui1.png
A  +-    --    doc/fundamentals/visualdict-gui2.png
A  +-    --    doc/fundamentals/visualdict-gui3.png
A  +-    --    doc/fundamentals/visualdict-gui4.png
A  +-    --    doc/fundamentals/visualdict-icon-list.png
A  +-    --    doc/fundamentals/visualdict-icon.png
A  +-    --    doc/fundamentals/visualdict-list-box.png
A  +-    --    doc/fundamentals/visualdict-menu-button.png
A  +-    --    doc/fundamentals/visualdict-menu.png
A  +-    --    doc/fundamentals/visualdict-menubar.png
A  +-    --    doc/fundamentals/visualdict-panel.png
A  +-    --    doc/fundamentals/visualdict-progress-bar.png
A  +-    --    doc/fundamentals/visualdict-radio-button.png
A  +-    --    doc/fundamentals/visualdict-scrollbar.png
A  +-    --    doc/fundamentals/visualdict-slider.png
A  +-    --    doc/fundamentals/visualdict-spin-box.png
A  +-    --    doc/fundamentals/visualdict-statusbar.png
A  +-    --    doc/fundamentals/visualdict-tab.png
A  +-    --    doc/fundamentals/visualdict-text-area.png
A  +-    --    doc/fundamentals/visualdict-text-box.png
A  +-    --    doc/fundamentals/visualdict-titlebar.png
A  +-    --    doc/fundamentals/visualdict-toolbar.png
A  +-    --    doc/fundamentals/visualdict-tree-view.png
A  +-    --    doc/fundamentals/visualdict-window.png
A  +-    --    doc/fundamentals/visualdict-window2.png

http://commits.kde.org/khelpcenter/624eefe8591f45043dc60f4b1061ee8c881234f4

diff --git a/doc/fundamentals/ui.docbook b/doc/fundamentals/ui.docbook
index 92eb032..00005a7 100644
--- a/doc/fundamentals/ui.docbook
+++ b/doc/fundamentals/ui.docbook
@@ -1,5 +1,4 @@
 <!--FIXME:
-        -visual dictionary
         -general toolbar info
         -basic keyboard shortcuts?
 -->
@@ -7,7 +6,752 @@
 <chapter id="ui">
 <title>Finding Your Way Around</title>
 
-<!--FIXME: visual dictionary goes here-->
+<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>
+A <link linkend="visualdict-button">Button</link> to place this window on all
+desktops
+</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>&GUI; Elements</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; Country/Region & Language 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 first item is selected)
+</para></listitem>
+
+<listitem><para>
+Some <emphasis role="bold"><link linkend="visualdict-tab">Tabs</link></emphasis>
+</para></listitem>
+
+<listitem><para>
+An open 
+<emphasis role="bold"><link linkend="visualdict-drop-down-box">Drop Down Box</link></emphasis>
+</para></listitem>
+
+<listitem><para>
+A <emphasis role="bold"><link linkend="visualdict-button">Button</link></emphasis>
+that resets the <link linkend="visualdict-drop-down-box">Drop Down Box</link> to
+its default value
+</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 onpart 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-text-box">text box</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 another <link linkend="visualdict-tab">tab</link>
+of the &systemsettings; Country/Region & Language  panel, shows five
+<emphasis role="bold"><link linkend="visualdict-combo-box">Combo Boxes</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 &kde-sc; 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>
diff --git a/doc/fundamentals/visualdict-breadcrumb.png b/doc/fundamentals/visualdict-breadcrumb.png
new file mode 100644
index 0000000..e2a8db5
Binary files /dev/null and b/doc/fundamentals/visualdict-breadcrumb.png differ
diff --git a/doc/fundamentals/visualdict-button.png b/doc/fundamentals/visualdict-button.png
new file mode 100644
index 0000000..845c494
Binary files /dev/null and b/doc/fundamentals/visualdict-button.png differ
diff --git a/doc/fundamentals/visualdict-central-widget.png b/doc/fundamentals/visualdict-central-widget.png
new file mode 100644
index 0000000..b8305a7
Binary files /dev/null and b/doc/fundamentals/visualdict-central-widget.png differ
diff --git a/doc/fundamentals/visualdict-check-box.png b/doc/fundamentals/visualdict-check-box.png
new file mode 100644
index 0000000..3204646
Binary files /dev/null and b/doc/fundamentals/visualdict-check-box.png differ
diff --git a/doc/fundamentals/visualdict-color-selector.png b/doc/fundamentals/visualdict-color-selector.png
new file mode 100644
index 0000000..7d19b36
Binary files /dev/null and b/doc/fundamentals/visualdict-color-selector.png differ
diff --git a/doc/fundamentals/visualdict-combo-box.png b/doc/fundamentals/visualdict-combo-box.png
new file mode 100644
index 0000000..2b4c3d7
Binary files /dev/null and b/doc/fundamentals/visualdict-combo-box.png differ
diff --git a/doc/fundamentals/visualdict-context-menu.png b/doc/fundamentals/visualdict-context-menu.png
new file mode 100644
index 0000000..0bbac64
Binary files /dev/null and b/doc/fundamentals/visualdict-context-menu.png differ
diff --git a/doc/fundamentals/visualdict-dialog-box.png b/doc/fundamentals/visualdict-dialog-box.png
new file mode 100644
index 0000000..87ef8be
Binary files /dev/null and b/doc/fundamentals/visualdict-dialog-box.png differ
diff --git a/doc/fundamentals/visualdict-drop-down-box.png b/doc/fundamentals/visualdict-drop-down-box.png
new file mode 100644
index 0000000..42bb431
Binary files /dev/null and b/doc/fundamentals/visualdict-drop-down-box.png differ
diff --git a/doc/fundamentals/visualdict-gui1.png b/doc/fundamentals/visualdict-gui1.png
new file mode 100644
index 0000000..17b2a7a
Binary files /dev/null and b/doc/fundamentals/visualdict-gui1.png differ
diff --git a/doc/fundamentals/visualdict-gui2.png b/doc/fundamentals/visualdict-gui2.png
new file mode 100644
index 0000000..5c2df0a
Binary files /dev/null and b/doc/fundamentals/visualdict-gui2.png differ
diff --git a/doc/fundamentals/visualdict-gui3.png b/doc/fundamentals/visualdict-gui3.png
new file mode 100644
index 0000000..c8aafce
Binary files /dev/null and b/doc/fundamentals/visualdict-gui3.png differ
diff --git a/doc/fundamentals/visualdict-gui4.png b/doc/fundamentals/visualdict-gui4.png
new file mode 100644
index 0000000..9e763a4
Binary files /dev/null and b/doc/fundamentals/visualdict-gui4.png differ
diff --git a/doc/fundamentals/visualdict-icon-list.png b/doc/fundamentals/visualdict-icon-list.png
new file mode 100644
index 0000000..89f40ca
Binary files /dev/null and b/doc/fundamentals/visualdict-icon-list.png differ
diff --git a/doc/fundamentals/visualdict-icon.png b/doc/fundamentals/visualdict-icon.png
new file mode 100644
index 0000000..be294b7
Binary files /dev/null and b/doc/fundamentals/visualdict-icon.png differ
diff --git a/doc/fundamentals/visualdict-list-box.png b/doc/fundamentals/visualdict-list-box.png
new file mode 100644
index 0000000..4a7e9cb
Binary files /dev/null and b/doc/fundamentals/visualdict-list-box.png differ
diff --git a/doc/fundamentals/visualdict-menu-button.png b/doc/fundamentals/visualdict-menu-button.png
new file mode 100644
index 0000000..51d3f3e
Binary files /dev/null and b/doc/fundamentals/visualdict-menu-button.png differ
diff --git a/doc/fundamentals/visualdict-menu.png b/doc/fundamentals/visualdict-menu.png
new file mode 100644
index 0000000..7e23594
Binary files /dev/null and b/doc/fundamentals/visualdict-menu.png differ
diff --git a/doc/fundamentals/visualdict-menubar.png b/doc/fundamentals/visualdict-menubar.png
new file mode 100644
index 0000000..768dfd6
Binary files /dev/null and b/doc/fundamentals/visualdict-menubar.png differ
diff --git a/doc/fundamentals/visualdict-panel.png b/doc/fundamentals/visualdict-panel.png
new file mode 100644
index 0000000..a7093bc
Binary files /dev/null and b/doc/fundamentals/visualdict-panel.png differ
diff --git a/doc/fundamentals/visualdict-progress-bar.png b/doc/fundamentals/visualdict-progress-bar.png
new file mode 100644
index 0000000..627ce6f
Binary files /dev/null and b/doc/fundamentals/visualdict-progress-bar.png differ
diff --git a/doc/fundamentals/visualdict-radio-button.png b/doc/fundamentals/visualdict-radio-button.png
new file mode 100644
index 0000000..e350ff4
Binary files /dev/null and b/doc/fundamentals/visualdict-radio-button.png differ
diff --git a/doc/fundamentals/visualdict-scrollbar.png b/doc/fundamentals/visualdict-scrollbar.png
new file mode 100644
index 0000000..f576298
Binary files /dev/null and b/doc/fundamentals/visualdict-scrollbar.png differ
diff --git a/doc/fundamentals/visualdict-slider.png b/doc/fundamentals/visualdict-slider.png
new file mode 100644
index 0000000..27a6115
Binary files /dev/null and b/doc/fundamentals/visualdict-slider.png differ
diff --git a/doc/fundamentals/visualdict-spin-box.png b/doc/fundamentals/visualdict-spin-box.png
new file mode 100644
index 0000000..ed1fe81
Binary files /dev/null and b/doc/fundamentals/visualdict-spin-box.png differ
diff --git a/doc/fundamentals/visualdict-statusbar.png b/doc/fundamentals/visualdict-statusbar.png
new file mode 100644
index 0000000..247dceb
Binary files /dev/null and b/doc/fundamentals/visualdict-statusbar.png differ
diff --git a/doc/fundamentals/visualdict-tab.png b/doc/fundamentals/visualdict-tab.png
new file mode 100644
index 0000000..cf26902
Binary files /dev/null and b/doc/fundamentals/visualdict-tab.png differ
diff --git a/doc/fundamentals/visualdict-text-area.png b/doc/fundamentals/visualdict-text-area.png
new file mode 100644
index 0000000..29b66a9
Binary files /dev/null and b/doc/fundamentals/visualdict-text-area.png differ
diff --git a/doc/fundamentals/visualdict-text-box.png b/doc/fundamentals/visualdict-text-box.png
new file mode 100644
index 0000000..3b2ce3c
Binary files /dev/null and b/doc/fundamentals/visualdict-text-box.png differ
diff --git a/doc/fundamentals/visualdict-titlebar.png b/doc/fundamentals/visualdict-titlebar.png
new file mode 100644
index 0000000..46a1dc1
Binary files /dev/null and b/doc/fundamentals/visualdict-titlebar.png differ
diff --git a/doc/fundamentals/visualdict-toolbar.png b/doc/fundamentals/visualdict-toolbar.png
new file mode 100644
index 0000000..319332c
Binary files /dev/null and b/doc/fundamentals/visualdict-toolbar.png differ
diff --git a/doc/fundamentals/visualdict-tree-view.png b/doc/fundamentals/visualdict-tree-view.png
new file mode 100644
index 0000000..4c8722e
Binary files /dev/null and b/doc/fundamentals/visualdict-tree-view.png differ
diff --git a/doc/fundamentals/visualdict-window.png b/doc/fundamentals/visualdict-window.png
new file mode 100644
index 0000000..e618521
Binary files /dev/null and b/doc/fundamentals/visualdict-window.png differ
diff --git a/doc/fundamentals/visualdict-window2.png b/doc/fundamentals/visualdict-window2.png
new file mode 100644
index 0000000..1afa237
Binary files /dev/null and b/doc/fundamentals/visualdict-window2.png differ

More information about the kde-doc-english mailing list