path: root/doc/kspread/a11y.docbook

<chapter id="a11y">
<chapterinfo>
<authorgroup>
<author>
<firstname>Gary</firstname>
<surname>Cramblitt</surname>
</author>
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
</chapterinfo>

<title>For Users with Disabilities</title>
<para>This section of the documentation discusses accessibility features in &kspread;
for users with disabilities. Some of these features apply to &kde; as a whole and are controlled from 
<ulink url="help:kcontrol">&kcontrolcenter;</ulink>.  Some apply to all &koffice; applications,
and some are specific to &kspread;.</para>

<sect1 id="a11y-install">
<title>Installing the <command>kdeaccessibility</command> Module</title>
<indexterm><primary>kdeaccessibility</primary></indexterm>
<para>
Most of the features described in this chapter are enabled by installing the
<command>kdeaccessibility</command> module.  
The <command>kdeaccessibility</command> module is part of the &kde; project
<ulink url="http://www.kde.org">http://www.kde.org</ulink>.  The <command>kdeaccessibility</command> 
package can be obtained from &kde-ftp;, the
main ftp site of the &kde; project.
</para>

<para>Many distributions offer precompiled binaries on their ftp sites.  Please check your distribution's web sites for more information.</para>

<para>More information about &kde; accessibility can be obtained by
visiting <ulink url="http://accessibility.kde.org/">http://accessibility.kde.org/</ulink>.
</para>
</sect1>

<sect1 id="a11y-sight">
<title>Visual Impairments</title>
<indexterm><primary>Visual Impairments</primary></indexterm>

<note><para>&kspread; is not usable by totally blind users.  It is hoped that
a general screen reader for the blind will be available in future versions of &kde;.
</para></note>

<sect2 id="a11y-theming">
<title>Theming</title>
<indexterm><primary>Theming</primary></indexterm>
<para>For low-sighted or light allergic users, several features are available in the &kcontrolcenter; 
<menuchoice><guimenu>Appearance &amp; Themes</guimenu><guimenuitem>Theme Manager</guimenuitem></menuchoice>, 
like high contrast color themes. If you are light allergic, the
<guilabel>HighContrastDark</guilabel> or <guilabel>HighContrastLight</guilabel> themes
may be helpful.  If you have difficulty reading small fonts or seeing small icons, the
<guilabel>HighContrastDark-big</guilabel> or <guilabel>HighContrastLight-big</guilabel>
themes will increase the size of text, buttons, and icons.  You may also customize
background, colors, fonts, and icons from the same dialog.  A set of monochrome icons
is available.
</para>

<tip><para>If you choose one of the <guilabel>Big</guilabel> themes, you may discover that
some windows are too large to fit your monitor.  Purchasing a larger monitor will be helpful.
You can drag the portions of the window not visible into the visible area by
holding down the &Alt; key and dragging with the &LMB; anywhere
within the screen.  If you have trouble operating a mouse, you can also move screens by pressing
<keycombo action="simul">&Alt;<keycap>F3</keycap></keycombo>.  In 
the dropdown Windows Operations Menu, choose 
<menuchoice><guimenuitem>Move</guimenuitem></menuchoice>.
Move the screen with the arrow keys and press &Esc; to finish the move.
</para></tip>

</sect2>

<sect2 id="a11y-kmagnifier">
<title>&kmagnifier;</title>
<indexterm><primary>magnifier</primary></indexterm>
<para>The <command>kdeaccessibility</command> module includes a screen magnifier
application called <ulink url="help:kmag">&kmagnifier;</ulink>.
If it is installed, you can run it from
<menuchoice><guimenu>K-Button</guimenu><guimenuitem>Utilities</guimenuitem>
<guimenuitem>KMag (Screen Magnifier)</guimenuitem></menuchoice>.
</para>
</sect2>

<sect2 id="a11y-tts">
<title>Text-to-Speech</title>
<indexterm><primary>Text-to-Speech</primary></indexterm>
<indexterm><primary>TTS</primary></indexterm>
<para>The <command>kdeaccessibility</command> module includes a Text-to-Speech
component called KTTS.  If KTTS is installed, you can configure &kspread; to
speak the text that is under the mouse pointer or speak the text of each
screen widget as it receives focus.  Before using this feature, first configure
KTTS.  See <ulink url="help:kttsd">The KTTS Handbook</ulink> for details.
To turn on the TTS feature in &kspread;, 
select <menuchoice><guimenu>Settings</guimenu><guimenuitem>Configure
&kspread;...</guimenuitem></menuchoice> from the menubar.
This will display a dialog box.
Clicking on <guilabel>TTS</guilabel> will allow you to change
the following.</para>

