Using the JAWS Scripts For DMR
Doug Lee
Last Revised October, 2023
This Guide provides tips for using DMR with JAWS For Windows and these scripts.
When the scripts are installed and DMR is open and focused, this document can be
opened via a double press of JAWSKey+F1 (or Insert+F1).
These scripts officially follow the AccessibleGD77CPS code branch but also endeavor to support older
DMR incarnations and, though untested, OpenGD77CPS branches.
For simplicity, the application, in its various forms, will be referred to in this documentation as DMR.
Table of Contents
System Requirements For JAWS Users
These scripts require JAWS 17.0 or later.
Script Installation Instructions
To install these scripts on a new system:
- Install JAWS if this has not already been done. This will require
administrative privileges on the computer.
- Run JAWS as the user for whom the scripts are to be installed.
This and the following steps must be performed for each user of the computer
who will be using JAWS with these scripts.
- Download and run, or run directly, the installer for
these scripts; and follow the on-screen
directions. Be sure to install the scripts in the currently running
JAWS version if a JAWS version list is presented.
- To verify successful installation, type Insert+Q from
within the application. Part of the JAWS spoken response should be a
revision number. If you do not hear a revision number, the scripts are
not correctly loaded.
In some cases, restarting JAWS may fix this issue.
Using DMR With JAWS and the Scripts
This section and its subsections provide tips for using DMR with JAWS and these scripts.
Native DMR Keyboard Shortcuts
DMR provides several keyboard shortcuts. These work with or without JAWS or these scripts.
- F2 on a treeView node, such as a contact name, will allow you to rename the node.
- Ctrl+F4 closes an open dialog page, such as Basic Information.
- The menu bar's expected shortcuts work, such as Alt+S for the Settings menu.
JAWS Script Commands and Features
The scripts provide the following features:
- When the application opens, and when the last open dialog page is closed such as with Ctrl+F4,
focus is automatically moved to the treeView for convenience.
- Space or Enter on a treeView node double-clicks the node. This permits opening dialog
pages from the tree.
- The Menu or Applications key on a tree node with a context menu opens the menu. This permits,
for example, adding entries to a list such as Contacts.
This also applies to Shift+F10, which otherwise opens the System menu in this application as
Alt+Space normally does.
The Menu key may also work in other situations in this application because of script code, though
this will not likely apply to Shift+F10.
Other Resources
Russell Breitenstein (KN4MLR) prepared a
42-minute podcast audio tutorial on programming
the GD77s
using this application with these scripts.
The link provided here is to a copy of the file on this author's website, posted because the original May,
2019 Dropbox link is no longer valid.
Known Issues
Issues shown in this section may be fixed in future script and/or application
revisions but are not addressed as of this writing.
Some fields in various dialog pages are unlabeled or mislabeled according to JAWS.
Revision History
This section presents the revision history of these scripts, most recent revision first.
Revision 39, October 21, 2023, tested against AccessibleGD77 CPS version 1.1.7
- The "Copy Rx freq to Tx freq" button in the channel dialog is named by JAWS.
- The field naming code is more efficient in general.
- The scripts are compiled against JAWS 17.0, the already-established minimum JAWS version supported, rather
than JAWS 13.0.
- The UIA support is refactored significantly and updated to account for recent increases in JAWS' UIA support.
A JAWS restart after installing this script update is recommended, though not required.
This refactor is being applied to several projects.
Users who use several of this author's script sets may notice a slight reduction in JAWS' memory consumption as
these updates progress.
- By popular vote, old history entries in this document section are now hidden inside a
details
tag
that may be expanded to show them. Among the benefits of this, heading count is reduced and text searches won't
match very old material.
Revision 31, June 10, 2022, tested against AccessibleGD77 CPS version 1.1.7
- These scripts now officially follow the AccessibleGD77CPS code branch but also endeavor to support older
DMR incarnations and, though untested, OpenGD77CPS branches.
JAWS should be restarted after this installer runs, so that changes to the JAWS
ConfigNames.ini
file will be properly detected.
- The minimum supported JAWS version is changed from 12.0 to 17.0.
- The link in the Other Resources section of this document now points to a local copy of
Rus's audio tutorial, because the original May, 2019 Dropbox link is no longer valid.
- The messages for these scripts are now distributed in XML rather than jsm files so that translators can
create translations with no need for script source recompilation.
See the Script Translation Procedure document for details on
how to translate these scripts, including how to update the XML message file.
- The installer contains version and product information visible from the Details tab in Windows Explorer,
to better identify its contents. This update is being applied to all projects.
- A "directives" text file is included that provides information on how to install this set of scripts manually.
See "Handling Directives Files" in the "Common
Script Elements" document for further information.
Revision 16, May 29, 2019
- Fixed the installer from trying to recompile the scripts even though they were already compiled and installed.
Revision 15, May 15, 2019
- A link to Russ's tutorial podcast on programming the GD-77s using this application and these scripts is
included in the script users guide.
- The distributed scripts are compiled with JAWS 12 rather than 17, to remain consistent with the posted
minimum JAWS version requirement.
- Source code to the scripts is no longer included. See my Script
Distribution Policy document for details. As one side effect, this will cause installation to run much faster.
2 older revisions back through August 9, 2018
Revision 9, September 16, 2018
Fixed left and right click locations for some tree items, which fixes the Menu key, Space,
and Enter on some tree items.
Revision 8, August 9, 2018
Initial script release.