|
IBM Rational Functional Tester Version 6.1 IBM Rational Functional Tester API Reference Project Version 2.0 |
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Supported by all GUI objects. The associated object to
this interface is GuiTestObject
. Other objects, such as GuiSubitemTestObject
, extend the
base class GuiTestObject
.
Method Summary | |
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, relative to coordinates within the associated TestObject . |
void |
click(MouseModifiers modifiers,
java.awt.Point pt)
Performs a left-mouse click on the specified coordinates, relative to the associated TestObject . |
void |
click(java.awt.Point pt)
Performs a left-mouse click on the specified coordinates, relative to the associated TestObject . |
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, relative to coordinates within the associated TestObject . |
void |
doubleClick(MouseModifiers modifiers,
java.awt.Point pt)
Performs a left-mouse double-click on the specified coordinates, relative to the associated TestObject . |
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 , relative to the
top-left corner of the screen. |
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 given an object-relative point. |
java.awt.Rectangle |
getScreenRectangle()
Returns the rectangle that contains the component being evaluated, relative to the top-left corner of the screen. |
boolean |
hasFocus()
Determines 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()
Determines whether the component under evaluation is enabled. |
boolean |
isOpaque()
Determines 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, relative the screen-relative screenPt coordinates. |
Method Detail |
public boolean isShowing()
true
if the component is showing; false
otherwise.public boolean isEnabled()
true
if the component is enabled; false
otherwise.public boolean isOpaque()
true
if the component is opaque; false
otherwise.public boolean hasFocus()
true
if the component has keyboard focus; false
otherwise.public boolean isPointInObject(java.awt.Point pt)
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.
pt
- Screen-relative point to check
true
if component contains thePoint
; false
otherwise.getScreenRectangle()
public java.lang.Object getChildAtPoint(java.awt.Point pt)
pt
- Screen-relative point to check
null
if no child object is
foundgetScreenRectangle()
public java.awt.Rectangle getScreenRectangle()
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.
isPointInObject(java.awt.Point)
,
getClippedScreenRectangle()
public java.awt.Rectangle getClippedScreenRectangle()
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.
null
if the object cannot be seen
in any window on the screen.getScreenRectangle()
public java.awt.Point getScreenPoint()
public java.awt.Point getScreenPoint(java.awt.Point pt)
pt
- The object-relative pointpublic void click()
TestObject
.
This method is a shortcut to the click method with a modifier
parameter. (The modifier is set to MOUSE_LEFT
).
public void click(MouseModifiers modifiers)
TestObject
.
public void click(java.awt.Point pt)
TestObject
. This method is a shortcut to the
click
method with a modifier parameter and coordinates. (The modifier
is set to MOUSE_LEFT
).
public void click(MouseModifiers modifiers, java.awt.Point pt)
TestObject
.
public void doubleClick()
TestObject
.
This method is a shortcut to the doubleClick
method with a modifier
parameter. (The modifier is set to MOUSE_LEFT
).
public void doubleClick(MouseModifiers modifiers)
TestObject
.
public void doubleClick(java.awt.Point pt)
TestObject
. This method is a shortcut to the
doubleClick
method with a modifier parameter and coordinates. (The modifier
is set to MOUSE_LEFT
).
public void doubleClick(MouseModifiers modifiers, java.awt.Point pt)
TestObject
.
public void nClick(int clickCount, MouseModifiers modifiers, java.awt.Point pt)
TestCode
.
public void drag()
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.
public void drag(MouseModifiers modifiers)
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.
public void drag(java.awt.Point pt1, java.awt.Point pt2)
MOUSE_LEFT
drag action against the associated TestObject
.
The action is performed from (x1, y1) to (x2, y2) coordinates,
relative to this TestObject
.
public void drag(MouseModifiers modifiers, java.awt.Point pt1, java.awt.Point pt2)
TestObject
.
The action is performed from (x1, y1) to (x2, y2) coordinates,
relative to this TestObject
.
public void nClickDrag(int clickCount, MouseModifiers modifiers, java.awt.Point pt1, java.awt.Point pt2)
TestObject
.
public void dragToScreenPoint(java.awt.Point screenPt)
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.
public void dragToScreenPoint(java.awt.Point objectPt, java.awt.Point screenPt)
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.
public void dragToScreenPoint(MouseModifiers modifiers, java.awt.Point objectPt, java.awt.Point screenPt)
TestObject
.
The action is performed from (x, y), relative to this TestObject
to
the screen-relative screenPt
coordinates.
public void nClickDragToScreenPoint(int clickCount, MouseModifiers modifiers, java.awt.Point objectPt, java.awt.Point screenPt)
screenPt
coordinates.
public void mouseMove(java.awt.Point pt)
MOUSE_LEFT
move action against the associated TestObject
.
The action is performed from current mouse coordinates to (x, y)
coordinates, relative to this TestObject
.
public void mouseMove(MouseModifiers modifiers, java.awt.Point pt)
Move
action against the associated TestObject
.
The action is performed from current mouse coordinates to (x, y)
coordinates, relative to this TestObject
.
public void hover(double secondDelay)
TestObject
.
The mouse is moved to the center of the TestObject
and stays
there for at least the specified number of seconds.
public void hover()
TestObject
.
The mouse is moved to the center of the TestObject
and stays
there for the default length of time.
public void hover(java.awt.Point pt)
TestObject
. The mouse is moved to the object, relative to the coordinates
of the TestObject
. It stays there for the default length of time.
public void hover(double secondDelay, java.awt.Point pt)
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.
|
|||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |