The following is documentation for the QuickBook macros found
under the settings directory of JFW.  These macros were
designed for Quick Books 3.0.  Portions of this
documentation is not applicable for later versions of Quick
Books.

README FILE FOR QUICKBOOKS MACROS 
01/12/96 
 
 
     This chapter contains information for setting up
QuickBooks so that it will be compatible with JAWS macros.  It
provides instructions for using the JAWS macros that have been
provided for use with QuickBooks, and offers troubleshooting
assistance for situations where the macros don't seem to work
properly. 
 
 
 
CONTENTS 

1.   SETTING UP THE QUICKBOOKS APPLICATION WINDOW 
2.   POWER KEYS FOR WORKING WITH QUICKBOOKS 
     2.1  Identify Active Edit Field or Button 
          = {ALT+CONTROL+I} 
     2.2  Read QuickBooks Cue Card 
          = {ALT+CONTROL+H} 
     2.3  Automatically Read Important Information as You Move
          Between QuickBooks Options 
          = {TAB} and {SHIFT+TAB} 
3.   PUSH BUTTON KEYS FOR FINDING OK, CANCEL, PRIOR RECORD,
     AND OTHER BUTTONS 
4.   TIPS FOR LEARNING ABOUT QUICKBOOKS WINDOWS 
5.   TROUBLESHOOTING TIPS 
 
__________

1.   SETTING UP THE QUICKBOOKS APPLICATION WINDOW 
 
     The use of the QuickBooks macros requires that QuickBooks
be properly set up with respect to the window display. 
Additionally, various QuickBooks graphic buttons must be
properly labeled by the JAWS Graphics Wizard before the macros
can function properly.  Follow these steps to set up
QuickBooks and JAWS properly. 
 
1.   Start Windows, JAWS for Windows, and QuickBooks. 
 
2.   If you have any windows in QuickBooks that were saved  in
     an open state from previous QuickBooks sessions, then
     close them all.  After closing all windows in QuickBooks,
     you should be left with the QuickBooks initial display,
     which shows the QuickBooks program name and a menu bar. 
 
3.   Maximize the QuickBooks main application Window, if it
     has not already been maximized. 
 
5.   Press {CONTROL+A} to display the QuickBooks Chart of
     Accounts.  You can also choose Chart of Accounts from the
     QuickBooks Lists menu. 
 
6.   Maximize the Chart of Accounts Window. 
 
7.   Choose the QuickBooks Preferences menu and the View
     dialog.  Set the items in this dialog as shown below. 
 
Save Current Desktop = checked (required) 
Don't Show Icon Bar = checked (optional) 
     This removes extra information from the desktop that some
     people find objectionable.  An alternative is to check
     "Text Only", which displays the icon bar with text
     buttons instead of the usual graphic buttons. 
Hide Cards for All Windows = not checked (required)  
     When this item is left unchecked, all cue cards are
     displayed.  The cue cards describe the specific use of
     almost all edit fields and push buttons in QuickBooks. 
 
8.   Press the OK button to save the settings in the View
     dialog. 
 
9.   Make an optional change in the Data Entry dialog of the
     Preferences menu regarding the use of the ENTER key. 
     Save your new setting by choosing the OK button.  
 
Pressing ENTER Moves between Fields = checked 
     Some users of QuickBooks prefer to use the ENTER key as a
     "TAB KEY" to prevent recording transactions when they
     might accidentally press ENTER. 
 
10.  Without closing the Chart of Accounts window, exit
     QuickBooks. 
 
11.  Now, when you restart QuickBooks, the Chart of Accounts
     will automatically be displayed on the desktop whenever
     the program starts.  If the Chart of Accounts window is
     not present when QuickBooks starts, then QuickBooks
     macros cannot initialize themselves properly, and the
     macros will not perform as intended. 
 
12.  Start QuickBooks again so that you can label graphic
     buttons.  If the graphic buttons listed below have not
     already been labeled by Henter-Joyce, then use the JAWS
     Graphics Wizard to label them.  You will need to label
     the buttons if you find that when you use the JAWS cursor
     to read the desktop, you  hear things such as "graphic
     132", "graphic 619", etc..  This  means that the graphic
     buttons have not been labeled.  Be sure to use lowercase
     letters and to type the labels exactly as shown when
     using the Graphics Wizard. 
 
132 = ok button 
619 = cancel button 
550 = previous record button 
345 = next record button 
135 = checked 
74  = checked 
840 = not checked 
296 = not checked 
732 = help button 
48  = hide cards button 
739 = print dialog button 
700 = account 
 
 
 ________
 
2.   POWER KEYS FOR WORKING WITH QUICKBOOKS 
 
