public class FlexObjectProxy
extends com.rational.test.ft.domain.ProxyTestObject
implements com.rational.test.ft.object.interfaces.IGraphical
This class further contains the default implementation of various base class methods that proxy implementations may need to extend or override.
flexObjetTestObject
| Property | Usage |
|---|---|
| .class | The flex full class name of the test object. |
| .classIndex | The zero-based index of the class relative to the immediate parent in the object map. |
| Modifier and Type | Field and Description |
|---|---|
protected com.rational.test.ft.sys.HashtableEx |
addedRecProps |
protected com.rational.test.ft.sys.HashtableEx |
addedRecPropsWeight |
protected static java.lang.String |
ARG_SEPARATOR |
protected static java.lang.String |
COLUMN_SEPARATOR |
protected static com.rational.test.ft.util.FtDebug |
debug |
protected FlexTestDomainImplementation |
domain |
protected java.lang.String |
m_automationID |
protected java.lang.String |
m_className |
protected static int |
MAX_NAME |
protected com.rational.test.ft.script.ScriptCommandFlags |
preDownState |
protected static java.lang.String |
PROPERTY_AUTOMATIONCLASSNAME |
protected static java.lang.String |
PROPERTY_AUTOMATIONINDEX |
protected static java.lang.String |
PROPERTY_AUTOMATIONNAME |
protected static java.lang.String |
PROPERTY_CLASSNAME |
protected static java.lang.String |
PROPERTY_CURRENTSTATE |
protected static java.lang.String |
PROPERTY_ENABLED |
protected static java.lang.String |
PROPERTY_FOCUSENABLED |
protected static java.lang.String |
PROPERTY_ID |
protected static java.lang.String |
PROPERTY_MOUSEENABLED |
protected static java.lang.String |
PROPERTY_TABENABLED |
protected static java.lang.String |
PROPERTY_TABINDEX |
protected static java.lang.String |
PROPERTY_TOOLTIP |
protected static java.lang.String |
PROPERTY_VISIBLE |
protected static java.lang.String[] |
ScrollDetailsValue |
protected static java.lang.String[] |
ScrollDirectionValue |
protected long |
transactionId |
BROWSERTABTESTOBJECT_CLASSNAME, BROWSERTESTOBJECT_CLASSNAME, COLORDIALOGTESTOBJECT_CLASSNAME, CROSSDOMAINCONTAINER_CLASSNAME, DOCUMENTTESTOBJECT_CLASSNAME, DOMAINTESTOBJECT_CLASSNAME, ECLIPSETOPLEVELTESTOBJECT_CLASSNAME, EMBEDDEDBROWSERTESTOBJECT_CLASSNAME, FILEDIALOGTESTOBJECT_CLASSNAME, FRAMESUBITEMTESTOBJECT_CLASSNAME, FRAMETESTOBJECT_CLASSNAME, GEFEDITPARTTESTOBJECT_CLASSNAME, GUISUBITEMTESTOBJECT_CLASSNAME, GUITESTOBJECT_CLASSNAME, INTERNALFRAMETESTOBJECT_CLASSNAME, MESSAGEBOXTESTOBJECT_CLASSNAME, PALETTEGUISUBITEMTESTOBJECT_CLASSNAME, PROCESSTESTOBJECT_CLASSNAME, SCROLLSUBITEMTESTOBJECT_CLASSNAME, SCROLLTESTOBJECT_CLASSNAME, SELECTGUISUBITEMTESTOBJECT_CLASSNAME, SELECTSCROLLGUISUBITEMTESTOBJECT_CLASSNAME, SHELLTESTOBJECT_CLASSNAME, STATELESSGUISUBITEMTESTOBJECT_CLASSNAME, SUBITEMTESTOBJECT_CLASSNAME, TABITEMTESTOBJECT_CLASSNAME, TESTOBJECT_CLASSNAME, TEXTGUISUBITEMTESTOBJECT_CLASSNAME, TEXTGUITESTOBJECT_CLASSNAME, TEXTSCROLLTESTOBJECT_CLASSNAME, TEXTSELECTGUISUBITEMTESTOBJECT_CLASSNAME, TIMEOUTTESTOBJECT_CLASSNAME, TOGGLEGUITESTOBJECT_CLASSNAME, TOGGLETESTOBJECT_CLASSNAME, TOPLEVELSUBITEMTESTOBJECT_CLASSNAME, TOPLEVELTESTOBJECT_CLASSNAME, TRACKBARTESTOBJECT_CLASSNAME, vomClippedRectangle| Constructor and Description |
|---|
FlexObjectProxy(FlexTestDomainImplementation theDomain,
com.rational.test.ft.domain.IChannel channel,
java.lang.String theAutomationID) |
FlexObjectProxy(FlexTestDomainImplementation theDomain,
java.lang.String theAutomationID) |
| Modifier and Type | Method and Description |
|---|---|
protected void |
addAdditionalRecognitionProperties(java.util.Hashtable result) |
void |
addRecognitionProperty(java.lang.String property,
java.lang.Object value,
int weight)
This method defines an additional recognition property that this proxy
should utilize.
|
void |
changeFocus() |
void |
changeFocus(boolean shiftKey) |
void |
changeFocus(boolean shiftKey,
java.lang.String keyCode) |
void |
changeFocus(java.lang.String keyCode) |
void |
click()
Performs a left-mouse click on the center point of the associated
TestObject. |
void |
click(com.rational.test.ft.script.MouseModifiers modifiers)
Performs a left-mouse click on the specified object, relative
to coordinates within the associated
TestObject. |
void |
click(com.rational.test.ft.script.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(com.rational.test.ft.script.MouseModifiers modifiers)
Performs a left-mouse double-click on the specified object, relative
to coordinates within the associated
TestObject. |
void |
doubleClick(com.rational.test.ft.script.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(com.rational.test.ft.script.MouseModifiers modifiers)
Performs a drag action against the associated
TestObject with the
supplied set of mouse modifiers. |
void |
drag(com.rational.test.ft.script.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(com.rational.test.ft.script.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. |
boolean |
ensureObjectIsVisible()
Ensure the object is visible on the screen
This method is not applicable to Flex objects, since scrolling
operation gets recorded.
|
protected com.rational.test.ft.domain.flex.FlexObjectProxy.AdditionalRecognitionProperty |
getAddedRecognitionProperty(java.lang.String propertyName)
This method returns the AdditionalRecognitionProperty object identified by propertyName
|
protected java.lang.Object |
getAddedRecognitionPropertyValue(java.lang.String propertyName) |
protected int |
getAddedRecognitionPropertyWeight(java.lang.String propertyName) |
FlexObjectProxy |
getAutomationChildAt(int id)
Finds the automation child object that is at the specified index.
|
java.lang.Object |
getChildAtPoint(java.awt.Point pt)
Finds the child object that is at the specified point.
|
com.rational.test.ft.domain.ProxyTestObject[] |
getChildren()
Returns an array of proxies, visible by using the TestObject interface
from a script, for the children of this object.
|
java.awt.Rectangle |
getClientRectangle()
Get the client rectangle of the control.
|
java.awt.Rectangle |
getClippedScreenRectangle()
Returns the clipped-screen rectangle for the associated
TestObject, relative to the
top-left corner of the screen. |
com.rational.test.ft.sys.MethodSpecification |
getDataDrivableCommand()
This method must be implemented by any proxy that wishes to support
data driving.
|
java.lang.String |
getDescriptiveName()
Returns a name that can be used to describe the associated UI
object in a script.
|
java.lang.Object |
getIndexer(java.lang.String name,
java.lang.Object[] indexes)
Returns the value of a
TestObject's indexer at the given index. |
com.rational.test.ft.value.IndexerInfo[] |
getIndexers()
Returns information about the
TestObject's indexers, if applicable. |
java.lang.String |
getLabel() |
com.rational.test.ft.domain.ProxyTestObject[] |
getMappableChildren()
Returns an array of proxies, visible by using the TestObject interface
from a script, for the children of this object.
|
com.rational.test.ft.domain.ProxyTestObject |
getMappableParent()
Returns a proxy object for the mappable parent of this object;
returns
null if this object has no mappable parent. |
com.rational.test.ft.value.MethodInfo[] |
getMethods()
Returns an array of MethodInfos
|
com.rational.test.ft.sys.MethodSpecification |
GetMethodSpec(java.lang.String eventName,
java.lang.String eventArgs) |
com.rational.test.ft.sys.MethodSpecification |
getMethodSpecForPoint(java.awt.Point pt)
Returns a
MethodSpecification for a method that returns a java.awt.Point
for the specified coordinates. |
java.util.Hashtable |
getNonValueProperties()
Returns the properties that are not supported because the value
is a reference to another object.
|
java.lang.String |
getObjectClassName()
Returns the class name of the associated object.
|
com.rational.test.ft.domain.ProxyTestObject[] |
getOwnedObjects()
Returns an array of proxies for the objects owned
by this object.
|
com.rational.test.ft.domain.ProxyTestObject |
getOwner()
Returns a proxy object for the owner of this object;
returns
null if this object has no owner. |
com.rational.test.ft.domain.ProxyTestObject |
getParent()
Returns a proxy object for the parent of this object;
returns
null if this object has no parent. |
protected java.lang.String |
getPlayerId() |
java.util.Hashtable |
getProperties()
Returns a complete set of properties for the associated
test object.
|
protected java.util.ArrayList |
getPropertiesList() |
java.lang.Object |
getProperty(java.lang.String propertyName)
Gets the value for a specific property defined in
getProperties() or getRecognitionProperties(). |
java.util.Hashtable |
getRecognitionProperties()
Returns an enumeration of properties used to uniquely identify the
associated test object in the SUT.
|
int |
getRecognitionPropertyWeight(java.lang.String propertyName)
Returns an indication of how useful this property is for recognition.
|
java.lang.String |
getRole()
Returns a brief type name that describes the role this object plays in the
UI.
|
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.
|
com.rational.test.ft.script.ScriptCommandFlags |
getScriptCommandFlags()
This method returns an active state value that reflects the state of the
test object at the time of the call.
|
java.util.Hashtable |
getStandardProperties()
Returns a complete set of consistent properties for the associated
test object.
|
java.util.Hashtable |
getTestDataTypes()
Returns a hashtable of data type descriptions of the verification
point data available with the associated object.
|
com.rational.test.ft.domain.TestDomainImplementation |
getTestDomain()
Returns the
TestDomain that this proxy object is associated
with. |
java.lang.String |
getTestObjectClassName()
Returns a valid class name specification.
|
com.rational.test.ft.domain.ProxyTestObject |
getTopMappableParent()
Returns a proxy object for the top mappable parent of this object;
returns a pointer to itself if this object has no mappable parent.
|
com.rational.test.ft.domain.ProxyTestObject |
getTopParent()
Returns a proxy object for the top parent of this object;
returns a pointer to itself if this object has no parent.
|
long |
getTransactionId() |
java.lang.String |
getUniqueId()
Returns a string for the associated object.
|
java.lang.String |
getValue() |
com.rational.test.ft.domain.ProxyTestObject |
getVisualTopParent()
Returns the top mappable parent for a given proxy.
|
boolean |
hasAddedRecognitionProperties()
Returns
true if recognition properties have been added
to this proxy from an external source through addRecognitionProperty(). |
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(com.rational.test.ft.script.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,
com.rational.test.ft.script.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,
com.rational.test.ft.script.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,
com.rational.test.ft.script.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. |
void |
performAction(java.lang.String eventName) |
void |
performAction(java.lang.String eventName,
java.lang.Object[] eventArgs) |
void |
performAction(java.lang.String eventName,
java.lang.String eventArgs) |
void |
performAction(java.lang.String eventName,
java.lang.String args1,
java.lang.String args2) |
void |
performAction(java.lang.String eventName,
java.lang.String args1,
java.lang.String args2,
java.lang.String args3) |
void |
performAction(java.lang.String eventName,
java.lang.String args1,
java.lang.String args2,
java.lang.String args3,
java.lang.String args4) |
void |
processMouseEvent(com.rational.test.ft.domain.IMouseActionInfo action)
Updates the supplied
action with an appropriate
MethodSpecification to play back the action. |
void |
setIndexer(java.lang.String name,
java.lang.Object[] indexes,
java.lang.Object val)
Sets the value of a
TestObject's indexer. |
void |
setProperty(java.lang.String propertyName,
java.lang.Object value)
Sets the value for a specific property defined in
getProperties() or getRecognitionProperties(). |
void |
setTransactionId(long transactionId) |
boolean |
shouldBeMapped()
Determines whether the object is interesting from a persistent testability
sense and should therefore be added to the object map.
|
boolean |
suppressKeyAction()
Flags the recorder to ignore key events relative to this top-level proxy.
|
addDataDrivableCommands, baseClassMatch, canTakeVP, equals, findChildrenWithProperties, findChildrenWithPropertiesAndInvoke, getChannel, getChildren, getDataDrivableCommands, getElementWithFocus, getField, getIgnorableProperties, getMappableChildren, getMappableParent, getObjectCustomClassName, getOwnedObjects, getParent, getProxy, getScriptCommandAnchor, getTestData, getVisualClippableParent, getVisualClippedRectangle, getVisualMappableChildren, getVOMSpecificProperty, hasSpecialFrameState, isClassIndexConsidered, isSameObject, isValidObject, ping, updateTestDataprotected static final java.lang.String PROPERTY_AUTOMATIONINDEX
protected static final java.lang.String PROPERTY_AUTOMATIONCLASSNAME
protected static final java.lang.String PROPERTY_AUTOMATIONNAME
protected static final java.lang.String PROPERTY_CLASSNAME
protected static final java.lang.String PROPERTY_CURRENTSTATE
protected static final java.lang.String PROPERTY_ENABLED
protected static final java.lang.String PROPERTY_FOCUSENABLED
protected static final java.lang.String PROPERTY_ID
protected static final java.lang.String PROPERTY_MOUSEENABLED
protected static final java.lang.String PROPERTY_TABENABLED
protected static final java.lang.String PROPERTY_TABINDEX
protected static final java.lang.String PROPERTY_TOOLTIP
protected static final java.lang.String PROPERTY_VISIBLE
protected FlexTestDomainImplementation domain
protected com.rational.test.ft.script.ScriptCommandFlags preDownState
protected java.lang.String m_className
protected java.lang.String m_automationID
protected static final int MAX_NAME
protected static final java.lang.String ARG_SEPARATOR
protected static final java.lang.String COLUMN_SEPARATOR
protected com.rational.test.ft.sys.HashtableEx addedRecProps
protected com.rational.test.ft.sys.HashtableEx addedRecPropsWeight
protected static com.rational.test.ft.util.FtDebug debug
protected long transactionId
protected static final java.lang.String[] ScrollDirectionValue
protected static final java.lang.String[] ScrollDetailsValue
public FlexObjectProxy(FlexTestDomainImplementation theDomain, com.rational.test.ft.domain.IChannel channel, java.lang.String theAutomationID)
public FlexObjectProxy(FlexTestDomainImplementation theDomain, java.lang.String theAutomationID)
public long getTransactionId()
getTransactionId in class com.rational.test.ft.sys.RegisteredObjectpublic void setTransactionId(long transactionId)
public java.lang.String getTestObjectClassName()
TestObject class. The testObject
performs a cross-process (and cross-JVM) call to the
same method against an associated proxy, which is this proxy.
This method should never return null, even if shouldBeMapped()
returns false. User may still access objects such as this through
scripting method calls and can return references to them.
If a null were returned, the marshalling code would be confused and would not
be able to construct a test object.
This method may be called from any thread.
getTestObjectClassName in interface com.rational.test.ft.domain.IProxyBasegetTestObjectClassName in class com.rational.test.ft.domain.ProxyTestObjecttestObject class full name.public com.rational.test.ft.domain.TestDomainImplementation getTestDomain()
TestDomain that this proxy object is associated
with.getTestDomain in interface com.rational.test.ft.domain.IProxyBasegetTestDomain in class com.rational.test.ft.domain.ProxyTestObjectTestDomain class full name.public java.lang.String getDescriptiveName()
java.awt.Button
with the associated text "OK".getDescriptiveName in class com.rational.test.ft.domain.ProxyTestObjectpublic java.lang.String getRole()
java.awt.Button might return button.
There are suggested role constants in the TestObjectRole
class. However, proxies are not limited to these constants.
The role is used for several purposes by the test infrastructure. First, the
role can be used in the construction of object names in scripts, augmenting
the name returned by getDescriptiveName().
The role is also used in the UI to decorate nodes in the map with icons that
help users quickly associate the nodes with the roles they play in the system
under test.
getRole in class com.rational.test.ft.domain.ProxyTestObjectpublic java.lang.String getObjectClassName()
getObjectClassName in class com.rational.test.ft.domain.ProxyTestObjectpublic java.lang.String getUniqueId()
getUniqueId in class com.rational.test.ft.domain.ProxyTestObjectpublic boolean shouldBeMapped()
false.shouldBeMapped in class com.rational.test.ft.domain.ProxyTestObjecttrue if the represented control is interesting
other than for nested objects.public com.rational.test.ft.domain.ProxyTestObject getParent()
null if this object has no parent.getParent in class com.rational.test.ft.domain.ProxyTestObjectnull
for a top-level object.public com.rational.test.ft.domain.ProxyTestObject getMappableParent()
null if this object has no mappable parent.
Note that only a proxy that shouldBeMapped
should be returned from this method.getMappableParent in class com.rational.test.ft.domain.ProxyTestObjectnull
for a top-level mapped object.public com.rational.test.ft.domain.ProxyTestObject getTopParent()
getTopParent in class com.rational.test.ft.domain.ProxyTestObjectpublic com.rational.test.ft.domain.ProxyTestObject getTopMappableParent()
getTopMappableParent in class com.rational.test.ft.domain.ProxyTestObjectpublic com.rational.test.ft.domain.ProxyTestObject[] getChildren()
getChildren in class com.rational.test.ft.domain.ProxyTestObjectpublic com.rational.test.ft.domain.ProxyTestObject[] getMappableChildren()
getMappableChildren in class com.rational.test.ft.domain.ProxyTestObjectpublic com.rational.test.ft.domain.ProxyTestObject getOwner()
null if this object has no owner.getOwner in class com.rational.test.ft.domain.ProxyTestObjectnull
for a top object without an owner.public com.rational.test.ft.domain.ProxyTestObject[] getOwnedObjects()
getOwnedObjects in class com.rational.test.ft.domain.ProxyTestObjectpublic boolean suppressKeyAction()
suppressKeyAction in class com.rational.test.ft.domain.ProxyTestObjecttrue for a top-level proxy that wants to suppress the
generation of inputKeys method calls.public void processMouseEvent(com.rational.test.ft.domain.IMouseActionInfo action)
action with an appropriate
MethodSpecification to play back the action. This
method is the primary record interface for mouse events against a particular
control. Only one MethodSpecification is maintained in the
action state. If the active specification is valid, it is not updated.processMouseEvent in class com.rational.test.ft.domain.ProxyTestObjectaction - The event cache and other mouse state information
for this mouse action.IMouseActionInfo,
MethodSpecificationpublic com.rational.test.ft.script.ScriptCommandFlags getScriptCommandFlags()
getScriptCommandFlags in class com.rational.test.ft.domain.ProxyTestObjectpublic com.rational.test.ft.sys.MethodSpecification GetMethodSpec(java.lang.String eventName,
java.lang.String eventArgs)
public com.rational.test.ft.sys.MethodSpecification getMethodSpecForPoint(java.awt.Point pt)
MethodSpecification for a method that returns a java.awt.Point
for the specified coordinates. By default, a method specification for
IGraphical.getScreenPoint is returned.getMethodSpecForPoint in class com.rational.test.ft.domain.ProxyTestObjectaction - The event cache and other mouse state information
for this mouse action.MethodSpecificationpublic java.util.Hashtable getRecognitionProperties()
getRecognitionProperties in class com.rational.test.ft.domain.ProxyTestObjectprotected void addAdditionalRecognitionProperties(java.util.Hashtable result)
public int getRecognitionPropertyWeight(java.lang.String propertyName)
getRecognitionPropertyWeight in class com.rational.test.ft.domain.ProxyTestObjectprotected int getAddedRecognitionPropertyWeight(java.lang.String propertyName)
protected java.lang.Object getAddedRecognitionPropertyValue(java.lang.String propertyName)
public void addRecognitionProperty(java.lang.String property,
java.lang.Object value,
int weight)
getRecognitionProperties method.addRecognitionProperty in class com.rational.test.ft.domain.ProxyTestObjectproperty - The recognition property name. Care should be taken to
avoid conflicts with existing property names.value - The value of the added recognition property.weight - The weight associated with this recognition property.
This value should be returned when the getRecognitionPropertyWeight method is called.getRecognitionProperties(),
getRecognitionPropertyWeight(String),
getProperty(String)protected com.rational.test.ft.domain.flex.FlexObjectProxy.AdditionalRecognitionProperty getAddedRecognitionProperty(java.lang.String propertyName)
public boolean hasAddedRecognitionProperties()
true if recognition properties have been added
to this proxy from an external source through addRecognitionProperty().hasAddedRecognitionProperties in class com.rational.test.ft.domain.ProxyTestObjecttrue if recognition properties have been added
to this proxy from an external source through addRecognitionProperty(String,Object,int).addRecognitionProperty(String,Object,int)public java.util.Hashtable getProperties()
This method does not return properties whose values are references
to objects. The method getNonValueProperties() returns
information about such properties.
getProperties in class com.rational.test.ft.domain.ProxyTestObjectgetProperty(String),
setProperty(String,Object),
getStandardProperties(),
getNonValueProperties()protected java.util.ArrayList getPropertiesList()
public java.util.Hashtable getStandardProperties()
getProperties().
The HTML domain supports standard properties and
returns properties that are consistent across browser versions.
The Java domain does not support this notion of standard properties.
In this domain, getStandardProperties, and getProperties do the same thing.
For HTML, standard properties are a subset
of the properties returned by getProperties().
The meaning of a property is specific to the test domain
and the test object. Typically, this is a set of name/value pairs
that describe the test object and its active state. Properties such
as font, colors, and coordinate information are typically associated
with a GUI test object. Associated data and state information can also
be returned, depending on the test object.getStandardProperties in class com.rational.test.ft.domain.ProxyTestObjectgetProperty(String),
setProperty(String,Object),
getProperties(),
getNonValueProperties()public java.lang.Object getProperty(java.lang.String propertyName)
getProperties() or getRecognitionProperties(). If the property is not defined by either of these
methods, this method throws PropertyNotFoundException.getProperty in class com.rational.test.ft.domain.ProxyTestObjectpropertyName - The name of the property to fetch.getProperties(),
setProperty(String,Object),
getRecognitionProperties(),
addRecognitionProperty(String,Object,int)public void setProperty(java.lang.String propertyName,
java.lang.Object value)
getProperties() or getRecognitionProperties(). Properties not defined by either of these
methods, and properties whose values cannot be modified throw an
appropriately populated PropertyNotFoundException.setProperty in class com.rational.test.ft.domain.ProxyTestObjectpropertyName - The name of the property to redefine. This
name is the same as that returned by
getProperties().getProperties(),
getProperty(String)public java.util.Hashtable getNonValueProperties()
getProperty().
If such a property is returned to the test script, it is
manifested as a TestObject containing a reference to the
object in the SUT. The test script should call the TestObject
method unregister() to release the object.
When an object is unregistered, the release() method that all ProxyTestObjects inherit from RegisteredObject is called.
getNonValueProperties in class com.rational.test.ft.domain.ProxyTestObjectgetProperties(),
getStandardProperties(),
getProperty(String),
setProperty(String,Object)public java.lang.Object getIndexer(java.lang.String name,
java.lang.Object[] indexes)
TestObject's indexer at the given index. If the
value has a value class then the value class is returned, otherwise a TestObject is
registered and returned. Information about a TestObject's indexer properties
can be obtained via getIndexers().getIndexer in class com.rational.test.ft.domain.ProxyTestObjectname - the name of the indexerindexes - the indexes to get the value ofpublic com.rational.test.ft.value.IndexerInfo[] getIndexers()
TestObject's indexers, if applicable.getIndexers in class com.rational.test.ft.domain.ProxyTestObjectIndexerInfopublic void setIndexer(java.lang.String name,
java.lang.Object[] indexes,
java.lang.Object val)
TestObject's indexer.setIndexer in class com.rational.test.ft.domain.ProxyTestObjectname - the name of the indexerindexes - the indexes to set the value ofvalue - the value to set the index topublic com.rational.test.ft.value.MethodInfo[] getMethods()
getMethods in class com.rational.test.ft.domain.ProxyTestObjectpublic java.util.Hashtable getTestDataTypes()
String objects that are used as the VP
type in the associated test data. The type is a
simple value that is different from other type values associated
with this object under test. The type keys map to a verbose
description of the test data, reasonable for presentation to a
user.getTestDataTypes in class com.rational.test.ft.domain.ProxyTestObjecttype/description pairs
used to describe the verification data available from this
proxy.ProxyTestObject.getTestData(String),
ITestDataprotected java.lang.String getPlayerId()
public boolean ensureObjectIsVisible()
true if the component is visible; false otherwise.public boolean isShowing()
isShowing in interface com.rational.test.ft.object.interfaces.IGraphicaltrue if the component is showing; false otherwise.public boolean isEnabled()
isEnabled in interface com.rational.test.ft.object.interfaces.IGraphicaltrue if the component is enabled; false otherwise.public boolean isOpaque()
isOpaque in interface com.rational.test.ft.object.interfaces.IGraphicaltrue if the component is opaque; false otherwise.public boolean hasFocus()
hasFocus in interface com.rational.test.ft.object.interfaces.IGraphicaltrue 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.
isPointInObject in interface com.rational.test.ft.object.interfaces.IGraphicalpt - Screen-relative point to checktrue if component contains thePoint; false otherwise.getScreenRectangle()public java.lang.Object getChildAtPoint(java.awt.Point pt)
getChildAtPoint in interface com.rational.test.ft.object.interfaces.IGraphicalpt - Screen-relative point to checknull if no child object is
foundgetScreenRectangle()public FlexObjectProxy getAutomationChildAt(int id)
id - index from which the child is to be retrievednull if no child object is
foundpublic 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.getScreenRectangle in interface com.rational.test.ft.object.interfaces.IGraphicalisPointInObject(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.getClippedScreenRectangle in interface com.rational.test.ft.object.interfaces.IGraphicalnull if the object cannot be seen
in any window on the screen.getScreenRectangle()public java.awt.Rectangle getClientRectangle()
public java.awt.Point getScreenPoint()
getScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalpublic java.awt.Point getScreenPoint(java.awt.Point pt)
getScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalpt - 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).click in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void changeFocus()
public void changeFocus(boolean shiftKey,
java.lang.String keyCode)
public void changeFocus(java.lang.String keyCode)
public void changeFocus(boolean shiftKey)
public void click(com.rational.test.ft.script.MouseModifiers modifiers)
TestObject.click in interface com.rational.test.ft.object.interfaces.IGraphicalpublic 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).click in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void click(com.rational.test.ft.script.MouseModifiers modifiers,
java.awt.Point pt)
TestObject.click in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void doubleClick()
TestObject.
This method is a shortcut to the doubleClick method with a modifier
parameter. (The modifier is set to MOUSE_LEFT).doubleClick in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void doubleClick(com.rational.test.ft.script.MouseModifiers modifiers)
TestObject.doubleClick in interface com.rational.test.ft.object.interfaces.IGraphicalpublic 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).doubleClick in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void doubleClick(com.rational.test.ft.script.MouseModifiers modifiers,
java.awt.Point pt)
TestObject.doubleClick in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void nClick(int clickCount,
com.rational.test.ft.script.MouseModifiers modifiers,
java.awt.Point pt)
TestCode.nClick in interface com.rational.test.ft.object.interfaces.IGraphicalpublic 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.drag in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void drag(com.rational.test.ft.script.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.drag in interface com.rational.test.ft.object.interfaces.IGraphicalpublic 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.drag in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void drag(com.rational.test.ft.script.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.drag in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void nClickDrag(int clickCount,
com.rational.test.ft.script.MouseModifiers modifiers,
java.awt.Point pt1,
java.awt.Point pt2)
TestObject.nClickDrag in interface com.rational.test.ft.object.interfaces.IGraphicalpublic 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.dragToScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalpublic 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.dragToScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void dragToScreenPoint(com.rational.test.ft.script.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.dragToScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void nClickDragToScreenPoint(int clickCount,
com.rational.test.ft.script.MouseModifiers modifiers,
java.awt.Point objectPt,
java.awt.Point screenPt)
screenPt coordinates.nClickDragToScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalpublic 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.mouseMove in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void mouseMove(com.rational.test.ft.script.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.mouseMove in interface com.rational.test.ft.object.interfaces.IGraphicalpublic 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.hover in interface com.rational.test.ft.object.interfaces.IGraphicalpublic void hover()
TestObject.
The mouse is moved to the center of the TestObject and stays
there for the default length of time.hover in interface com.rational.test.ft.object.interfaces.IGraphicalpublic 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.hover in interface com.rational.test.ft.object.interfaces.IGraphicalpublic 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.hover in interface com.rational.test.ft.object.interfaces.IGraphicalpublic java.lang.String getValue()
public java.lang.String getLabel()
public com.rational.test.ft.sys.MethodSpecification getDataDrivableCommand()
null value is returned.getDataDrivableCommand in interface com.rational.test.ft.domain.IDataDrivengetDataDrivableCommand in class com.rational.test.ft.domain.ProxyTestObjectProxyTestObject.getDataDrivableCommands(int)public com.rational.test.ft.domain.ProxyTestObject getVisualTopParent()
getVisualTopParent in class com.rational.test.ft.domain.ProxyTestObjectpublic void performAction(java.lang.String eventName)
public void performAction(java.lang.String eventName,
java.lang.String eventArgs)
public void performAction(java.lang.String eventName,
java.lang.String args1,
java.lang.String args2)
public void performAction(java.lang.String eventName,
java.lang.String args1,
java.lang.String args2,
java.lang.String args3)
public void performAction(java.lang.String eventName,
java.lang.String args1,
java.lang.String args2,
java.lang.String args3,
java.lang.String args4)
public void performAction(java.lang.String eventName,
java.lang.Object[] eventArgs)