Skip to content

Indicate that setting column/row headers in Word tables does not work for UIA#15617

Merged
seanbudd merged 3 commits into
nvaccess:masterfrom
CyrilleB79:docTable
Oct 16, 2023
Merged

Indicate that setting column/row headers in Word tables does not work for UIA#15617
seanbudd merged 3 commits into
nvaccess:masterfrom
CyrilleB79:docTable

Conversation

@CyrilleB79

@CyrilleB79 CyrilleB79 commented Oct 12, 2023

Copy link
Copy Markdown
Contributor

Link to issue number:

Fixes #13006

Summary of the issue:

UIA has become the default in Word for people with recent versions of Word and running Windows 11. When they try to set the column/row headers in tables with NVDA+shift+C/R, the command does not work and they are confused.
The first row and the first column are however automatically treated as headers.

Description of user facing changes

Following the discussion in #13006, ^more specifically #13006 (comment), and considering that:

  • the headers are usually in the first row or column in of the tables,
  • Some work is needed on Microsoft's side to make our traditional headers work with UIA,
    it has been decided to accept and document this limitation of being able to have headers only on the first row/column.

Thus the User Guide has been updated.

Also, in Word documents when using UIA, NVDA+shift+C/R now report an information so that user know that these commands are not supported nor needed anymore.

Notes:
When this fix is released in a stable release, we can evaluate if this information is enough for people or if they keep on asking the old way to manage column/row headers; we can then consider reopening #13006 (or opening a new similar issue) if needed.

Description of development approach

Two script added in the class for Word UI§A documents. These script have no description since they do not need to be discovered nor remapped in the Input gesture dialog. They're just here to give information to people trying to use the old way to handle row/column headers.

Testing strategy:

  • Check that the error message is reported in UIA Word Document
  • Check that the headers script still works normally in IAccessible Word documents
  • Check the UG

Known issues with pull request:

A similar issue exists for Excel. However, since UIA is still experimental in Excel, there is no point in adding confusion in the Excel paragraph of the User Guide.
Thus, the similar issue is not documented for Excel.

Change log entry

Not needed.

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.

@AppVeyorBot

Copy link
Copy Markdown

See test results for failed build of commit dba6fb04f2

@AppVeyorBot

Copy link
Copy Markdown

See test results for failed build of commit fd7192e878

@CyrilleB79 CyrilleB79 marked this pull request as ready for review October 12, 2023 22:22
@CyrilleB79 CyrilleB79 requested review from a team as code owners October 12, 2023 22:22
Comment thread user_docs/en/userGuide.t2t Outdated
Co-authored-by: Sean Budd <seanbudd123@gmail.com>

@Qchristensen Qchristensen left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Userguide looks good.

@seanbudd seanbudd merged commit 28c9d53 into nvaccess:master Oct 16, 2023
@nvaccessAuto nvaccessAuto added this to the 2024.1 milestone Oct 16, 2023
@CyrilleB79 CyrilleB79 deleted the docTable branch October 18, 2023 07:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Cannot set column & row headers in Word using UIA

5 participants