Elements list is now available in Microsoft Word straight away without having to enable browse mode first

[michaelDCurran]

Link to issue number:

Fixes #12050

Summary of the issue:

Documentation for NVDA stated that Elements list (NVDA+f7) was available in focus mode. Although this wa strue for web documents and Excel, it was missed for Microsoft Word.

Description of how this pull request fixes the issue:

A treeInterceptor is now created for Microsoft Word documents (both with UIA enabled or disabled) but the treeInteceptor is defauled to focus mode. Thus Elements list is available straight away. This is the exact same approach as taken by the treeInterceptor for Microsoft Excel.

Testing strategy:

Manual testing done:

• Ensured UIA in Microsoft Word document controls was disabled in NVDA's davanced settings.
• Opened Microsoft Word.
• Typed a line of text and formatted it as a heading with shift+alt+rightArrow
• Pressed NVDA+f7 to bring up the Elements list.
• Restarted NvDA.
• Enabled UIA in Microsoft Word document controls in NVDA's advanced settings.
• Typed a line of text and formatted it as a heading with shift+alt+rightArrow
• Pressed NVDA+f7 to bring up the Elements list.

In theory a system test could be created for this, however this would require appveyor vms including Microsoft Word, which is something we would need to look into in the future.
I don't believe unit tests really apply to this kind of infrastructure change.

Known issues with pull request:

This change means that a treeInterceptor is now always created for Word documents. Although Word document treeInterceptors are not in any way heavy (they don't cache much at all) it is still a change which could affect the lifetime of treeInterceptors or other objects in NVDA.
I think this is very low risk, but either this needs to be tested on another rc for a while by heavy users of Microsoft Word, or we hold off until 2021.1 and make an edit to the 2020.4 documentation excluding Microsoft Word.

Change log entry:

None needed.

Code Review Checklist:

This checklist is a reminder of things commonly forgotten in a new PR.
Please do a self-review to check these items.
Reviewers will not approve the PR until these are met.

• Pull Request description is up to date.
• Unit tests.
• System (end to end) tests.
• Manual tests.
• User Documentation.
• Change log entry.
• Context sensitive help for GUI changes.

[LeonarddeR]

Have you tested this with the "Enable browse mode on page load" browse mode setting disabled? It should work fine, but just in case it doesn't...

[michaelDCurran]

NV Access has decided that this is too large of a change so close to a release. Thus it has now been rebased on master for NVDA 2021.1.
The work-around in Microsoft Word is simply to press NVDA+space twice to force browse mode and go back to focus mode, then elements list will be available in focus mode.

[feerrenrut]

Looks good to me.