Skip to content

add unassigned command to report the status of screen curtain#19767

Merged
seanbudd merged 4 commits intonvaccess:masterfrom
makhlwf:screen-curtain-report
Mar 18, 2026
Merged

add unassigned command to report the status of screen curtain#19767
seanbudd merged 4 commits intonvaccess:masterfrom
makhlwf:screen-curtain-report

Conversation

@makhlwf
Copy link
Copy Markdown
Contributor

@makhlwf makhlwf commented Mar 10, 2026

Link to issue number:

Resolves #19759

Summary of the issue:

users needs a way to know what the current status of screen curtain is
. Previously , Users had to check the NVDA settings or perform the shortcut NVDA+CTRL+ESC to know what is the current status of the screen curtain if it is activated or deactivated.

Description of user facing changes:

Now, users can assign a new custom shortcut that when it is performed will allow the users to get a notification with the current status of the screen curtain .

Description of developer facing changes:

None

Description of development approach:

Added a new intrys with an if check in /source/globalCommands.py, and added new entrys in the changes and the user docs files

Testing strategy:

tested locally

Known issues with pull request:

None

Code Review Checklist:

  • Documentation:
    • Change log entry
    • User Documentation
    • Developer / Technical Documentation
    • Context sensitive help for GUI changes
  • Testing:
    • Unit tests
    • System (end to end) tests
    • Manual testing
  • UX of all users considered:
    • Speech
    • Braille
    • Low Vision
    • Different web browsers
    • Localization in other languages / culture than English
  • API is compatible with existing add-ons.
  • Security precautions taken.

@seanbudd seanbudd added the conceptApproved Similar 'triaged' for issues, PR accepted in theory, implementation needs review. label Mar 17, 2026
Comment thread user_docs/en/userGuide.md Outdated
Added a new entry for reporting the state of the screen curtain and clarified the usage of gestures in the user guide.
Comment thread source/globalCommands.py
Comment thread user_docs/en/userGuide.md Outdated
Copy link
Copy Markdown
Member

@Qchristensen Qchristensen left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reads well.

@seanbudd seanbudd merged commit da83845 into nvaccess:master Mar 18, 2026
38 of 41 checks passed
@github-actions github-actions Bot added this to the 2026.2 milestone Mar 18, 2026
@makhlwf makhlwf deleted the screen-curtain-report branch March 18, 2026 02:35
CyrilleB79 pushed a commit to CyrilleB79/nvda that referenced this pull request Mar 18, 2026
…command:

- Move this command from Vision to Misc. category
- Make this command available in on-demand speak mode.
seanbudd pushed a commit that referenced this pull request Mar 18, 2026
…19809)

Fix-up of #19767
Summary of the issue:

PR #19767 has introduced a command to report the state of the screen curtain.

    In the Input gesture dialog, this command has been put in Vision category; that is not consistent with the screen curtain toggle command which is in the Miscellaneous category.
    This new command does nothing else than reporting an information, so it should be speaking when used in on-demand speech mode. Today, it does not.

Description of user facing changes:

    In the Input gestures dialog, the "Reports the state of the screen curtain." command is now in the Miscellaneous category, as the toggle screen curtain command. Note that Screen curtain is not a visual aid, and as such, does not belong to Vision category, neither in Input gestures dialog, nor in the settings dialog.
    The command to report the state of the screen curtain now also speaks when in on-demand speech mode.

Description of developer facing changes:

None
Description of development approach:

    Removed the "category" parameter of the @script decorator so that the command lands in misc. category.
    Passed the speakOnDemand=True argument to the @script decorator.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

conceptApproved Similar 'triaged' for issues, PR accepted in theory, implementation needs review.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Provide a shortcut for informing user about current state of screen curtain

4 participants