Add NOTIFYING API level for future work/debugging

nvaccess · Feb 4, 2022 · 8812a1d · 8812a1d
1 parent 08ffe3f
commit 8812a1d
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 0 deletions.
diff --git a/source/UIAHandler/constants.py b/source/UIAHandler/constants.py
@@ -82,3 +82,6 @@ class WinConsoleAPILevel(enum.IntEnum):
 	# Represents an IMPROVED console that exposes text formatting and a
 	# buffer that does not contain extraneous empty lines.
 	FORMATTED = 2
+	# Represents a console that sends UIA notification events for new text,
+	# making NVDAObjects.behaviors.LiveText unnecessary.
+	NOTIFYING = 3
diff --git a/source/UIAHandler/utils.py b/source/UIAHandler/utils.py
@@ -326,6 +326,16 @@ def _getConhostAPILevel(hwnd: int) -> WinConsoleAPILevel:
 		textArea = UIAElement.buildUpdatedCache(
 			textAreaCacheRequest
 		).getCachedChildren().GetElement(0)
+		if (
+			textArea.getCurrentPropertyValueEx(
+				UIAHandler.UIA.UIA_LiveSettingPropertyId,
+				False
+			)
+			== UIAHandler.UIA.Polite
+		):
+			# microsoft/terminal#12358: modern consoles send UIA notification
+			# events for new text.
+			return WinConsoleAPILevel.NOTIFYING
 		UIATextPattern = textArea.GetCurrentPattern(
 			UIAHandler.UIA_TextPatternId
 		).QueryInterface(UIAHandler.IUIAutomationTextPattern)