Merge ffd41f2 into b47fdc5

Emil-18 · web-flow · commit 515b7df2a7f7 · 2024-07-03T11:59:32.000Z
diff --git a/source/NVDAObjects/__init__.py b/source/NVDAObjects/__init__.py
@@ -308,6 +308,18 @@ def findOverlayClasses(self, clsList: typing.List[typing.Type["NVDAObject"]]) ->
 
 	beTransparentToMouse=False #:If true then NVDA will never consider the mouse to be on this object, rather it will be on an ancestor.
 
+	def objectFromPointRedirect(self, x, y):
+		"""Redirects NVDA to another object if this object is retrieved from on screen coordinates.
+		@param x: the x coordinate.
+		@type x: int
+		@param y: the y coordinate.
+		@type y: int
+		@return: The object that NVDA should be redirected to.
+		@rtype: L{NVDAObject}
+		"""
+		return None
+
+
 	@staticmethod
 	def objectFromPoint(x,y):
 		"""Retrieves an NVDAObject instance representing a control in the Operating System at the given x and y coordinates.
@@ -320,7 +332,12 @@ def objectFromPoint(x,y):
 		"""
 		kwargs={}
 		APIClass=NVDAObject.findBestAPIClass(kwargs,relation=(x,y))
-		return APIClass(chooseBestAPI=False,**kwargs) if APIClass else None
+		obj = APIClass(chooseBestAPI=False,**kwargs) if APIClass else None
+		if not obj: return
+		redirect = obj.objectFromPointRedirect(x,y)
+		if redirect:
+			obj = redirect
+		return obj
 
 	@staticmethod
 	def objectWithFocus():
diff --git a/user_docs/en/changes.md b/user_docs/en/changes.md
@@ -109,6 +109,8 @@ It is especially useful to read the error location markers in tracebacks. (#1632
   * Table metadata can be added to an optional `brailleTables` section in the add-on manifest or to a `.ini` file with the same format found in the brailleTables subdirectory of the scratchpad directory.
   * Please consult the [braille translation tables section in the developer guide](https://www.nvaccess.org/files/nvda/documentation/developerGuide.html#BrailleTables) for more details.
 * When a `gainFocus` event is queued with an object that has a valid `focusRedirect` property, the object pointed to by the `focusRedirect` property is now held by `eventHandler.lastQueuedFocusObject`, rather than the originally queued object. (#15843)
+* It is now possible to redirect objects retrieved from on screen coordinates, by using the NVDAObject.objectFromPointRedirect method. (#16788, @Emil-18)
+  *
 * NVDA will log its executable architecture (x86) at startup. (#16432, @josephsl)
 * `wx.CallAfter`, which is wrapped in `monkeyPatches/wxMonkeyPatches.py`, now includes proper `functools.wraps` indication. (#16520, @XLTechie)
 * There is a new module for scheduling tasks `utils.schedule`, using the pip module `schedule`. (#16636)
