The following is documentation for the Dragon Dictate macros
found under the settings directory of JFW.

For JFW support of Dragon Dictate 2.5, observe these steps.

1.  Make sure that you are using JFW 2.00.x.
2.  Import JAWS.DDX through Dragon Dictate's Vocabulary
Menu.  For more information, see page 150 [Importing
Vocabularies] in Dragon Dictate for Windows User's Guide.

For more information on the following two steps, see page
163 [Adding and Using Hot Keys] in Dragon Dictate for
Windows User's Guide.  These steps keep Dragon Dictate from
conflicting with the commonly used PC and JawsCursor toggle
buttons.

3.  Reassign the "Set Mic On/Off Key button" to the Pause key.
4.  Reassign the "Set Run Script Key" to the Scroll Lock key.
5.  Open the default file in the configuration wizard.  Go
    to Set Options, User Options, and set the Insert Key
    Mode checkbox to checked to enable the StickyInsert
    capability in JFW.
6.  Remove/Remark the "BackSpace" macro in JFW_KEY1.JMH by
    placing a semicolon at the beginning of each line.  Save
    the file after making changes.  The macro should look
    like the following when finished:

;macrobegin {backspace}
;var
;	int TheTypeCode
;
;let TheTypeCode = GetWindowSubtypeCode (GetCurrentWindow())
;If ((TheTypeCode == WT_TREEVIEW) || (TheTypeCode == WT_LISTVIEW)) then
;	{backspace}
;	return
;else
;	SaveCursor ()
;	RouteInvisibleToPc ()
;	InvisibleCursor ()
;	PriorCharacter ()
;	SayCharacter ()
;	RestoreCursor ()
;	{backspace}
;endif
;MacroEnd

7.  Add the Dragon related text to the Text event macro in
    JFW_KEY1.JMH.  Don't forget to recompile the macro as shown
    in step 3 of HELPFUL HINTS.

The completed macro should look like the following:

MacroBegin {Text}(int hwnd,string buffer)
var
string TheClass
let TheClass = GetWindowClass(hwnd)

	if ((GetScreenEcho() > 1)
;wn36="#32771"
	|| (TheClass == wn36 )) then
;******* For use with Dragon Dictate
If (GetControlID (hwnd) == 204) then
	SayString (buffer)
	return
EndIf
;*******

SayString(buffer)
EndIf
MacroEnd

8.  Start Jaws for Windows
9.  Start Dragon Dictate


After completing each of the above steps, the following Jaws
for Windows functions can be voice activated using Dragon
Dictate.

*Down:                      Move down and say line
*Left:                      Move Left and Say Character
*Right:                     Move and Say Next Character
*Select Line:               Selects Current Line
*Select (n) Line:           Selects n lines
*Up:                        Move up and say line
*Word [Right/Left] n:       Moves n words to the right or left
Change Screen Echo          Changes the screen echo settings.  These
            			    settings are restored when Jaws is reloaded.
Change Verbosity            Changes the verbosity settings.  These settings
			                are restored when Jaws is reloaded.
Graphics Wizard             Starts Graphics Wizard
Jaws Macro File             Says the Macro File currently in use
Minimize this Window        Minimize current window
Maximize this Window        Maximize current window
Next Word:                  Move and say to Prior word
Prior Word:                 Move and say to next word
Refresh Screen              Refreshes the Screen
Say Active Cursor           Says the cursor currently in use
Say All:                    Says from the cursor line to bottom of document.
			                Useful in reading documents and even the word
			                options list box
