Component.xml: document the GetAccessibleAtPoint method

1 files changed, 20 insertions, 0 deletions

diff --git a/xml/Component.xml b/xml/Component.xml
index 29c50a1b..3d7e2e47 100644
--- a/xml/Component.xml
+++ b/xml/Component.xml
@@ -28,6 +28,26 @@
       <arg direction="out" type="b"/>
     </method>
 
+    <!--
+        GetAccessibleAtPoint:
+        @x: X coordinate of point.
+        @y: Y coordinate of point.
+        @coord_type: Whether the coordinates are relative to the screen or to the
+        component's top level window; see the description.
+
+        Gets a reference to the accessible object that contains an (x, y) pair of
+        coordinates.
+
+        The @coord_type values are as follows, and correspond to AtkCoordType:
+
+        0 - Coordinates are relative to the screen.
+        1 - Coordinates are relative to the component's toplevel window.
+        2 - Coordinates are relative to the component's immediate parent.
+
+        Returns: A DBus name and object reference (so) for the sought object, or a null
+        object reference "/org/a11y/atspi/null" if there is no object at the specified
+        coordinates.
+    -->
     <method name="GetAccessibleAtPoint">
       <arg direction="in" name="x" type="i"/>
       <arg direction="in" name="y" type="i"/>