Identify Active Edit Field or Button = {ALT+CONTROL+I} 
Read QuickBooks Cue Card = {ALT+CONTROL+H} 
Automatically Read Important Information as You Move Between
     QuickBooks Options = {TAB} and {SHIFT+TAB} 
 
     There are three macro keys that offer tremendous power to
QuickBooks users.  They are described below.  With these keys,
and a little knowledge of Windows and accounting, it is
possible to learn to use QuickBooks with minimal frustration. 
 
2.2  Identify Active Edit Field or Button 
     = {ALT+CONTROL+I}  
 
     QuickBooks sometimes uses a caret symbol as the cursor,
such as in Edit fields.  At other times, QuickBooks uses
highlighting to point to a button, and at other times error
dialogs pop up and take control of the desktop.  Thus, JAWS
follows the "focus" of QuickBooks wherever it may go. 
 
     This macro uses logic to find and speak the information
in the QuickBooks window that has "the focus".  If the focus
is in an edit field, then the macro reads the field.  If the
focus is on a push button, then the macro identifies the push
button and places the JAWS cursor on it.  You can then
activate the JAWS cursor and push the button or change its
checked/unchecked status by pressing the left mouse button. 
If the focus is on an error dialog, then you can read the
dialog with this macro key.  JAWS always knows what to do and
how to do it. 
 
 
2.2  Read QuickBooks Cue Card = {ALT+CONTROL+H} 
 
     One of the most powerful features of QuickBooks is its
system of "cue cards".  These cards contain brief statements
about the edit field, push button, or check button that has
the focus.  Every time you change the focus in Quickbooks by
moving to a different field or button by using the {TAB} or
{SHIFT+TAB}, a new cue card is displayed.  This macro is used
to read the entire contents of these cards.  If you wish, you
can activate the JAWS cursor after using this macro and read
the card more carefully.  The JAWS cursor is automatically
placed at the beginning of text in the cue card when the macro
is used.  If a cue card is not presently being shown on the
desktop, then JAWS tells you that the cue card is empty or not
shown. 
 
 
2.3  Automatically Read Important Information as You Move
     Between QuickBooks Options 
     = {TAB} and {SHIFT+TAB} 
 
     When you press {TAB} to advance to the next field or
button, or press {SHIFT+TAB} to move back to the prior field
or button, you can receive substantial information about the
QuickBooks field or button that has the focus.  JAWS speaks
differing amounts of information depending on the current JAWS
verbosity setting.  
 
Verbosity = Beginner
     When verbosity is set to "beginner", and you press the
{TAB} or {SHIFT+TAB}, then JAWS does the following. 
1.   The QuickBooks focus moves to a new edit field or button.
     
2.   JAWS automatically speaks the cue card if one is
     displayed. 
3.   JAWS indicates if the focus is on a button.
4.   JAWS reads the contents of edit fields when a cue card is
     not displayed for the field. 

     Information can be repeated by using the {ALT+CONTROL+H}
and the {ALT+CONTROL+I} macros.  Use these macros at any time
to read the cue card or to locate the QuickBooks focus. 
 
Verbosity = Intermediate
     When verbosity is set to "intermediate", then JAWS
discontinues the automatic reading of cue cards.  The other
activities identified above for the "beginner" verbosity
setting are still performed. Information about the field or
button with the focus can be repeated at any time by using the
{ALT+CONTROL+I} macro.  The {ALT+CONTROL+H} macro can always
be used to read the cue card even though it is not being
spoken automatically. 
 
Verbosity = Advanced
     When verbosity is set to "advanced", then JAWS speaks the
least amount of information when the {TAB} and {SHIFT+TAB}
keys are used.  JAWS speaks the most important information and
lets QuickBooks users decide when they want additional
information.  The {ALT+CONTROL+H} and the {ALT+CONTROL+I} are
used to read the cue card or to locate the QuickBooks focus as
needed. 
 
 
 _________
 
3.   PUSH BUTTON KEYS 
 
     In addition to the QuickBooks menu bar and the optional
tool bar, Quickbooks employs the use of a variety of push
buttons to perform frequently used activities.  It is always
possible to use the {TAB} or the {SHIFT+TAB} to move to these
buttons, but this is usually quite slow.  You may have to make
your way through 15 or 20 stops before you reach the button
you want to choose.  We have provided macros to find and push
the buttons that are used most frequently.  The push button
macros automatically move the JAWS cursor (and the mouse
pointer) to a specific button and then push it by simulating
the clicking of the left mouse button.  The push button macro
keys are listed below. 
 
Read List of QuickBooks Macro Keys = {ALT+CONTROL+L} 
Push OK Button = {ALT+CONTROL+O}  
Push Cancel Button = {ALT+CONTROL+C} 
Push Next Record Button = ALT+CONTROL+N}  
Push Previous Record Button = {ALT+CONTROL+P}  
Push Print Dialog Button = {ALT+CONTROL+D} 
Push To Be Printed Button = {ALT+CONTROL+T}  
Push Maximize Window Button = {ALT+CONTROL+X} 
 
 
_________
 