Say Character:              Say Current Character
Say Default Button          Says the default button in a dialog box
Say From Cursor:            Says from cursor to end of line
Say To Cursor:            Says from beginning of line to cursor
Say Hot Keys                Says the Hot keys in a dialog box
Say Line:                   Says Current Line
Say Selected Text:          Says the selected text in the current window
Say To Cursor:              Says from beginning of line to cursor
Say Title                   Says the title of the real window that
Say Word:                   Say Current Word
Say Word in Context         Says selected word in context
Screen Sensitive Help       Insert+f1 function
Select Word:                Selects from cursor to end of word
Select Character:           Selects next character if no text is already selected
*Select Next Character:           Selects next character if some text is already highlighted
Select Prior Word:          Selects from cursor to beginning of word
*Select Prior Character:     Selects prior character if no text is selected
Select To End Of Line:      Selects From Cursor To End Of Line
Select From Start of Line:  Selects from Start of Line to the cursor
Shut Up:                    Stops speech
Spell Word:                 Spell Current Word
Unload Jaws                 Unloads Jaws

*Dragon Macros


HELPFUL HINTS

Following are helpful hints in running Jaws for Windows with
Dragon Dictate. If you have comments that you would like to
add to this section, please e-mail them to Henter-Joyce via
jaws@hj.com or leave a message to the Sysop on our BBS
(813-803-8002).

1.  Adding a new user in Dragon Dictate is NOT hands free.
    Once the user begins the Quick Training section, the
    process becomes hands free.

2.  Turning on the Microphone is NOT hands free.  For the
    user's convenience, we suggest assigning the Microphone
    toggle button to the Pause key in the upper right hand
    corner of the extended keyboard.

3.  You may notice that when choosing words from the Word
    Choice list box, Dragon is unable to completely remove
    the incorrect word before placing the desired word in a
    document.  This can be remedied by removing the
    backspace macro from the running application's macro
    file.  If you have already removed the backspace macro
    and are still noticing errors in this functionality,
    please consider the following:

    When a jmh (Jaws Macro Header) file is changed, its
    parent file must also be compiled.  For example, after
    making a change to JFW_KEY1.JMH, it should be saved.
    Notice that the Macro Editor does not post a compile
    message.  This is because JMH files are not compiled.
    After saving your changes to the JMH file, open
    JFW_DESK.JMS.  When browsing through the included file
    lines, you will run across the line, Include
    "JFW_KEY1.JMH."  This means that, when the Macro Editor
    compiles this JMS file, it will include the source from
    JFW_KEY1.JMH.  Any changes made to JFW_KEY1.JMH will not
    take effect until JFW_DESK.JMS is compiled.

    Note:  When using a laptop computer, JFW_LAP.JMS is the
    parent file for JFW_KEY1.JMH.  When making changes to
    JFW_KEY1.JMH, make sure that you recompile JFW_LAP.JMS.


4.  Setting particular Jaws for Windows options can maximize
    the amount of feedback that the user receives from
    Dragon Dictate.  For example, if Typing Interrupt and
    Reading Interrupt are turned off, Jaws is able to repeat
    commands as they are writing in Dragon's "Recognized
    Words/Commands" window.

5.  When running JFW with Dragon Dictate, Typing Echo should
    be set to Off, and Screen Echo should be set to Echo
    Highlighted Text.  When Dragon Dictate receives voice
    input, it places the recognized word(s) on the Voice
    Bar.  JFW then speaks the word from the Voice Bar. These
    settings can be changed on the fly by using the [Change
    Screen Echo].  These settings can be permanently changed
    through the Options menu in the JFW application window.

Even though the Choice List and the Word History List look
very similar, they are different types of windows.  The
Choice List can be switched to "Spell Mode" which allows the
user to pass commands to the window.  This mode is
automatically evoked in the Word History List.  As a result,
the JFW functions are available in both Choice List and Word
History (say word, say all, spell word, up arrow, etc.).
However the you are not able to tell which word you are on
(i.e. Word 2, Word 3, etc,) when in word history.  You can
figure this out if you are clever enough with routing the
JAWS cursor and none of your words are mis-recognized by
Dragon. I will be working on this and believe this is a
problem we will soon overcome.  For a thorough description
of commands available in this list, see Using Oops and the
Word History on pages 38-43 of the Dragon Dictate for
Windows User's Guide.----------
