Repository navigation
Allow "report notifications" to toggle UIA notification announcements #10956
Description
Hi,
A more generic request (see #10626 for specifics):
Is your feature request related to a problem? Please describe.
IN Windows 10 Version 1709/IUIAutomation5, UIA notification event was introduced to let screen readers such as NVDA and Narrator announce useful information. This is used in various apps, including:
- File Explorer: volume and brightness changes
- Microsoft Edge (classic and Chromium)L page loads
- Microsoft Store: app updates
- Alarms and Clock: stopwatch functions
- Word 365: editing functions
Although UIA notification announcements are important, they can become annoying, particularly when announcements are repeated in quick succession. For example, as discussed in #10626, whenever a user changes volume, UIA notification event is fired by File Explorer to announce new values every time volume up/down buttons are pressed. Similarly, as documented in #10851, certain editing functions in recent Word 365 releases present results via UIA notification message.
Describe the solution you'd like
As discussed in #10626, let "report notifications" checkbox in object presentation settings panel toggle UIA notification announcement as well. This may mean redefining what a notification is in the user guide. The obvious advantage of this change is ability to configure app-specific profiles to silence UIA notifications, but this change won't solve notifications coming from background processes (Microsoft and app vendors must be reminded about using this event under specific circumstances).
Describe alternatives you've considered
Two alternatives:
- Leave it as is.
- Introduce a dedicated control to toggle UIA notification announcements.
Additional context
For practical issues, see #10626, #10851, and #10950 (the last one is important for translators as it will result in double speaking and/or odd text being announced for editing functions as opposed to what translators specified for earlier Word releases).
Thanks.
Activity
CyrilleB79 commentedon Apr 8, 2020
In File Explorer, also Wifi enabling/disabling is reported when using dedicated HW button.
The problem with explorer is that it is a program that serves for all, not only the file manager.
It would be logical to have Explorer notifications such as Wifi, volume and brightness changes announced from everywhere since they are not specific to the explorer file management window.
However IMO volume announcement should be silenced when an audio stream is already playing (multimedia, NVDA speaking, etc) since it is annoying, as described in #10626.
I hope this comment is at a correct place, it deals with various aspects of UIA notification and I did not know exactly in which issue I should leave this comment.
josephsl commentedon Apr 8, 2020
josephsl commentedon Sep 10, 2020
Hi,
A few months later...
JAWS 2021 implements the second alternative from above: a dedicated checkbox inside Settings Center to toggle UIA notification announcement. Given that UIA notifications are really meant for AT's and are quite different than typical notifications such as ones shown in Action Center, I propose implementing a dedicated checkbox (only visible if Windows 10 Fall Creators Update/Version 1709 or later) to toggle this.
Thanks.
Config: add 'report UIA notifications' key to presentation section. Re …
NVDAObjects/UIA: do not handle UIA notification events unl3ess told t…
Object presentation settings panel: add accessible event notification…
Report accessible events: disable this setting if using Windows relea…
User guide: add a paragraph on report accessible event notifications …
Confspec: change UIA notification announcement setting to an option. Re
NVDAObjects.UIA: do not announce notifications if the setting is off …
Object presentation settings: convert 'report accessible event notifi…
User guide: update accessible event notifications section to include …
Confspec: 'report accessible event notifications' default value is no…
NvDAObjects.UIA: swap notification condition checks for focused app. Re
Object presentation settings: 'focused app' -> 'when application in f…
User guide: focused app -> when application in foreground to align wi…
NVDAObjects/UIA: clarify focused app check syntax. Re nvaccess#10956.
Settings/UIA notification: contextualize UIA notification event optio…
Object presentation and user guide: report accessible event notificat…
josephsl commentedon Feb 5, 2021
Hi,
Update: based on #11590 discussion, a more generalist approach would be better:
The biggest advantage is that it is future-proof - UIA notifications can be treated as app notifications just like alerts in web browsers. So if the accompanying PR is successful, it will open up opportunities to let contributors take advantage of the new settings.
To help with feature discoverability, I think a new property should be added to NVDA objects to specify if an object should report notifications and alerts if raised (separate issue).
Thanks.
NVDAObjects.UIA: use new app notifications settings to handle UIA not…
GUI/object presentation panel: rename notification values to 'app not…
josephsl commentedon Jun 4, 2025
Hi,
June 2025 update: I'm abandoning this as the object attribute idea to direct NVDA to announce UIA notifications will not work if the UIA element has no native window handle (window handle is needed to instantiate UIA NVDA object; without this, object attribute is useless).
Closing as idea abandoned. Thanks.