accessxhelp.h revision 943
551N/A/*
943N/A * Copyright (c) 1993, 2004, Oracle and/or its affiliates. All rights reserved.
551N/A *
551N/A * Permission is hereby granted, free of charge, to any person obtaining a
919N/A * copy of this software and associated documentation files (the "Software"),
919N/A * to deal in the Software without restriction, including without limitation
919N/A * the rights to use, copy, modify, merge, publish, distribute, sublicense,
919N/A * and/or sell copies of the Software, and to permit persons to whom the
919N/A * Software is furnished to do so, subject to the following conditions:
551N/A *
919N/A * The above copyright notice and this permission notice (including the next
919N/A * paragraph) shall be included in all copies or substantial portions of the
919N/A * Software.
551N/A *
919N/A * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
919N/A * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
919N/A * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
919N/A * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
919N/A * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
919N/A * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
919N/A * DEALINGS IN THE SOFTWARE.
551N/A */
551N/A/************************************************************************/
551N/A/* AccessXHelp.h */
551N/A/************************************************************************/
551N/A
551N/A/* The following define the number of lines in each of the help strings.
551N/A These must be precisely defined by counting the lines in the
551N/A corresponding strings in order for the accessx help facility to work
551N/A properly.
551N/A*/
551N/A#define NUM_GENERAL_HELP_LINES (28)
551N/A#define NUM_STICKY_HELP_LINES (19)
551N/A#define NUM_MOUSE_HELP_LINES (28)
551N/A#define NUM_TOGGLE_HELP_LINES (9)
551N/A#define NUM_REPEAT_HELP_LINES (24)
551N/A#define NUM_SLOW_HELP_LINES (23)
551N/A#define NUM_BOUNCE_HELP_LINES (20)
551N/A
551N/A/****************************************************************/
551N/A/* */
551N/A/* General Help String */
551N/A/* */
551N/A/****************************************************************/
551N/Astatic char *generalHelpString[] = { "General Help\n\n",
551N/A"This help text provides information about the accessx utility in general and\n",
551N/A"describes the general setting items on the user interface.\n\n",
551N/A"The AccessX utility was co-developed by Digital Equipment Corportation, The\n",
551N/A"Trace Research Center at the University of Wisconsin-Madison and by Sun\n",
551N/A"Microsystems Laboratories, Inc. The accessx utility will be a part of the X11\n",
551N/A"Windows systems version R6 and later.\n\n",
551N/A"The Main menu bar contains four pulldown menus: File, Status, Options and Help.\n",
551N/A"The File menu allows you to either load or save your current settings for future\n",
551N/A"use. The exit option allows you to gracefully exit the AccessX utility.\n\n",
551N/A"The Status menu allows you to pull up separate windows indicating the current\n",
551N/A"status of the Sticky Key modifier keys (i.e. whether they are latched or\n",
551N/A"locked) and the status of the Mouse Keys mouse buttons (i.e. whether they\n",
551N/A"are pressed or released).\n\n",
551N/A"The Help menu options allows you to get help on the various features of\n",
551N/A"AccessX.\n\n",
551N/A"Directly below the main menu bar are three general setting items. The first,\n",
551N/A"labelled 'Enable AccessX' allows you to turn off the entire utility. When\n",
551N/A"this box is unchecked the rest of the interface in greyed out to indicate that\n",
551N/A"AccessX in inactive. It also disables the keyboard invocation features.\n\n",
551N/A"The second checkbox item allows you to hear a beep when each individual\n",
551N/A"feature is toggled on or off.\n\n",
551N/A"The third item is a time out time. In environments where many users use\n",
551N/A"one machine, this allows you to tell the AccessX utility to clear your\n",
551N/A"user specific settings and turn off all of the features after a settable time\n",
551N/A"period of inactivity. When the 'Time Out' checkbox is check, then the features\n",
551N/A"will turn off according to the time currently set on the scale. The time\n",
551N/A"markings for the scale are labelled in minutes.\n" };
551N/A
551N/A
551N/A/****************************************************************/
551N/A/* */
551N/A/* Sticky Keys Help String */
551N/A/* */
551N/A/****************************************************************/
551N/Astatic char *stickyHelpString[] = {
551N/A"Sticky Keys\n\n",
551N/A"DESCRIPTION: Sticky Keys benefits users who type with only one finger and\n",
551N/A" for users who use a mouth stick. The Sticky Keys feature allow\n",
551N/A" you to latch and lock modifier keys. A latched modifier key\n",
551N/A" will modify the next alpha-numeric key and a locked modifier\n",
551N/A" key will modify all future alpha-numeric keys pressed until\n",
551N/A" the modifier is unlocked. Pressing a modifier key once will\n",
551N/A" latch that modifier. Pressing a modifier key twice in a row\n",
551N/A" will lock that modifier.\n\n",
551N/A"ENABLING: Users can turn Sticky Keys on and off in one of two ways.\n",
551N/A" Clicking on the check box marked 'Sticky Keys' under the \n",
551N/A" 'Enable' panel will turn on and off Sticky Keys. Sticky Keys\n",
551N/A" may also be turned on or off via the keyboard by pressing\n",
551N/A" the left or right Shift key five times in a row.\n\n",
551N/A"FEATURES: Sticky Keys has two user settable options that are located\n",
551N/A" under the 'Sticky Keys' panel. The first check box allows\n",
551N/A" users to hear a system beep when a modifier is latched. The\n",
551N/A" second allows the user to turn the Sticky Keys feature off\n",
551N/A" when two modifier keys a pressed simultaneously.\n\n\n" };
551N/A
551N/A/****************************************************************/
551N/A/* */
551N/A/* Mouse Keys Help String */
551N/A/* */
551N/A/****************************************************************/
551N/Astatic char *mouseHelpString[] = {
551N/A"Mouse Keys\n\n",
551N/A"DESCRIPTION: Mouse Keys benefits users who have RSI or mouth stick users\n",
551N/A" who are unable to control a mouse. Also CAD users who need\n",
551N/A" pixel by pixel control of a mouse pointer benefit from Mouse\n",
551N/A" Keys. The Mouse Keys feature turn the numeric keypad into a\n",
551N/A" mouse control mechanism. The keys '1' through '4' and keys '6'\n",
551N/A" through '9' are use for navigation of the mouse. The '5' key\n",
551N/A" simulates a mouse button click; the Plus key simulates mouse\n",
551N/A" button double click; the '0' key simulates a mouse button\n",
551N/A" press; and the Period key simulates a mouse button release.\n",
551N/A" These latter keys operate on a 'current' button which is set\n",
551N/A" via keys specific to each vendor. Often these keys, which set\n",
551N/A" the current mouse button, are located directly above the key\n",
551N/A" pad.\n\n",
551N/A"ENABLING: Mouse Keys may be turned on or off in one of two ways.\n",
551N/A" Clicking the 'Mouse Keys' check box under the 'Enable' panel\n",
551N/A" turns Mouse Keys on or off. Mouse Keys is also turned on or\n",
551N/A" off via the keyboard. A vendor-specific three key combination\n",
551N/A" is used.\n\n",
551N/A"FEATURES: There are two user settable parameters which control the\n",
551N/A" behavior of the mouse pointer. These two parameters are set\n",
551N/A" via scales in the 'Mouse Keys' panel. The 'Maximum Pointer\n",
551N/A" Speed' is displayed in Pixels/Second and the 'Time To Maximum\n",
551N/A" Speed' is displayed in Seconds. When a user holds down one of\n",
551N/A" the direction keys on the key pad, the mouse pointer moves in\n",
551N/A" that direction eventually reaching the 'Maximum Pointer Speed'\n",
551N/A" It takes the amount of time specified by 'Time To Maximum\n",
551N/A" Speed' to reach the maximum speed.\n\n\n" };
551N/A
551N/A/****************************************************************/
551N/A/* */
551N/A/* Toggle Keys Help String */
551N/A/* */
551N/A/****************************************************************/
551N/Astatic char *toggleHelpString[] = {
551N/A"Toggle Keys\n\n",
551N/A"DESCRIPTION: Toggle Keys benefits the visually impaired user who has\n",
551N/A" difficulty seeing the small LED keyboard indicators. Toggle\n",
551N/A" Keys beeps once when a toggle key (i.e the Caps Lock\n",
551N/A" key, etc) is toggle 'on' and beeps twice when a toggle keys is\n",
551N/A" toggled 'off'.\n\n",
551N/A"ENABLING: Toggles Keys is turned on and off via the check box in the\n",
551N/A" 'Enable' panel.\n\n",
551N/A"FEATURES: There are no additional user settable options for Toggle Keys.\n\n\n" };
551N/A
551N/A
551N/A/****************************************************************/
551N/A/* */
551N/A/* Repeat Keys Help String */
551N/A/* */
551N/A/****************************************************************/
551N/Astatic char *repeatHelpString[] = {
551N/A"Repeat Keys\n\n",
551N/A"DESCRIPTION: Users who have difficulty in removing their finger from\n",
551N/A" pressed keys benefit from Repeat Keys. Repeat Keys allows\n",
551N/A" users to control the key-repeating characteristics of the\n",
551N/A" system's keyboard.\n\n",
551N/A"ENABLING: Repeat Keys may be turned on or off in one of two ways. It\n",
551N/A" may be turned on or off via the check box in the 'Enable'\n",
551N/A" panel. It also may be turned off via the keyboard. Holding the\n",
551N/A" left or right Shift key down for four seconds will turn Repeat\n",
551N/A" Keys on or off. After holding the Shift Key for two seconds,\n",
551N/A" the user will hear three warning beeps. Two seconds later,\n",
551N/A" Repeat Keys will be turned on or off.\n\n",
551N/A" Note that Slow Keys is also turned on or off when holding the\n",
551N/A" the left or right Shift key for four seconds.\n\n",
551N/A"FEATURES: Repeat Keys allows the user to set two parameters, a 'Delay\n",
551N/A" Until Repeat' time displayed in seconds and a 'Repeat Rate'\n",
551N/A" time displayed in Keys/Second. The 'Delay Until Repeat' time\n",
551N/A" instructs the system to wait a certain number of seconds\n",
551N/A" before repeating a pressed key. This time delay is measured\n",
551N/A" after the first accepted key stroke. The 'Repeat Rate'\n",
551N/A" parameters instructs the system to generate a certain number\n",
551N/A" of keys each second once a key has begun repeating itself.\n\n",
551N/A"CALIBRATING: A text field is provided on the interface so that users may\n",
551N/A" test their Repeat Keys settings.\n\n\n" };
551N/A
551N/A
551N/A/****************************************************************/
551N/A/* */
551N/A/* Slow Keys Help String */
551N/A/* */
551N/A/****************************************************************/
551N/Astatic char *slowHelpString[] = {
551N/A"Slow Keys\n\n",
551N/A"DESCRIPTION: Slow Keys benefits users who hit unwanted keys as they search\n",
551N/A" for the desired key. Mouth stick users often exhibit this\n",
551N/A" typing behavior. The Slow Keys feature instructs the system\n",
551N/A" to accept key presses if they have been held down for a\n",
551N/A" certain amount of time\n\n",
551N/A"ENABLING: Slow Keys may be turned on or off in one of two ways. It may\n",
551N/A" be turned on or off via the check box in the 'Enable' panel\n",
551N/A" Also, Slow Keys may be turned on or off via the keyboard by\n",
551N/A" holding the left or right Shift key for four seconds. This\n",
551N/A" also turns Repeat Keys on or off. Refer to the Help\n",
551N/A" description of Repeat Keys for more information.\n\n",
551N/A" Note that the Slow Keys and Bounce Keys features a mutually\n",
551N/A" exclusive, i.e. only one may be turned on at one time.\n\n",
551N/A"FEATURES: Slow Keys has three settable parameters. The first allows the\n",
551N/A" user to hear a beep when either the key has first been\n",
551N/A" pressed or when the key has been accepted as a key stroke or\n",
551N/A" both. The 'Acceptance Delay parameters, displayed in Seconds,\n",
551N/A" instructs the system to only accept a key stroke after it has\n",
551N/A" been held down for a certain number of seconds. These are set\n",
551N/A" in the 'Slow Keys' panel.\n\n",
551N/A"CALIBRATING: A text field is provided in interface allowing users to test\n",
551N/A" Slow Keys settings.\n\n\n" };
551N/A
551N/A
551N/A/****************************************************************/
551N/A/* */
551N/A/* Bounce Keys Help String */
551N/A/* */
551N/A/****************************************************************/
551N/Astatic char *bounceHelpString[] = {
551N/A"Bounce Keys\n\n",
551N/A"DESCRIPTION: Bounce Keys benefits users who type by bouncing up and down\n",
551N/A" on one key. The Bounce Keys feature instructs the system to\n",
551N/A" ignore all future key presses of a certain key if they happen\n",
551N/A" within a certain period of time.\n\n",
551N/A"ENABLING: Bounce Keys may be turned on or off via the check box in the\n",
551N/A" 'Enable' panel.\n\n",
551N/A" Note that Bounce Keys and Slow Keys are mututall exclusive,",
551N/A" i.e. only one of these features may be turned on at one\n",
551N/A" time.\n\n",
551N/A"FEATURES: Bounce Keys has one user settable parameter, the 'Debounce\n",
551N/A" Time', displayed in seconds. The first key press of a key\n",
551N/A" is accepted. If this key is pressed again in a time shorter\n",
551N/A" than the 'Debounce Time', it will be ignored. The next key\n",
551N/A" stroke will only be accepted if it has been released for a\n",
551N/A" period longer than the 'Debounce Time'. The 'Debounce Time'\n",
551N/A" parameters is settable via a scale in the 'Bounce Keys'\n",
551N/A" panel.\n\n",
551N/A"CALIBRATION: A text field is provided in the interface allowing users to\n",
551N/A" test Bounce Keys settings.\n\n\n" };