com.rational.test.ft.object.interfaces

Interface IGraphical

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method and Description
      void click()
      Performs a left-mouse click on the center point of the associated TestObject.
      void click(MouseModifiers modifiers)
      Performs a left-mouse click on the specified object
      void click(MouseModifiers modifiers, java.awt.Point pt)
      Performs a left-mouse click on the specified coordinates
      void click(java.awt.Point pt)
      Performs a left-mouse click on the specified coordinates
      void doubleClick()
      Performs a left-mouse double-click on the center point of the associated TestObject.
      void doubleClick(MouseModifiers modifiers)
      Performs a left-mouse double-click on the specified object
      void doubleClick(MouseModifiers modifiers, java.awt.Point pt)
      Performs a left-mouse double-click on the specified coordinates
      void doubleClick(java.awt.Point pt)
      Performs a left-mouse double-click on the specified coordinates, relative to the associated TestObject.
      void drag()
      Performs a MOUSE_LEFT drag action against the associated TestObject.
      void drag(MouseModifiers modifiers)
      Performs a drag action against the associated TestObject with the supplied set of mouse modifiers.
      void drag(MouseModifiers modifiers, java.awt.Point pt1, java.awt.Point pt2)
      Performs a drag action against the associated TestObject.
      void drag(java.awt.Point pt1, java.awt.Point pt2)
      Performs a MOUSE_LEFT drag action against the associated TestObject.
      void dragToScreenPoint(MouseModifiers modifiers, java.awt.Point objectPt, java.awt.Point screenPt)
      Performs a drag action against the associated TestObject.
      void dragToScreenPoint(java.awt.Point screenPt)
      Performs a MOUSE_LEFT drag action against the associated TestObject.
      void dragToScreenPoint(java.awt.Point objectPt, java.awt.Point screenPt)
      Performs a MOUSE_LEFT drag action against the associated TestObject.
      java.lang.Object getChildAtPoint(java.awt.Point pt)
      Finds the child object that is at the specified point.
      java.awt.Rectangle getClippedScreenRectangle()
      Returns the clipped-screen rectangle for the associated TestObject
      java.awt.Point getScreenPoint()
      Returns the screen-relative point to a valid point within the object.
      java.awt.Point getScreenPoint(java.awt.Point pt)
      Returns the screen-relative point for the point passed.
      java.awt.Rectangle getScreenRectangle()
      Returns the rectangle that contains the component being evaluated.
      boolean hasFocus()
      Determine's whether the component under evaluation has keyboard focus.
      void hover()
      Hovers the mouse over the center of the associated TestObject.
      void hover(double secondDelay)
      Hovers the mouse over the center of the associated TestObject.
      void hover(double secondDelay, java.awt.Point pt)
      Hovers the mouse over the specified coordinates of the associated TestObject.
      void hover(java.awt.Point pt)
      Hovers the mouse over the specified coordinates of the associated TestObject.
      boolean isEnabled()
      Determine's whether the component under evaluation is enabled.
      boolean isOpaque()
      Determine's whether the component under evaluation is opaque.
      boolean isPointInObject(java.awt.Point pt)
      Determines whether the specified screen-relative point is contained in the component under evaluation.
      boolean isShowing()
      Determine's whether the component under evaluation is showing.
      void mouseMove(MouseModifiers modifiers, java.awt.Point pt)
      Performs a Move action against the associated TestObject.
      void mouseMove(java.awt.Point pt)
      Performs a MOUSE_LEFT move action against the associated TestObject.
      void nClick(int clickCount, MouseModifiers modifiers, java.awt.Point pt)
      Performs a mouse n-click action on the specified coordinates, relative to the associated TestCode.
      void nClickDrag(int clickCount, MouseModifiers modifiers, java.awt.Point pt1, java.awt.Point pt2)
      Performs a mouse n-click drag action on the specified coordinates, relative to the associated TestObject.
      void nClickDragToScreenPoint(int clickCount, MouseModifiers modifiers, java.awt.Point objectPt, java.awt.Point screenPt)
      Performs a mouse n-click drag action on the specified coordinates
    • Method Detail

      • isShowing

        boolean isShowing()
        Determine's whether the component under evaluation is showing.
        Returns:
        boolean - true if the component is showing; false otherwise.
        Example:

        placeOrder().isShowing();
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • isEnabled

        boolean isEnabled()
        Determine's whether the component under evaluation is enabled.
        Returns:
        boolean - true if the component is enabled; false otherwise.
        Example:
        This is an example
        placeOrder().isEnabled();
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • isOpaque

        boolean isOpaque()
        Determine's whether the component under evaluation is opaque.
        Returns:
        boolean - true if the component is opaque; false otherwise.
        Example:
        This is an example
        placeOrder().isOpaque();
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • hasFocus

        boolean hasFocus()
        Determine's whether the component under evaluation has keyboard focus.
        Returns:
        boolean - true if the component has keyboard focus; false otherwise.
        Example:
        This is an example
        placeOrder().hasFocus();
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • isPointInObject

        boolean isPointInObject(java.awt.Point pt)
        Determines whether the specified screen-relative point is contained in the component under evaluation.
        Parameters:
        point - Screen-relative point to check
        Returns:
        boolean - true if component contains thePoint; false otherwise.
        Detail description:
        This method will check whether the specified screen-relative point is contained in the component under evaluation. Note that the point is relative to the top-left corner of the screen and not to the component itself, or its parent.

        This functionality is performed by the proxy due to potentially unusual aspects associated with functionality. While typically the getScreenRectangle is used to resolve this query, this is not accurate in certain situations. For example, if the clickable region on a button is not rectangular, just checking whether the point is in the rectangle would not yield a valid result.

        Example:
        This is an example
        placeOrder().isPointInObject(new Point(25,25));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • getChildAtPoint

        java.lang.Object getChildAtPoint(java.awt.Point pt)
        Finds the child object that is at the specified point.
        Parameters:
        pt - Screen-relative point to check
        Returns:
        boolean - The object at the point, or null if no child object is found
        Detail description:
        Finds the child object that is at the specified point. Note The point is relative to the top-left corner of the screen and not to the component itself or its parent component
        Example:
        This is an example
        classicsJava().getChildAtPoint(new Point(400,325));
        Here classicsJava is of type TopLevelTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
        See Also:
        getScreenRectangle()
      • getScreenRectangle

        java.awt.Rectangle getScreenRectangle()
        Returns the rectangle that contains the component being evaluated.
        Returns:
        java.awt.Rectangle - The object at the point, or null if no child object is found
        Detail description:
        This will return the rectangle that contains the component being evaluated, relative to the top-left corner of the screen. This typically consists of two operations (getLocationOnScreen and getSize) combined into a single operation. The rectangle is exposed so that actions may be directly scripted against a visible GUI object. If the GUI object does not show, null is returned.
        Example:
        This is an example
        placeOrder().getScreenRectangle();
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
        See Also:
        isPointInObject(java.awt.Point), getClippedScreenRectangle()
      • getClippedScreenRectangle

        java.awt.Rectangle getClippedScreenRectangle()
        Returns the clipped-screen rectangle for the associated TestObject
        Returns:
        java.awt.Rectangle - The clipped screen rectangle, or null if the object cannot be seen in any window on the screen.
        Detail description:
        This will Return the clipped-screen rectangle for the associated TestObject, relative to the top-left corner of the screen. While getScreenRectangle() returns the true rectangle of the TestObject, this method clips the true screen rectangle to the bounds of any clipping parent TestObject. Clipping parents, such as scroll panes or a browser window, may hide part or all of the true screen rectangle. Only the screen-level viewable rectangle is returned, or null if the object is not showing, or is completely clipped by a clipping parent.
        Example:
        This is an example
        placeOrder().getClippedScreenRectangle();
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
        See Also:
        getScreenRectangle()
      • getScreenPoint

        java.awt.Point getScreenPoint()
        Returns the screen-relative point to a valid point within the object.
        Returns:
        java.awt.Point - The clipped screen rectangle, or null if the object cannot be seen in any window on the screen.
        Detail description:
        This will Return the point for the associated TestObject, relative to the top-left corner of the screen.This function normally return the point which is in centre of the object relative to the screen but the actual underlying implemenattion vary from component to component implementation
        Example:
        This is an example
        classicsJava().getScreenPoint();
        Here classicsJava is of type TopLevelTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • getScreenPoint

        java.awt.Point getScreenPoint(java.awt.Point pt)
        Returns the screen-relative point for the point passed.
        Parameters:
        java.awt.Point - - The point
        Returns:
        java.awt.Point - This will return the point relative to the screen
        Detail description:
        This will Return the point for the associated TestObject, relative to the relative to the top-left corner of the screen.This function normally return the point which is in centre of the object relative to the screen but the actual underlying implemenattion vary from component to component implementation
        Example:
        This is an example
        classicsJava().getScreenPoint(new Point(25,25));
        Here classicsJava is of type TopLevelTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • click

        void click()
        Performs a left-mouse click on the center point of the associated TestObject.
        Detail description:
        This will perform a left-mouse click on the centre point of the associated TestObject, relative to the This method is a shortcut to the click method with a modifier parameter. (The modifier is set to MOUSE_LEFT).
        Example:

        placeOrder().click();
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • click

        void click(MouseModifiers modifiers)
        Performs a left-mouse click on the specified object
        Detail description:
        This will perform a left-mouse click on the specified object, relative to coordinates within the associated TestObject.
        Since:
        RFT 6.1.1.1
      • click

        void click(java.awt.Point pt)
        Performs a left-mouse click on the specified coordinates
        Detail description:
        This will perform a left-mouse click on the specified coordinates, relative to the associated TestObject. This method is a shortcut to the click method with a modifier parameter and coordinates. (The modifier is set to MOUSE_LEFT).
        Example:

        placeOrder().click(new MouseModifiers(MOUSE_LEFT));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • click

        void click(MouseModifiers modifiers,
                   java.awt.Point pt)
        Performs a left-mouse click on the specified coordinates
        Detail description:
        This will perform a left-mouse click on the specified coordinates, relative to the associated TestObject. This method is a shortcut to the click method with a modifier parameter and coordinates. (The modifier is set to MOUSE_LEFT).
        Example:

        placeOrder().click(new MouseModifiers(MOUSE_LEFT),new Point(25,25));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • doubleClick

        void doubleClick()
        Performs a left-mouse double-click on the center point of the associated TestObject.
        Detail description:
        This will perform a left-mouse double-click on the center point of the associated TestObject. This method is a shortcut to the doubleClick method with a modifier parameter. (The modifier is set to MOUSE_LEFT).
        Example:

        placeOrder().doubleClick();
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • doubleClick

        void doubleClick(MouseModifiers modifiers)
        Performs a left-mouse double-click on the specified object
        Detail description:
        This will Performs a left-mouse double-click on the specified object, relative to coordinates within the associated TestObject.
        Example:

        placeOrder().doubleClick(new MouseModifiers(MOUSE_LEFT));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • doubleClick

        void doubleClick(java.awt.Point pt)
        Performs a left-mouse double-click on the specified coordinates, relative to the associated TestObject.
        Detail description:
        This will Performs a left-mouse double-click on the specified coordinates, relative to the associated TestObject. This method is a shortcut to the doubleClick method with a modifier parameter and coordinates. (The modifier is set to MOUSE_LEFT).
        Example:

        placeOrder().doubleClick(new Point(25,25);
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • doubleClick

        void doubleClick(MouseModifiers modifiers,
                         java.awt.Point pt)
        Performs a left-mouse double-click on the specified coordinates
        Detail description:
        This will Performs a left-mouse double-click on the specified coordinates, relative to the associated TestObject.
        Example:

        placeOrder().doubleClick(new MouseModifiers(MOUSE_LEFT),new Point(25,25);
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • nClick

        void nClick(int clickCount,
                    MouseModifiers modifiers,
                    java.awt.Point pt)
        Performs a mouse n-click action on the specified coordinates, relative to the associated TestCode.
        Detail description:
        This will Performs a left-mouse double-click on the specified coordinates, relative to the associated TestObject.
        Example:

        placeOrder().nClick(1,new MouseModifiers(MOUSE_LEFT),new Point(25,25);
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • drag

        void drag()
        Performs a MOUSE_LEFT drag action against the associated TestObject.
        Detail description:
        This will Perform a MOUSE_LEFT drag action against the associated TestObject. This method is used to simulate drag actions against controls that are typically not sensitive to drag actions.
        Example:

        placeOrder().drag();
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • drag

        void drag(MouseModifiers modifiers)
        Performs a drag action against the associated TestObject with the supplied set of mouse modifiers.
        Detail description:
        This will Perform drag action against the associated TestObject with the supplied set of mouse modifiers. This method is used to simulate drag actions against controls that are typically not sensitive to drag actions.
        Example:

        placeOrder().drag(new MouseModifiers(MOUSE_LEFT));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • drag

        void drag(java.awt.Point pt1,
                  java.awt.Point pt2)
        Performs a MOUSE_LEFT drag action against the associated TestObject.
        Detail description:
        This will Perform a MOUSE_LEFT drag action against the associated TestObject. The action is performed from (x1, y1) to (x2, y2) coordinates, relative to this TestObject.
        Example:

        placeOrder().drag(new Point(400,325),new Point(25,25));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • drag

        void drag(MouseModifiers modifiers,
                  java.awt.Point pt1,
                  java.awt.Point pt2)
        Performs a drag action against the associated TestObject.
        Detail description:
        This will Perform aa drag action against the associated TestObject. The action is performed from (x1, y1) to (x2, y2) coordinates, relative to this TestObject.
        Example:

        placeOrder().drag(new MouseModifiers(MOUSE_LEFT),new Point(400,325),new Point(25,25));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • nClickDrag

        void nClickDrag(int clickCount,
                        MouseModifiers modifiers,
                        java.awt.Point pt1,
                        java.awt.Point pt2)
        Performs a mouse n-click drag action on the specified coordinates, relative to the associated TestObject.
        Example:

        placeOrder().nClickDrag( 2,new MouseModifiers(MOUSE_LEFT),new Point(400,325),new Point(25,25));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • dragToScreenPoint

        void dragToScreenPoint(java.awt.Point screenPt)
        Performs a MOUSE_LEFT drag action against the associated TestObject.
        Detail description:
        This will Perform a MOUSE_LEFT drag action against the associated TestObject. The action is performed from a valid point within this TestObject to the screen-relative screenPt coordinates.
        Example:

        placeOrder().dragToScreenPoint(new Point(400,325));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • dragToScreenPoint

        void dragToScreenPoint(java.awt.Point objectPt,
                               java.awt.Point screenPt)
        Performs a MOUSE_LEFT drag action against the associated TestObject.
        Detail description:
        This will Perform a MOUSE_LEFT drag action against the associated TestObject. The action is performed from (x, y,) relative to this TestObject, to the screen-relative screenPt coordinates.
        Example:

        placeOrder().dragToScreenPoint(new Point(400,325),new Point(25,25));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • dragToScreenPoint

        void dragToScreenPoint(MouseModifiers modifiers,
                               java.awt.Point objectPt,
                               java.awt.Point screenPt)
        Performs a drag action against the associated TestObject.
        Detail description:
        This will Perform a drag action against the associated TestObject. The action is performed from (x, y), relative to this TestObject to the screen-relative screenPt coordinates.
        Example:

        placeOrder().dragToScreenPoint(new MouseModifiers(MOUSE_LEFT),new Point(400,325),new Point(25,25));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • nClickDragToScreenPoint

        void nClickDragToScreenPoint(int clickCount,
                                     MouseModifiers modifiers,
                                     java.awt.Point objectPt,
                                     java.awt.Point screenPt)
        Performs a mouse n-click drag action on the specified coordinates
        Detail description:
        This will Perform a mouse n-click drag action on the specified coordinates, relative the screen-relative screenPt coordinates.
        Example:

        placeOrder().nClickDragToScreenPoint(2,new MouseModifiers(MOUSE_LEFT),new Point(400,325),new Point(25,25));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • mouseMove

        void mouseMove(java.awt.Point pt)
        Performs a MOUSE_LEFT move action against the associated TestObject.
        Detail description:
        This will Perform a MOUSE_LEFT move action against the associated TestObject. The action is performed from current mouse coordinates to (x, y) coordinates, relative to this TestObject.
        Example:

        placeOrder().mouseMove(new Point(400,325));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • mouseMove

        void mouseMove(MouseModifiers modifiers,
                       java.awt.Point pt)
        Performs a Move action against the associated TestObject.
        Detail description:
        This will Perform a Move action against the associated TestObject. The action is performed from current mouse coordinates to (x, y) coordinates, relative to this TestObject.
        Example:

        placeOrder().mouseMove(new MouseModifiers(MOUSE_LEFT),new Point(400,325));
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • hover

        void hover(double secondDelay)
        Hovers the mouse over the center of the associated TestObject.
        Detail description:
        This will Hover the mouse over the center of the associated TestObject. The mouse is moved to the center of the TestObject and stays there for at least the specified number of seconds.
        Example:

        placeOrder().hover(10);
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • hover

        void hover()
        Hovers the mouse over the center of the associated TestObject.
        Detail description:
        This will Hover the mouse over the center of the associated TestObject. The mouse is moved to the center of the TestObject and stays there for the default length of time.
        Example:

        placeOrder().hover();
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • hover

        void hover(java.awt.Point pt)
        Hovers the mouse over the specified coordinates of the associated TestObject.
        Detail description:
        This will Hover the mouse over the specified coordinates of the associated TestObject. The mouse is moved to the object, relative to the coordinates of the TestObject. It stays there for the default length of time.
        Example:

        placeOrder().hover(new Point(400,325);
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1
      • hover

        void hover(double secondDelay,
                   java.awt.Point pt)
        Hovers the mouse over the specified coordinates of the associated TestObject.
        Detail description:
        This will Hover the mouse over the specified coordinates of the associated TestObject. The mouse is moved to the object, relative to the coordinates of the TestObject. It stays there for at least the specified number of seconds.
        Example:

        placeOrder().hover(10,new Point(400,325);
        Here placeOrder is of type GuiTestObject and i have used the ClassicjavaA as Application under test.
        Since:
        RFT 6.1.1.1