GitHub repository: https://github.com/paulber19/wordAccessEnhancementNVDAAddon.git
Download:
Compatibility:
Traductors: automatic translation
This add-on brings:
By default, the add-on update is done automatically shortly after NVDA starts up (between 20 and 600 seconds) and at most once a day. It is possible to deactivate this update by unchecking the option "Automatically check for updates" found in the add-on settings, menu item "Update". The add-on version can be:
By default, a stable version is updated to a more recent stable version (higher version number). But it is possible to update the current stable version with a development version of the next stable version. Just check the option "Update also release versions to development versions" located in the add-on settings, "Update" category.
A development version is updated:
The "Check for update" button in the add-on's settings, "Update" category, allows you to immediately search for an update.
The "View history" button, placed in this same category, allows you to display the history of the current version in the browser.
In the case of an automatic update and if a new version is detected, the "Update" dialog box is displayed to suggest:
In the case of an update to a stable version, the "What's new" button offers the possibility of opening, in the browser, the history of the add-on and thus being able to know the novelties of the proposed version.
This add-on has been tested with the 2019, 2016 and 2013 versions of Microsoft Word.
Warning: for the add-on to work properly, the NVDA checkbox "Use UI Automation to access Microsoft Word document controls when available" should not be checked. It can be found in the "Advanced" category of NVDA settings.
The add-on makes it possible to search and list the elements constituting the document for the following types of elements:
To do this, it installs a script which is launched using the "windows+alt+F5" command gesture.
In response to this command, the "Find Items" dialog box appears, showing:
It is possible to exit this dialog box using the "Close" button or by pressing the "Esc" key.
The "Up arrow" and "Down arrow" keys allow you to move through the list.
With the "Tab" key one arrives on the list which presents the choice of the part of the document in which it is necessary to look for the elements of the selected type.
This list offers the following choices:
By default, the preselection is made on "document".
If a part of the document is selected before activating the script, the choice "selection" is preselected. Otherwise, this choice is not in the list of choices.
The choice made,the "Enter" key in the list or the press on the "Find and display" button triggers the collection of information for the type of elements chosen, then the display of the dialog box presenting the list of collected elements.
The collection can take several seconds.
It is possible by using the "Find and copy to clipboard" button to start the collection and copy the list of collected elements with their information to the clipboard, possibly more detailed than on display.
The box that presents the list of collected elements depends on the type of object selected and has the following general form:
The "Close" button or pressing the "Esc" key closes this dialog box.
In the list, and without leaving it, it is possible:
Pressing the "space" key announces the text of the first field or, if the "Control" key is pressed simultaneously, the text of the second field.
The information common to all the elements is:
The "windows +Alt+f1" command gesture is used to display certain information about the document in a dialog box:
Depending on the number of spelling or grammar errors, the display time of the dialog box can be relatively long.
The displayed information can be copied to the clipboard using the "Copy to clipboard" button in the dialog box.This script is presented in the "Microsoft Word text editor: accessibility enhancement" category of the NVDA "Command gestures" dialog.
This script is launched using the "alt + numpad delete" (desktop computer configuration) or "alt + delete" (laptop computer configuration) gesture.
In response to this command, is announced as appropriate:
In all cases, the position relative to the left edge and the top edge of the page is announced.
The line number is relative to the page and the column number is relative to the beginning of the line.
A double press of the input gesture displays this information on the screen.
The add-on installs a script to facilitate element insertion at the cursor position. The supported item types are:
It is launched using the "windows+alt+f2" input gesture.
In response to the command, a dialog box appears presenting:
After selecting the desired type, the "Enter" key or the "Insert" button displays the dialog box for entering the text of the element.
The text can be on multiple lines.
The "OK" button validates the entry.
The "Cancel" button or the validation without text causes the return to the previous dialog.
For a comment, if a selection is present, the commented text is the text of this selection. Otherwise it is the word in focus.
The add-on installs scripts to read certain items at the cursor position. Those are:
If there are no elements, a voice message announces it.
For text modifications, the type, author and text of the modification are announced. There can be multiple changes to the cursor position.
The add-on allows the automatic reading of certain elements (comments, footnote, endnote, text revision) when moving line by line, in navigation mode or in "say all".
This is controlled by the settings of the "Automatic reading" category of the add-on settings dialog.
In this category are:
To read the elements with another voice, you must first save the speech settings of this voice using the "windows+alt+f12" input gesture. This input gesture corresponds to the script "Record automatic reading voice's settings " and is editable using the NVDA "Input gestures" dialog.
In order to easily find this voice and possibly modify some of its parameters, it is advisable to create a configuration profile which will be activated manually.
Under this profile, it is then possible to define voice and speech settings using the "Speech" category of the NVDA settings dialog.
Once this is done, the NVDA configuration should be saved.
In Word and in order to save the voice settings for automatic reading , this profile must be activated manually. Hitting the "windows+alt+f12" input gesture will perform the recording.
Once the recording is done, the profile can then be deactivated manually to find the voice parameters of the active configuration profile before manual activation of the profile.
The "Activate automatic reading" option can be changed using the "Activate or desactivate automatic reading" script associated with the "windows+alt+F3" input gesture.
This input gesture can be changed using the "Input gestures" NVDA dialog.
This script is located in the "Microsoft Word text editor: accessibility enhancement" category of this dialog.
The add-on installs scripts with their input gesture to announce the elements composing a table (cell, row, column) without needing to move the cursor.
Those are:
Depending on the "column headers" option in the "Document formatting" category of NVDA settings, the cell content is announced alone or with the row and column titles.
These scripts are shown in the "Microsoft Word text editor: accessibility enhancement" category of the NVDA "Command Gestures" dialog.
It is possible to have all the cells of the row or columns announced when using the previous command gestures.
The script "activate or desactivate the report of all cells of row or column" is launched using the "windows+alt+space" input gesture.
This script is presented in the "Microsoft Word text editor: accessibility enhancement" category of the NVDA "Command Gestures" dialog.
Thus, if the announcement of all cells is activated, by typing:
To deactivate the announcement of all cells, simply type the "windows+alt+space" command gesture again.
The add-on installs the following scripts to move around table:
After moving:
Using "Input gestures" NVDA dialog, it is possible to define their own input gestures for them.
These scripts are shown in the "Microsoft Word text editor: accessibility enhancement" category of the "Input Gestures" NVDA dialog.
The add-on allows to modify the gestures of commands of the previous scripts which requires the combination of several keys in order to use only the direction keys for the movements.
To do this, simply type the "NVDA+e" command gesture to activate the command layer for array.
So after activating the command layer for table, the command gestures of the movement scripts are replaced by:
These scripts are then presented in the "Microsoft Word text editor: accessibility enhancement (command layer for array)" category of the "Input gestures" NVDA dialog.
To deactivate the command layer for array, just type "NVDA+e" again, or simply type "escape".
The "windows+alt+h" input gesture is used to find out the title of the row and of the column for the current cell.
In a table, it is possible to move from cell to cell by tabulation but at the end of the table, any new tabulation causes the creation of a new row. To prevent this, the add-on adds the arrival announcement in the first or last cell of the table.
To move quickly in the document, NVDA offers a navigation mode that can be activated and deactivated using the "NVDA + space" input gesture. When this mode is activated, it is no longer possible to type text in the document.
Each type of element is associated with a single key on the keyboard. By pressing this key the cursor is placed on the next element of the same type. By typing this same key with the capital letter pressed, the cursor is positioned on the previous element of the same type.
These commands are common to other applications such as Internet browsers.
This add-on adds the following commands specific for Microsoft Word.
Unsupported navigation mode commands are indicated by the voice message "Not supported in this document" and all other commands by a beep.
The inability to move the cursor is signaled by a voice message indicating that there is no longer any element corresponding to the command.
The add-on adds the possibility of browsing in a loop, that is to say to return to the beginning or the end of the document, to continue the search for the next or previous element.
The "Browse in loop" option in the "Options" category controls this possibility.
The types of elements associated with these new commands are added to the list of types in the "List of elements" dialog opened by "NVDA + F7".
For some types like "misspelled word", "grammar error", searching for items can be quite long.
The search time is therefore limited to 20 seconds by default. This maximum time can be changed using the "Maximum item search time" drop-down list in the "Options" category of the add-on settings.
When the focus is positioned in the document, the "f7" key (Word shortcut) either starts the spell checker,either to return to it if it is already started and the "Escape" key allows you to return to the document when the focus is in the spell checker.
The add-on gives the possibility to also use the "f7" key to perform the same action as the "Escape" key.
Contrary to what NVDA vocalizes, when launching the corrector for the first time, the focus may not be positioned where it should be, ie inside the pane and on one of its buttons or lists. This is why the add-on may require you to hit the "tab" key before anything else.
As neither the error nor the suggestion is announced by NVDA when the focus arrives in the spell checker, the add-on tries to fix it.
A script allows this information to be announced.
The "NVDA+shift+f7" input gesture is assigned to it:
The "NVDA+control+f7" input gesture allows you to hear the sentence affected by the error again.
These scripts are shown in the "Microsoft Word text editor: accessibility enhancement" category of the "Input Gestures" NVDA dialog.
This add-on also allows the automatic announcement of the new error and its suggestion presented by the spell checker following the use of one of the buttons like "Ignore", "Modify" or Word shortcuts like "i", "m ".
In a Word document, NVDA provides the ability to move from paragraph to paragraph using the "Control + downArrow" or "Control + upArrow" commands.
But the focus is given to the preceding or following paragraph regardless of its content.
This add-on offers the possibility of blowing up empty paragraphs and giving focus to the first non-empty paragraph found.
The "Skip empty paragraphs" option in the "Options" category enables or disables this operation.
By default, this option is checked. Empty paragraphs are ignored.
It is also possible, at any time, to activate or deactivate this operation using the "windows + alt + f4" input gesture.
NVDA provides the ability to move the system cursor from sentence to sentence with the following input gestures:
But they are only operational in edit mode and not in browse mode.
To remove this limitation, the add-on replaces them with new scripts using the same command gestures.
These new scripts are shown in the "Microsoft Word text editor: accessibility enhancement" category of the "Input Gestures" NVDA dialog.
The version history of this add-on is in the file "changes.html"