4.   TIPS FOR LEARNING ABOUT QUICKBOOKS WINDOWS 
 
     To acquire greater familiarity with the organization of
information in QuickBooks windows, you will find three
standard JAWS macro keys to be of particular value. 
 
Say Line = {INSERT+UP ARROW} 
     When pressed once, it reads the edit field or title bar
     that has the focus.  Typically, one of the edit fields
     always displays a caret symbol to indicate that it has
     the focus.  The caret symbol remains in the edit field
     even when the focus shifts to a push button.  For
     example, you can move between a series of edit fields and
     successfully read the fields with the {INSERT+UP ARROW}. 
     However, when the focus shifts to a push button, the
     {INSERT+UP ARROW} continues to read the most recently
     used edit field.  This is because QuickBooks continues to
     display a caret even though it has given the true focus
     to a push button.  This is not a significant problem
     because the {ALT+CONTROL+I} macro will always find the
     QuickBooks location that has the real focus.  
 
          If the {INSERT+UP ARROW} is pressed twice within a
     half second, then it performs a second function.  It
     reads the information that is to the left and to the
     right of the edit field that has the focus.  The
     information to the left of the edit field often contains
     a prompt.  However, the most reliable prompt information
     is obtained by using the {ALT+CONTROL+H} macro which
     reads the cue card. 
 
Say To Cursor = {INSERT+HOME} 
Say From Cursor = {INSERT+PAGE UP} 
     These two macros help with orientation by giving a
     context to the location of the edit field with the focus. 
     They do this by separately speaking information that is
     to the left or to the right of the cursor. 
 
Activate JAWS Cursor = {SPEECH PAD MINUS} 
     The JAWS cursor can be freely used to read around the
     desktop.  Please note, it is not possible to find and
     read the cue card by manually moving the JAWS cursor to
     the cue card window.  To read the cue card with the JAWS
     cursor, you must use the {ALT+CONTROL+H} macro.  This
     macro automatically places the JAWS cursor on the cue
     card and reads it.  Once the JAWS cursor has been placed
     on the text of the cue card, then the JAWS cursor can be
     activated and used to read the card.  
 
 
________
 
5.   TROUBLESHOOTING TIPS 
 
     This section explains steps that can be followed when
JAWS and QuickBooks are not working well together.   
 
Situation A:  JAWS keeps saying that cue cards are not shown
when the {TAB} is pressed. 
 
     If QuickBooks was set up properly as described in Section
1 of this chapter, then it is possible that the cue cards
could have been accidentally turned off.  This could happen
when the Cue Card button on the tool bar was mistakenly
clicked or when {CONTROL+F1} was pressed.  The {CONTROL+F1} is
the QuickBooks command that toggles cue cards on and off.  Use
this command or click the Cue Card button and then try reading
the cue card with {ALT+CONTROL+H}.  You may also wish to
double check the Hide Cue Cards check box in the View dialog
of the Preferences menu to be sure it is not checked. 
 
Situation B:  I here an error message that tells me that
QuickBooks is not set up properly to work with JAWS macros. 
 
     This will happen for two reasons.  If you didn't follow
the steps in the Setup section of this chapter, then JAWS will
not be able to find cue cards and it will speak an error
message.  When you follow the steps in the Setup section, then
the error message should no longer be spoken.  If the setup
steps were followed correctly and the problem persists, then
use the {ALT+CONTROL+SHIFT+H} macro to initialize the
QuickBooks cue card handle variable.  JAWS uses the window
handle in this variable to find and read cue cards. 
 
Situation C:  Information seems jumbled and doesn't get spoken
in an organized manner. 
 
1.   Check to be sure the QuickBooks window that you are
     currently using has been maximized.  The JAWS macros will
     usually maximize QuickBooks windows automatically.  If a
     window needs to be maximized, then you can use the
     {ALT+CONTROL+X} macro to maximize the window.  When
     windows are not maximized, then information is sometimes
     not read correctly.  
 
2.   If information seems like it is becoming distorted after
     working in QuickBooks for a while, then use the JAWS
     Screen Refresh macro to fix the JAWS memory display. 
     Press {INSERT+ESCAPE} to refresh the desktop. 
 
Situation D:  Sometimes when the push button macros are used I
get the error message that the button could not be found. 
 
     There are two possible causes for this situation.  First,
the button you are trying to use may not be currently
displayed on the desktop.  All QuickBooks windows do not
display all buttons.  It is also possible that the window
needs to be maximized to display the buttons properly. 
 
