not quite so much needs to be delayed to the init() function
[personal-kdebase.git] / workspace / doc / kcontrol / kcmaccess / index.docbook
blob25ccf55c282be74a17d18d5d319ffbe036d71dfa
1 <?xml version="1.0" ?>
2 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
3 "dtd/kdex.dtd" [
4 <!ENTITY % addindex "IGNORE">
5 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
6 ]>
8 <article>
9 <articleinfo>
11 <authorgroup>
12 <author>&Mike.McBride; &Mike.McBride.mail;</author>
13 <!-- TRANS:ROLES_OF_TRANSLATORS -->
14 </authorgroup>
16 <date>2005-12-21</date>
17 <releaseinfo>3.01.00</releaseinfo>
19 <keywordset>
20 <keyword>KDE</keyword>
21 <keyword>KControl</keyword>
22 <keyword>accessibility</keyword>
23 </keywordset>
24 </articleinfo>
26 <sect1 id="accessibility">
27 <title>Accessibility</title>
28 <sect2 id="accessibility-intro">
30 <title>Introduction</title>
32 <para>This module is designed to help users who have difficulty hearing
33 audible cues, or who have difficulty using a keyboard. </para>
35 <para>
36 The module is divided into two tabs: <link
37 linkend="access-bell"><guilabel>Bell</guilabel></link> and <link
38 linkend="access-kb"><guilabel>Keyboard</guilabel></link>.
39 </para>
41 <sect3 id="access-bell">
42 <title><guilabel>Bell</guilabel></title>
44 <para>
45 This panel is divided into an <guilabel>Audible Bell</guilabel> section
46 and a <guilabel>Visible Bell</guilabel> section.
47 </para>
49 <para>
50 The top check box labeled <guilabel>Use System Bell</guilabel>, determines
51 whether the normal System bell rings. If this option is disabled, the
52 System bell will be silenced.
53 </para>
55 <para>
56 The next check box down can be used to play a different sound whenever
57 the system bell is triggered. To activate, place a mark in the check
58 box labeled <guilabel>Use customized bell</guilabel>, and enter the
59 complete pathname to the sound file in the text box labeled
60 <guilabel>Sound to Play</guilabel>. If you want, you can select the
61 <guibutton>Browse</guibutton> button to navigate through your filesystem
62 to find the exact file.
63 </para>
65 <para>
66 For those users who have difficulty hearing the System bell, or those
67 users who have a silent computer, &kde; offers the <emphasis>visible bell</emphasis>. This
68 provides a visual signal (inverting the screen or flashing a color
69 across it) when the system bell would normally sound.
70 </para>
72 <para>
73 To use the visible bell, first place a mark in the check box labeled
74 <guilabel>Use visible bell</guilabel>.
75 </para>
77 <para>
78 You can then select between <guilabel>Invert screen</guilabel>, or
79 <guilabel>Flash screen</guilabel>. If you select <guilabel>Invert
80 screen</guilabel>, all colors on the screen will be reversed. If you
81 choose <guilabel>Flash screen</guilabel>, you can choose the color by
82 clicking the button to the right of the <guilabel>Flash
83 screen</guilabel> selection.
84 </para>
86 <para>
87 The slider bar can be used to adjust the duration of the visible
88 bell. The default value is 500ms, or half a second.
89 </para>
91 </sect3>
93 <sect3 id="access-kb">
94 <title><guilabel>Keyboard</guilabel></title>
96 <para>There are three sections to this panel.</para>
98 <variablelist>
99 <varlistentry>
100 <term><guilabel>Use Sticky Keys</guilabel></term>
101 <listitem>
102 <para>
103 If this option is enabled, you can press and release the &Shift;,
104 &Alt; or &Ctrl; keys, and then press another key to get a key combo
105 (example: <keycombo action="simul">&Ctrl; &Alt;
106 <keycap>Del</keycap></keycombo> could be done with &Ctrl; then &Alt;
107 then <keycap>Del</keycap>).
108 </para>
110 <para>
111 Also in this section is a check box labeled <guilabel>Lock Sticky
112 Keys</guilabel>. If this check box is enabled, the &Alt;, &Ctrl;
113 and &Shift; keys stay <quote>selected</quote> until you
114 <quote>de-selected</quote> them.
115 </para>
117 <para>
118 As an example:
119 </para>
120 <variablelist>
121 <varlistentry>
122 <term>With <guilabel>Lock Sticky Keys</guilabel> disabled:</term>
123 <listitem>
124 <para>If you press the &Shift; key then press the
125 <keycap>F</keycap> key, the computer interprets this as <keycombo
126 action="simul">&Shift;<keycap>F</keycap></keycombo>. Now if you
127 type a <keycap>P</keycap>, the computer interprets this as the letter p
128 (no shift).
129 </para>
130 </listitem>
131 </varlistentry>
133 <varlistentry>
134 <term>With <guilabel>Lock Sticky Keys</guilabel> enabled:</term>
135 <listitem>
136 <para>
137 If you press the &Shift; key <emphasis>twice</emphasis> then press the <keycap>F</keycap> key,
138 the computer interprets this as <keycombo
139 action="simul">&Shift;<keycap>F</keycap></keycombo>. Now if you
140 type a <keycap>p</keycap>, the computer interprets this as the letter P
141 (<keycombo action="simul">&Shift;<keycap>P</keycap></keycombo>). To
142 de-select the &Shift; key, press it again.
143 </para>
144 </listitem>
145 </varlistentry>
146 </variablelist>
147 </listitem>
148 </varlistentry>
150 <varlistentry>
151 <term><guilabel>Slow keys</guilabel></term>
152 <listitem>
153 <para>
154 If this option is enabled, you must hold the key down for a
155 specified length of time (adjustable with the slider) before the
156 keystroke will be accepted. This helps prevent accidental key strokes.
157 </para>
158 </listitem>
159 </varlistentry>
161 <varlistentry>
162 <term><guilabel>Bounce keys</guilabel></term>
163 <listitem>
164 <para>
165 If this option is enabled, you must wait for a specified length of time
166 (configurable with the slider) before the next key press can be
167 accepted. This prevents accidental multiple key strokes.
168 </para>
169 </listitem>
170 </varlistentry>
171 </variablelist>
173 </sect3>
175 </sect2>
177 </sect1>
179 </article>