[guispeak] Testing JAWS scripts for NoteTab, WordPad, & Script Manager
- From: Jamal Mazrui <empower@xxxxxxxxx>
- To: jawsscripts@xxxxxxxxxxxxxxxxxxxx, programming@xxxxxxxxxxxxxxxxxxxx, program-l@xxxxxxxxxxxxx, guispeak@xxxxxxxxxxxxx
- Date: Tue, 3 Apr 2007 16:06:41 -0400 (EDT)
Executable installer
http://www.EmpowermentZone.com/kitsetup.exe
Zip archive
http://www.EmpowermentZone.com/kitsetup.zip
I am seeking testers of a JAWS script library and editor interface
documented below. If interested, install all files in the JAWS user
script folder, either with the executable installer or zip archive. If
you try the scripts and find them unsatisfactory for whatever reason,
delete the files to restore use of the corresponding factory-supplied
scripts in the All Users folder.
If reporting a problem, please be as specific as possible about the JAWS
version, Windows version, application, and task. Describing a few steps
that reproduce the problem is especially helpful.
Jamal
----------
Homer Editor
Public Beta
April 3, 2007
Copyright 2007 by Jamal Mazrui
GPL License
Contents
Introduction
Editing
Navigating
Querying
Managing Files
Miscellaneous
Script Manager Specifics
----------
Introduction
HomerKit is a free, open source set of tools to aid the development of
scripts for the JAWS screen reader (version 6.2 and above). It includes
an extensive library of functions written in the JAWS scripting language.
Functions promote access and productivity by JAWS users and script
developers by exploiting MSAA (Microsoft Active Accessibility), the
Windows Script Host, and the Win32 API. The library is demonstrated by
its application to create a consistent and convenient interface for
certain editors that are based on a RichEdit control: JAWS Script
Manager, WordPad, and NoteTab Light, wich is freely available at
http://www.NoteTab.com
Homer features also work in Notepad with files under 64K in size.
The source code is based primarily in two files: Homer.jss, containing
general purpose routines, and Editor.jss, containing RichEdit and user
interface oriented routines. A small utility, IniForm.exe, facilitates
dynamic creation of dialogs that are not otherwise possible in the JAWS
scripting language.
Application-specific code is contained in the files Script Manager.jss,
WordPad.jss, NoteTab.jss, and Notepad.jss. Essentially, the editor
interface for these applications is a subset of commonly used features of
the TextPal editor, available at
http://www.EmpowermentZone.com/palsetup.exe
The Homer library will be documented separately for script developers
based on feedback, questions, and suggestions that help to refine it.
Homer editor features, the focus of this guide, may be explained in the
following categories: editing, navigating, querying, managing files, and
miscellaneous.
----------
Editing
As usual, you may press Control+C or Control+X to copy or cut selected
text to the clipboard. The Homer interface tries to make an an
intelligent guess when no text is selected. In this case, the current
line is assumed . Press Alt+C or Alt+X to perform a copy or cut operation
that appends rather than replaces text on the clipboard.
An alternative way of selecting text uses F8 to mark the start of a
selection. Navigate to the end point by whatever means (arrow keys, find
command, etc.) without having to hold down the Shift key. Press Shift+F8
to select text from the marked point. Homer says the number of characters
selected.
Press Control+F8 to copy all text to the clipboard with a single command.
Press Control+Space to select a chunk of text at the cursor position. A
chunk is defined as a contiguous sequence of non-space characters. It may
be more than what Control+Shift+RightArrow selects, since such word
movement commands stop at punctuation marks. Press Control+Space again to
extend the selection to the next chunk.
As usual, Control+V pastes clipboard text at the cursor position. Press
Control+Shift+V to insert the content of another file. Press Control+N to
start a new document, or Control+Shift+N to initialize one with clipboard
text.
Press Control+R to replace text and hear the number of matches. Press
Control+Shift+R to replace with a "regular expression" -- a complex but
powerful syntax that permits almost any transformation of text. Homer
replaces within selected text, or all text if there is no selection.
Press Control+Shift+E to extract parts of text based on a regular
expression. The matching parts are placed in a new editing window
separated by a configurable, divider sequence of characters.
As usual, Delete (without a selection) deletes a character in the forward
direction, and Backspace deletes backward. Control+Delete deletes forward
by a word, and Control+Backspace deletes backward. Control+Shift+Delete
deletes from the cursor to the end of the line, and
Control+Shift+Backspace deletes from the cursor to the start of the line.
Alt+Shift+Delete deletes from the cursor to the end of the document, and
Alt+Shift+Backspace deletes from the cursor to the top of the document.
Alt+Backspace deletes the current line. After deleting, Homer reads the
new character, word, or line at the cursor.
----------
Navigating
Press Home or End to go to the start or end of the line, and automatically
hear the character there. Press Alt+Home or Alt+End to go to the first or
last non-blank character of the line. Press Control+Home or Control+End
to go to the top or bottom of the document, and automatically hear the
line there.
As usual, Control+F finds text in a forward direction. Control+Shift+F
reverses the search. F3 repeats forward, and Shift+F3 repeats backward.
Press Control+J to jump to a line, or Alt+J to repeat the jump with the
previous number.
Press Alt+RightArrow or Alt+LeftArrow to read by sentence. Press
Alt+DownArrow or Alt+UpArrow to read by paragraph.
----------
Querying
Use the Address command, Alt+A or Alt+Delete, to hear the line, column,
and percent position of the cursor in the document. As usual, JAWSKey+T
says the title of the editing window. Press Alt+P to hear the full path
of the current file on disk. Press Alt+Shift+P to copy the path to the
clipboard, permitting it to be easily pasted into dialogs of other
aplications. Press Control+Shift+P to copy to the clipboard a list of
files that match a wildcard pattern yu specify.
Press Alt+F8 to hear the whole document without moving the cursor. Use
the Quote Clipboard command, Alt+Apostrophe, to hear the textual content
of the clipboard. Press Shift+Space (or the usual
JAWSKey+Shift+DownArrow) to hear selected text. Use the Yield command,
Alt+Y, to hear the number of bytes, words, and lines in the document.
----------
Managing Files
Press Alt+R to open a file from the list of those recently used. Press
Control+L to add the current file to the list of favorites. Press
Control+Shift+L to remove it from that list. Press Alt+L to open a file
from the list of favorites.
Press Control+K to set a bookmark at the cursor position. Press
Control+Shift+K to clear the bookmark (one per file). Press Alt+K to go
to the bookmark.
As usual, press Control+S to save. Press Control+Shift+S to Save As,
giving the document a new name in the editor and on disk. Press
Alt+Shift+S to save a copy of the document under a different name while
keeping the original name in the editor.
----------
Miscellaneous
Press Control+W to turn word wrap on, or Control+Shift+W to turn it off.
Press Alt+Shift+O to adjust editor options. Use the Manual Options
command, Alt+Shift+M, to directly edit additional options provided by
these JAWS scripts.
Press F4 to activate an editing window from a list of those currently
open. Use the Alternate Menu command, Alt+F10, to execute a script from
an alphebetized list of those available. Press JAWSKey+H to read a hot
key summary in the JAWS virtual viewer, or Alt+Shift+H to read it in an
editing window. Press JAWSKey+H twice quickly to display this help guide
in a web browser.
Press F1 to load documentation for the application, or Alt+F1 just to
confirm its version (the about box). Use the Elevate Scripts command,
JAWSKey+Control+F11, to update HomerKit to the current version available
at
http://www.EmpowermentZone.com/kitsetup.exe
----------
Script Manager Specifics
JAWS Script Manager supports the features described except for word
wrapping. As usual, F2 goes to the next function or script, and Shift+F2
goes to the previous one. Control+I inserts a function, Control+Shift+I
inserts a script, and Control+D adds documentation.
Using Homer, delete the current script with Control+Shift+D instead of
Control+Delete. Select it with Control+Shift+Space instead of Control+R.
Press Control+O to open a user file, or Control+Shift+O for a shared file.
Press Control+S to save a user file, or Control+Shift+S for a shared file.
You can quickly open either Windows Explorer or a command prompt in
particular directories. Press Alt+0 for Windows Explorer in the JAWS
program folder, or Control+0 to open a command prompt there. Press Alt+1
for Windows Explorer in the user script folder, or Control+0 for a command
prompt there. Press Alt+2 for Windows Explorer in the All Users folder,
or Control+0 for a command prompt there.
Press JAWSKey+F5 to refresh text in an editing window containing a .jss,
.jsd, or .jkm file. If a .jss file (JAWS script source), Homer will sort
the routines alphabetically, and place functions before scripts. If a
.jsd file (JAWS script dictionary), Homer will generate a new script
dictionary based on the .jss file with the same base name, preserving
existing Synopsis and Description entries. If a .jkm file (JAWS key map),
Homer will sort the key assignments alphabetically by script name.
** To leave the list, click on the immediately-following link:-
** [mailto:guispeak-request@xxxxxxxxxxxxx?subject=unsubscribe]
** If this link doesn't work then send a message to:
** guispeak-request@xxxxxxxxxxxxx
** and in the Subject line type
** unsubscribe
** For other list commands such as vacation mode, click on the
** immediately-following link:-
** [mailto:guispeak-request@xxxxxxxxxxxxx?subject=faq]
** or send a message, to
** guispeak-request@xxxxxxxxxxxxx with the Subject:- faq
Other related posts:
