Changeset 1490 for trunk/autoquest-core-events/src/main/java/de/ugoe/cs/autoquest/eventcore/guimodel/IGUIElement.java

Timestamp:

04/07/14 08:42:08 (10 years ago)

Author:

pharms

Message:

• added support and initial implementation of a platform specific distance measure between GUI elements

File:

• trunk/autoquest-core-events/src/main/java/de/ugoe/cs/autoquest/eventcore/guimodel/IGUIElement.java (modified) (1 diff)

trunk/autoquest-core-events/src/main/java/de/ugoe/cs/autoquest/eventcore/guimodel/IGUIElement.java

@@ -109 +109 @@
      */
     public void addEqualGUIElement(IGUIElement equalElement);
+
+    /**
+     * <p>
+     * Returns a measure for the distance of this {@link IGUIElement} to the provided one. Distance
+     * means a measure for the distance in display of the rendered GUI. The returned values must be
+     * between 0.0 and 1.0 inclusive. 0.0 means no distance, e.g., if the distance to itself shall be
+     * returned. 1.0 means the highest distance possible. Two GUI elements that are not visible
+     * at the same time independent of the screen resolution (e.g., because they resist in separate
+     * views) must have a distance of at least 0.5.  
+     * </p>
+     * 
+     * @param guiElement
+     *            the GUI element to measure the distance for
+     */
+    public double getDistanceTo(IGUIElement otherElement);
 }