Indication of sleep mode in object

Author: Cooper Wooten

Why this change was made:

• According to this issue: the base functionality of the NVDA software is that sleep mode disables nearly all functionality within that application. This means that if the user has one application in sleep mode and selects it after using another application, there is no indication that the sleeping object has gained the focus. This is an issue if you are a non-visual user.

The form used to make this change:

• The sleepObjGainFocusIndicator.py file is a globalPlugin created for the NVDA project. In this project, appModules are made to be active only in specific applications while globalPlugins are made to be active as long as NVDA is running, regardless of the application. As this feature aims to add functionality to NVDA as a whole, a globalPlugin was chosen as the form in which the feature would take.

How to use this addon:

• While in an object that has sleep mode on (sleep mode can be toggled by NVDA+shift+z for laptop configuration or NVDA+shift+s for desktop configuration), the gesture NVDA+alt+a produces an indication. This will only activate if the object that holds focus has sleep mode active. By default, the gesture will produce a beep. If speech is more preferable to the user, then NVDA+alt+b can be used to toggle between beeping and speaking. The speech mode announces the name of the object along with the command to turn off sleep mode in case the user had turned sleep mode on by accident.