Suppress duplicate Visual Studio tooltips

source/NVDAObjects/UIA/VisualStudio.py

@@ -7,10 +7,11 @@
 available in Visual Studio and SQL Server Management Studio.
 """
 
-from . import UIA
+from . import UIA, ToolTip
 import speech
 import braille
 import api
+import time
 
 
 class IntelliSenseItem(UIA):
@@ -53,6 +54,32 @@ class IntelliSenseLiveRegion(UIA):
 }
 
 
+class CompletionToolTip(ToolTip):
+	""" A tool tip for which duplicate open events can be fired.
+	"""
+
+	_lastToolTipOpenedInfo = (None, None)  #: Keeps track of the last ToolTipOpened event (text, time)
+	_preventDuplicateToolTipSeconds = 0.2  #: The duplicate tooltip events will be dropped within this time window
+
+	def event_UIA_toolTipOpened(self):
+		oldText, oldTime = self._lastToolTipOpenedInfo
+		newText = self.name
+		newTime = time.time()
+		self.__class__._lastToolTipOpenedInfo = (newText, newTime)
+		withinPossibleDupToolTipTimeWindow = (
+			oldTime is not None
+			and (newTime - oldTime) < self._preventDuplicateToolTipSeconds
+		)
+		if newText == oldText and withinPossibleDupToolTipTimeWindow:
+			# Tool-tip event suspected to be a duplicate, drop the event.
+			# - Users attempting to rapidly re-announce tool-tips may
+			#   have the announcement erroneously  suppressed
+			# - Users on slower systems (or systems under load) may still
+			#   receive duplicate announcements
+			return
+		super().event_UIA_toolTipOpened()
+
+
 def findExtraOverlayClasses(obj, clsList):
 	if obj.UIAAutomationId in _INTELLISENSE_LIST_AUTOMATION_IDS:
 		clsList.insert(0, IntelliSenseList)
@@ -64,3 +91,5 @@ def findExtraOverlayClasses(obj, clsList):
 		and isinstance(obj.previous.previous, IntelliSenseList)
 	):
 		clsList.insert(0, IntelliSenseLiveRegion)
+	elif obj.UIAAutomationId == "completion tooltip":
+		clsList.insert(0, CompletionToolTip)