<screenshot>
<mediaobject>
<imageobject><imagedata fileref="tts.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<variablelist>
<varlistentry>
<term><guilabel>Speak widget under mouse pointer</guilabel></term>
<listitem><para>When checked, &kspread; will speak the text of each widget
as the mouse pointer moves over the widget.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Speak widget with focus</guilabel></term>
<listitem><para>When checked, &kspread; will speak the text of each widget
as it receives focus.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Speak tool tips</guilabel></term>
<listitem><para>When checked, &kspread; will speak the popup tool tip
for each widget in addition to the text of the widget.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Speak Whats This</guilabel></term>
<listitem><para>When checked, &kspread; will speak the Whats This help
for each widget in addition to the text of the widget.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Say whether disabled</guilabel></term>
<listitem><para>When checked, &kspread; will speak the word "disabled"
if the widget is currently disabled (grayed).</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Speak accelerators</guilabel></term>
<listitem><para>When checked, &kspread; will speak the accelerator
of the widget in addition to the text of the widget.
Accelerators are the underlined letters you see in the text of the
widget.  For example, in the main menu, the 
<menuchoice><guimenuitem>Quit</guimenuitem></menuchoice> menu item
has the "Q" underlined.  You can choose it by pressing <keycap>Q</keycap>.
To speak the accelerator, check this option and enter the
word you want to speak before the accelerator in the
<guilabel>Prefaced by the word</guilabel> box.  In this
example shown above, &kspread; will speak "Accelerator Q".</para>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Polling interval</guilabel></term>
<listitem><para>This option determines how often &kspread; will
check for a change in the widget under the mouse pointer or
a new focused widget.  You should leave this option on the
default setting.</para>
</listitem>
</varlistentry>
</variablelist>

<note><para>
If the <guibutton>TTS</guibutton> option does not appear
on this screen, you do not have the KTTS component installed
in your system.
</para></note>

<note><para>Not all widgets are spoken.  For example,
the items on the main menubar are not spoken.
</para></note>

</sect2>

</sect1>

<sect1 id="a11y-motor">
<title>Motor Impairments and Mouseless Operation</title>
<indexterm><primary>Motor Impairments</primary></indexterm>
<indexterm><primary>Mouseless Operation</primary></indexterm>

<sect2 id="a11y-kmousetool">
<title>KMouseTool</title>
<para>If you can operate a mouse, but have trouble clicking, the
<ulink url="help:kmousetool">KMouseTool</ulink> application may help.  Run it from
<menuchoice><guimenu>K-Button</guimenu><guimenuitem>Utilities</guimenuitem>
<guimenuitem>KMouseTool (Automatik Mouse Click)</guimenuitem></menuchoice>.
</para>
</sect2>

<sect2 id="a11y-kbd-xaccess">
<title>XAccess Features</title>
<indexterm><primary>XAccess</primary></indexterm>
<indexterm><primary>Sticky Keys</primary></indexterm>
<indexterm><primary>Slow Keys</primary></indexterm>
<indexterm><primary>Bounce Keys</primary></indexterm>

