Add script to toggle mouse audio coordinates (#19026) (#19282)
Fixes #19026
Summary of the issue:
This PR adds a new global script script_toggleMouseAudioCoordinates in globalCommands.py.
The script:
Appears in the Mouse category of the Input Gestures dialog.
Toggles the existing mouse/audioCoordinatesOnMouseMove configuration value using toggleBooleanValue.
Announces “Mouse audio coordinates on/off” when toggled.
No default gesture is assigned in code.
Users can bind any gesture they like from NVDA menu → Preferences → Input gestures… → Mouse.
Description of user facing changes:
Adds a new script in the Mouse category of the Input Gestures dialog that allows users to assign a gesture to toggle mouse audio coordinates (beeps that report mouse location).
There is no behavior change unless a user assigns a gesture.
Description of developer facing changes:
-Adds script_toggleMouseAudioCoordinates to GlobalCommands in globalCommands.py.
Uses the existing toggleBooleanValue helper to toggle config.conf["mouse"]["audioCoordinatesOnMouseMove"].
No changes to public APIs or configuration schema.
Description of development approach:
Reuse the existing toggleBooleanValue helper to avoid duplicating toggle logic and messages.
Only globalCommands.py is updated; no new settings or gesture defaults are added.
Testing strategy:
Ran NVDA from source using runnvda.bat.
Opened Preferences → Input gestures… → Mouse.
Confirmed that a new script “Toggles beeps that report mouse coordinates as the mouse moves” is present.
Assigned a temporary gesture (e.g. NVDA+Shift+M) and verified that:
The gesture toggles the “Play audio coordinates when mouse moves” option.
NVDA reports “Mouse audio coordinates on/off”.
