Link to issue number:

Closes #13036

Summary of the issue:

In #13036, the reporter needs an input gesture to quickly change the language of Windows OCR.

More generally, if a user has to modify frequently a setting for their activity, a specific command to modify this setting is more handy than always opening the settings dialog.

Description of user facing changes

A new unbound command has been added to cycle through available languages for Windows OCR. It is in the Misc category, the same as the one of the already existing command to recognize the navigator object with Windows OCR.

Description of development approach

• Made the script based on what was in the settings OCR panel
• Made the assumption that at least one language (probably English) is installed on all systems supporting UwpOCR; this assumption is already done if you read the code of the OCR settings panel and we have not had people complaining of issues.
• While at it, moved 3 isolated class variables related to screen curtain next to the related script.

Testing strategy:

Manual tests:

• Used the script and checked the result in the Windows OCR settings panel.
• Modified my config with an unsupported recognition language and checked that calling the command set the new recog language to the first supported (English in my case).

Known issues with pull request:

I have not created a command to cycle backwards through available languages since I imagine than people rarely install a long list of languages, e.g. more than 5. If we have a speicific request for this in the future, it may be easy to add it.

Change log entries:

New features
Introduced a new command to cycle through the available languages for Windows OCR. (#13036)

Code Review Checklist:

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