Merge c8d38c7 into 4c50375

Emil-18 · web-flow · commit 90c40420a637 · 2024-07-04T11:06:09.000Z
diff --git a/source/NVDAObjects/__init__.py b/source/NVDAObjects/__init__.py
@@ -316,6 +316,16 @@ 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: int, y: int) -> "NVDAObject | None":
+		"""Redirects NVDA to another object if this object is retrieved from on screen coordinates.
+		:param x: the x coordinate.
+		: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.
@@ -326,9 +336,15 @@ def objectFromPoint(x, y):
 		@return: The object at the given x and y coordinates.
 		@rtype: L{NVDAObject}
 		"""
-		kwargs = {}
-		APIClass = NVDAObject.findBestAPIClass(kwargs, relation=(x, y))
-		return APIClass(chooseBestAPI=False, **kwargs) if APIClass else None
+		kwargs={}
+		APIClass=NVDAObject.findBestAPIClass(kwargs,relation=(x,y))
+		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)
