Component.xml: document the GetPosition method

1 files changed, 15 insertions, 0 deletions

diff --git a/xml/Component.xml b/xml/Component.xml
index ec4f0904..411dbe87 100644
--- a/xml/Component.xml
+++ b/xml/Component.xml
@@ -78,6 +78,21 @@
       <annotation name="org.qtproject.QtDBus.QtTypeName.Out0" value="QSpiRect"/>
     </method>
 
+    <!--
+        GetPosition:
+        @coord_type: Whether the coordinates are relative to the screen or to the
+        component's top level window; see the description.
+
+        Queries the upper-left position of a component.
+
+        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: (x, y) coordinates of the component's upper-left corner.
+    -->
     <method name="GetPosition">
       <arg direction="in" name="coord_type" type="u"/>
       <arg direction="out" name="x" type="i"/>