Merge 23015fd into f1c73d1

CyrilleB79 · web-flow · commit fd7192e8787a · 2023-10-13T07:09:37.000+10:00
diff --git a/source/NVDAObjects/UIA/wordDocument.py b/source/NVDAObjects/UIA/wordDocument.py
@@ -607,3 +607,21 @@ def script_reportCurrentComment(self,gesture):
 			# Translators: a message when there is no comment to report in Microsoft Word
 			ui.message(_("No comments"))
 		return
+
+	@script(gesture="kb:NVDA+shift+c")
+	def script_setColumnHeader(self, gesture):
+		ui.message(_(
+			# Translators: The message reported in Microsoft Word for document types not supporting setting custom
+			# headers.
+			"Command not supported in this type of document. "
+			"The tables have their first row cells automatically set as column headers."
+		))
+
+	@script(gesture="kb:NVDA+shift+r")
+	def script_setRowHeader(self, gesture):
+		ui.message(_(
+			# Translators: The message reported in Microsoft Word for document types not supporting setting custom
+			# headers.
+			"Command not supported in this type of document. "
+			"The tables have their first column cells automatically set as row headers."
+		))
diff --git a/user_docs/en/userGuide.t2t b/user_docs/en/userGuide.t2t
@@ -1138,8 +1138,11 @@ NVDA provides its own extra features  for some applications to make certain task
 
 +++ Automatic Column and Row Header Reading +++[WordAutomaticColumnAndRowHeaderReading]
 NVDA is able to automatically announce appropriate row and column headers when navigating around tables in Microsoft Word.
-This firstly requires that the Report Table row / column headers option in NVDA's Document Formatting settings, found in the [NVDA Settings #NVDASettings] dialog, be turned on.
-Secondly, NVDA needs to know which row or column contains the headers in any given table.
+This requires that the Report Table row / column headers option in NVDA's Document Formatting settings, found in the [NVDA Settings #NVDASettings] dialog, be turned on.
+
+If you use [UIA to access Word documents #MSWordUIA], that is, by default, in recent versions of Word and Windows, the cells of the first row will automatically be considered as column headers; similarly, the cells of the first column will automatically be considered as row headers; 
+
+On the contrary, if you do not use [UIA to access Word documents #MSWordUIA], you will have to indicate to NVDA which row or column contains the headers in any given table.
 After moving to the first cell in the column or row containing the headers, use one of the following commands:
 %kc:beginInclude
 || Name | Key | Description |
