IBM Rational Functional Tester
Version 6.1
IBM Rational Functional Tester API Reference

Project Version 2.0

com.rational.test.ft.object.interfaces
Class FrameTestObject

java.lang.Object
  extended bycom.rational.test.ft.object.interfaces.TestObject
      extended bycom.rational.test.ft.object.interfaces.GuiTestObject
          extended bycom.rational.test.ft.object.interfaces.FrameTestObject
All Implemented Interfaces:
IFrame, IGraphical
Direct Known Subclasses:
InternalFrameTestObject, TopLevelTestObject

public class FrameTestObject
extends GuiTestObject
implements IFrame

Represents frame objects in the system under test. These controls must be acted upon in a consistent and resilient fashion across the various supported platforms.

Since:
RFT1.1

Constructor Summary
FrameTestObject(com.rational.test.ft.object.map.SpyMappedTestObject mappedObject)
          For internal use.
FrameTestObject(com.rational.test.ft.object.map.SpyMappedTestObject mappedObject, TestObject anchor)
          For internal use.
FrameTestObject(com.rational.test.ft.object.map.SpyMappedTestObject mappedObject, TestObject anchor, long scriptCommandFlags)
          For internal use.
FrameTestObject(TestObject obj)
          Construct one FrameTestObject from a TestObject.
FrameTestObject(com.rational.test.ft.object.TestObjectReference ref)
          For internal use.
 
Method Summary
 void close()
          Closes the associated frame.
 void contextHelp()
          Activates the window's context-sensitive Help mode, which is activated through the Help button on the title bar.
 boolean isIconified()
          Returns true if the frame is iconified.
 void maximize()
          Maximizes the associated frame.
 void minimize()
          Iconifies the associated frame.
 void move(java.awt.Point screenPt)
          Moves the frame to the specified location within parent.
 void resize(int width, int height)
          Resizes the frame to the specified width and height.
 void restore()
          Restores the associated frame.
 
Methods inherited from class com.rational.test.ft.object.interfaces.GuiTestObject
click, click, click, click, clickRadio, doubleClick, doubleClick, doubleClick, doubleClick, drag, drag, drag, drag, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, getChildAtPoint, getClippedScreenRectangle, getScreenPoint, getScreenPoint, getScreenRectangle, getScreenSnapshot, hasFocus, hover, hover, hover, hover, invokeProxyWithGuiDelay, invokeProxyWithGuiDelay, isEnabled, isOpaque, isPointInObject, isShowing, mouseMove, mouseMove, nClick, nClickDrag, nClickDragToScreenPoint
 
Methods inherited from class com.rational.test.ft.object.interfaces.TestObject
equals, exists, find, find, find, findAndInvoke, findAndInvoke, findAndInvokeProxy, getChildren, getDescribedObject, getDescribedObjects, getDomain, getField, getIndexer, getIndexer, getIndexers, getMappableChildren, getMappableParent, getMethods, getNameInScript, getNonValueProperties, getObjectClassName, getObjectReference, getOwnedObjects, getOwner, getParent, getProcess, getProperties, getProperty, getPropertyFromMap, getRecognitionProperties, getRecognitionPropertyWeight, getScriptCommandFlags, getStandardProperties, getTestData, getTestDataTypes, getTopMappableParent, getTopParent, invoke, invoke, invokeProxy, invokeProxy, isMappedObject, isSameObject, setIndexer, setIndexer, setProperty, toString, unregister, updateTestData, waitForExistence, waitForExistence
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.rational.test.ft.object.interfaces.IGraphical
click, click, click, click, doubleClick, doubleClick, doubleClick, doubleClick, drag, drag, drag, drag, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, getChildAtPoint, getClippedScreenRectangle, getScreenPoint, getScreenPoint, getScreenRectangle, hasFocus, hover, hover, hover, hover, isEnabled, isOpaque, isPointInObject, isShowing, mouseMove, mouseMove, nClick, nClickDrag, nClickDragToScreenPoint
 

Constructor Detail

FrameTestObject

public FrameTestObject(com.rational.test.ft.object.map.SpyMappedTestObject mappedObject)
For internal use.

Since:
RFT1.1

FrameTestObject

public FrameTestObject(com.rational.test.ft.object.map.SpyMappedTestObject mappedObject,
                       TestObject anchor)
For internal use.

Since:
RFT1.1

FrameTestObject

public FrameTestObject(com.rational.test.ft.object.map.SpyMappedTestObject mappedObject,
                       TestObject anchor,
                       long scriptCommandFlags)
For internal use.

Since:
RFT1.1

FrameTestObject

public FrameTestObject(com.rational.test.ft.object.TestObjectReference ref)
For internal use.

Since:
RFT1.1

FrameTestObject

public FrameTestObject(TestObject obj)
Construct one FrameTestObject from a TestObject. Both are references to the same object.

Since:
RFT1.1
Method Detail

close

public void close()
Closes the associated frame. The means by which the frame is closed depends on the platform. The most resilient means of closing the frame should be used, for example, clicking on the close-window icon/button. If the frame is already closed, this method has no effect.

Specified by:
close in interface IFrame
Since:
RFT1.1

maximize

public void maximize()
Maximizes the associated frame. The means by which the frame is maximized depends on the platform. The most resilient means of maximizing the frame should be used. If the frame is already maximized, this method has no effect.

Specified by:
maximize in interface IFrame
Since:
RFT1.1

minimize

public void minimize()
Iconifies the associated frame. The means by which the frame is iconified depends on the platform. The most resilient means of iconifying the window should be used. If the frame is already minimized, this method has no effect.

Specified by:
minimize in interface IFrame
Since:
RFT1.1

restore

public void restore()
Restores the associated frame. The means by which the frame is restored depends on the platform. The most resilient means of restoring the frame should be used. How a frame is restored depends on its state. If the frame is iconified, it is returned to its previous state. If the frame is maximized, it is returned to its normal size. If the window is already at the normal size, this method has no effect.

Specified by:
restore in interface IFrame
Since:
RFT1.1

isIconified

public boolean isIconified()
Returns true if the frame is iconified. A frame cannot be iconified return false.

Specified by:
isIconified in interface IFrame
Since:
RFT1.1

resize

public void resize(int width,
                   int height)
Resizes the frame to the specified width and height. The width and height dimensions are in pixel sizes. The most resilient method of resizing the frame is used. This action depends on the current state of the frame and desktop when the action is performed. If the resize target size is larger than the current parent size, the maximum size is the parent size.

Specified by:
resize in interface IFrame
Since:
RFT1.1

move

public void move(java.awt.Point screenPt)
Moves the frame to the specified location within parent. The top-left corner of the frame is moved to the specified location relative to the top-left corner of the parent.

Specified by:
move in interface IFrame
Since:
RFT1.1

contextHelp

public void contextHelp()
Activates the window's context-sensitive Help mode, which is activated through the Help button on the title bar. This mode is indicated by the mouse icon changing to a question mark. Note that this window feature is available on some Internet Explorer dialogs but is not available on Netscape.

Specified by:
contextHelp in interface IFrame
Since:
RFT1.0