Enhance Microsoft Word Comment Command: Press Twice to Present Comment Content in Browsable message.

source/NVDAObjects/IAccessible/winword.py

@@ -317,8 +317,11 @@ def script_caret_moveByCell(self, gesture: inputCore.InputGesture) -> None:
 		braille.handler.handleCaretMove(self)
 
 	@script(
-		# Translators: a description for a script
-		description=_("Reports the text of the comment where the system caret is located."),
+		description=_(
+			# Translators: a description for a script
+			"Reports the text of the comment where the system caret is located."
+			"If pressed twice, presents the information in browse mode."
+		),
 		gesture="kb:NVDA+alt+c",
 		category=SCRCAT_SYSTEMCARET,
 		speakOnDemand=True,
@@ -338,7 +341,15 @@ def script_reportCurrentComment(self,gesture):
 					except COMError:
 						break
 					if text:
-						ui.message(text)
+						repeats = scriptHandler.getLastScriptRepeatCount()
+						if repeats == 0:
+							ui.message(text)
+						elif repeats == 1:
+							ui.browseableMessage(
+								text,
+								# Translators: title for Word comment dialog.
+								_("Comment")
+							)
 						return
 		# Translators: a message when there is no comment to report in Microsoft Word
 		ui.message(_("No comments"))

source/NVDAObjects/UIA/wordDocument.py

@@ -12,6 +12,7 @@
 import enum
 from comtypes import COMError
 import mathPres
+import scriptHandler
 from scriptHandler import isScriptWaiting
 import textInfos
 import UIAHandler
@@ -611,15 +612,27 @@ def _caretMoveBySentenceHelper(self, gesture, direction):
 	@script(
 		gesture="kb:NVDA+alt+c",
 		# Translators: a description for a script that reports the comment at the caret.
-		description=_("Reports the text of the comment where the system caret is located."),
+		description=_(
+			# Translators: a description for a script that reports the comment at the caret.
+			"Reports the text of the comment where the system caret is located."
+			" If pressed twice, presents the information in browse mode"
+		),
 		category=SCRCAT_SYSTEMCARET,
 		speakOnDemand=True,
 	)
 	def script_reportCurrentComment(self,gesture):
 		caretInfo=self.makeTextInfo(textInfos.POSITION_CARET)
 		commentInfo = getCommentInfoFromPosition(caretInfo)
 		if commentInfo is not None:
-			ui.message(getPresentableCommentInfoFromPosition(commentInfo))
+			text = getPresentableCommentInfoFromPosition(commentInfo)
+			repeats = scriptHandler.getLastScriptRepeatCount()
+			if repeats == 0:
+				ui.message(text)
+			elif repeats == 1:
+				ui.browseableMessage(text,
+					# Translators: title for Word comment dialog.
+					_("Comment")
+				)
 		else:
 			# Translators: a message when there is no comment to report in Microsoft Word
 			ui.message(_("No comments"))

user_docs/en/changes.md

@@ -6,6 +6,9 @@
 
 ### New Features
 
+* Microsoft Office:
+  * Enhance Microsoft Word Comment Command: Press Twice to Present Comment Content in Browsable message. (#16800, @Cary-Rowen)
+
 ### Bug Fixes
 
 ### Changes for Developers

user_docs/en/userGuide.md

@@ -1488,6 +1488,7 @@ The Elements List can list headings, links, annotations (which includes comments
 
 <!-- KC:beginInclude -->
 To report any comments at the current caret position, press NVDA+alt+c.
+Pressing twice shows the information in a window.
 <!-- KC:endInclude -->
 All comments for the document, along with other tracked changes, can also be listed in the NVDA Elements List  when selecting Annotations as the type.