<para>The &kcontrolcenter; offers several keyboard features collectively called XAccess.
They include:</para>
<variablelist>
<varlistentry>
<term>Sticky Keys</term>
<listitem><para>This feature permits operation of meta keys, such as
&Alt;, &Ctrl;, and &Shift; without having to hold the keys down.  It is useful
when you can only use one finger or one hand to operate the keyboard.
With Sticky Keys on, press and release a &Alt;, &Ctrl;, or &Shift; key, then
press another key.  The result is as if you pressed both keys at once.
Press the &Alt;, &Ctrl;, or &Shift; key again to turn off the sticky key.
Activate this feature in 
<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem>
<guimenuitem>Regional &amp; Accessibility</guimenuitem><guimenuitem>Accessibility</guimenuitem>
<guimenuitem>Modifier Keys</guimenuitem></menuchoice>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Slow Keys</term>
<listitem><para>This feature is useful if you have hand tremors or difficulty
accurately pressing keys.  It prevents
inadvertent key presses by requiring that a key be held down for a minimum
time before it is accepted.  Activate this feature in
<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem>
<guimenuitem>Regional &amp; Accessibility</guimenuitem><guimenuitem>Accessibility</guimenuitem>
<guimenuitem>Keyboard Filters</guimenuitem></menuchoice>.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Bounce Keys</term>
<listitem><para>This feature is also useful if you have hand tremors.  It prevents
inadvertent repeated key presses by preventing another keystroke for
a certain amount of time.  Activate this feature in
<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem>
<guimenuitem>Regional &amp; Accessibility</guimenuitem><guimenuitem>Accessibility</guimenuitem>
<guimenuitem>Keyboard Filters</guimenuitem></menuchoice>.</para>
</listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="a11y-mouse-emulation">
<title>Mouse Emulation</title>
<indexterm><primary>Mouse Emulation</primary></indexterm>
<para>Mouse Emulation permits you to move and click the mouse using the keyboard.
Press <keycombo>&Alt;<keycap>F12</keycap></keycombo> to activate it.  Use the arrow keys
to move the mouse pointer to the desired location, and press <keycap>spacebar</keycap>
to "click" the mouse.  Unfortunately, you cannot use Mouse Emulation to perform
&RMB; clicks or dragging.
</para>
</sect2>

<sect2 id="a11y-mouse-navigation">
<title>Mouse Navigation</title>
<indexterm><primary>Mouse Navigation</primary></indexterm>
<para>This feature permits you to emulate the mouse using the numeric keypad
of your keyboard.  To activate it, go to
<menuchoice><guimenu>K-Button</guimenu><guimenuitem>&kcontrolcenter;</guimenuitem>
<guimenuitem>Peripherals</guimenuitem><guimenuitem>Mouse</guimenuitem>
<guimenuitem>Mouse Navigation</guimenuitem></menuchoice>.
Check the <guilabel>Move pointer with keyboard (using the num pad)</guilabel> box. When you do this, the other settings will become enabled, and you can customize the keyboard pointer behavior further, if required. 
 The various keys on the number pad move in the direction you would expect. Note that you can move diagonally as well as up, down, left and right. The <keycap>5</keycap> key emulates a click to a pointer button, typically &LMB;. You change which button is emulated by using the <keycap>/</keycap> key (which makes it &LMB;),
<keycap>*</keycap> key (which makes it middle mouse button) and <keycap>-</keycap> (which makes it &RMB;).
 Using the <keycap>+</keycap> emulates a doubleclick to the selected pointer button. You can use the
<keycap>0</keycap> key to emulate holding down the selected pointer button (for easy dragging),
and then use the <keycap>.</keycap> to emulate releasing the selected pointer button.
</para>

<screenshot>
<mediaobject>
<imageobject><imagedata fileref="mousenav.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

</sect2>

<sect2 id="a11y-motor-shortcuts">
<title>Keyboard shortcuts</title>

<para>Use the <keycap>Menu</keycap> key to pop up the context
menu.  On most keyboards, the <keycap>Menu</keycap> key is on the righthand
side of the keyboard between the <keycap>&Windows;</keycap> and &Ctrl;
keys.  It has a menu icon on it.
</para>

</sect2>

<sect2 id="a11y-motor-panel-sizing">
<title>Resizing panels</title>

<para>If you have activated two or more views of a spreadsheet,
you can move the sizing bar between the views by pressing <keycap>F8</keycap>.  A sizing icon appears
overtop the sizing bar.  Use the arrow keys to move the bar up or down, or left or right.
Press <keycap>F8</keycap> again or &Esc; when finished sizing.
</para>

</sect2>

<sect2 id="a11y-motor-moving-focus">
<title>Setting focus to widgets</title>

<para>Normally, one can use the &Tab; and <keycombo action="simul">&Shift;&Tab;</keycombo>
to move focus from one widget to the next in any application.  However, in &kspread;,
pressing &Tab; does not move the focus; instead it moves the cell selection forwards.
You can set focus to any widget that can receive focus by
pressing <keycombo action="simul">&Alt;<keycap>F8</keycap></keycombo>.  A small lettered box appears
overtop each widget on the screen that can receive focus.
</para>

<screenshot>
<mediaobject>
<imageobject><imagedata fileref="kbd-focus-ext.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para>Press the letter to move focus to the corresponding widget.  Press
<keycombo action="simul">&Alt;<keycap>F8</keycap></keycombo> again or &Esc;
to abandon moving the focus.
</para>

</sect2>

</sect1> 

</chapter>