com.rational.test.ft.domain.flex

Class FlexListProxy

java.lang.Object

RegisteredObject

com.rational.test.ft.domain.ProxyTestObject

com.rational.test.ft.domain.flex.FlexObjectProxy

com.rational.test.ft.domain.flex.FlexScrollControlBaseProxy

com.rational.test.ft.domain.flex.FlexListBaseProxy

com.rational.test.ft.domain.flex.FlexListProxy

All Implemented Interfaces:

IDataDriven, IProxyBase

Direct Known Subclasses:

FlexMenuProxy, FlexTreeProxy

public class FlexListProxy
extends FlexListBaseProxy

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.String	FLEXMENUCLASSNAME

Fields inherited from class com.rational.test.ft.domain.flex.FlexListBaseProxy

argsArray, EVENTTRIGGER_KEYBOARD, EVENTTRIGGER_MOUSE, PROPERTY_ALLOWMULTISELECT, PROPERTY_COLCOUNT, PROPERTY_LOCKEDCOLCOUNT, PROPERTY_LOCKEDROWCOUNT, PROPERTY_NUMCHILDREN, PROPERTY_ROWCOUNT, PROPERTY_SELECTABLE, PROPERTY_SELINDEX, PROPERTY_SELINDICES, PROPERTY_SELITEM, PROPERTY_SELITEMS, PROPERTY_SHOWDATATIPS, PROPERTY_WORDWRAP, spacePressed

Fields inherited from class com.rational.test.ft.domain.flex.FlexObjectProxy

addedRecProps, addedRecPropsWeight, ARG_SEPARATOR, COLUMN_SEPARATOR, debug, domain, m_automationID, m_className, MAX_NAME, preDownState, PROPERTY_AUTOMATIONCLASSNAME, PROPERTY_AUTOMATIONINDEX, PROPERTY_AUTOMATIONNAME, PROPERTY_CLASSNAME, PROPERTY_CURRENTSTATE, PROPERTY_ENABLED, PROPERTY_FOCUSENABLED, PROPERTY_ID, PROPERTY_MOUSEENABLED, PROPERTY_TABENABLED, PROPERTY_TABINDEX, PROPERTY_TOOLTIP, PROPERTY_VISIBLE, ScrollDetailsValue, ScrollDirectionValue, transactionId

Fields inherited from class com.rational.test.ft.domain.ProxyTestObject

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

Fields inherited from interface com.rational.test.ft.domain.IDataDriven

INCLUDE_ALL, INCLUDE_JUSTOBJECT, INCLUDE_SIBLINGS

Constructor Summary

Constructors

Constructor and Description
FlexListProxy(FlexTestDomainImplementation theDomain, IChannel channel, java.lang.String theAutomationID)
FlexListProxy(FlexTestDomainImplementation theDomain, java.lang.String theAutomationID)

Method Summary

Methods

Modifier and Type	Method and Description
void	change(java.lang.String text)
void	click(MouseModifiers modifiers, Subitem opt) Performs a left-mouse click on the specified coordinates, relative to the associated TestObject.
void	click(Subitem opt) Performs a left-mouse click on the specified object, relative to coordinates within the associated TestObject.
java.util.Vector	getActionArgs(java.lang.String methodName)
java.lang.Object	getChildAtPoint(java.awt.Point pt) Finds the child object that is at the specified point.
MethodSpecification	getDataDrivableCommand() This method must be implemented by any proxy that wishes to support data driving.
java.lang.Object[]	getItems()
ProxyTestObject[]	getMappableChildren() Returns an array of proxies, visible by using the TestObject interface from a script, for the children of this object.
MethodSpecification	GetMethodSpec(java.lang.String eventName, java.lang.String eventArgs)
java.util.Hashtable	getProperties() Returns a complete set of properties for the associated test object.
java.lang.String	getRole() Returns a brief type name that describes the role this object plays in the UI.
java.lang.String[]	getSelectedOptions()
ITestData	getTestData(java.lang.String type) Constructs the specified verification data object.
java.util.Hashtable	getTestDataTypes() Returns a hashtable of data type descriptions of the verification point data available with the associated object.
void	inputKeys(java.lang.String keyCode)
void	inputKeys(java.lang.String keyCode, Subitem opt)
protected boolean	isValidOption(java.lang.String option)

Methods inherited from class com.rational.test.ft.domain.flex.FlexListBaseProxy

getMethodName, getModifiers, getSelectedIndex, getSelectedIndices, getTestObjectClassName, isEventTriggerPresent, isKeyModifierPresent, isMultiSelectAllowed, isTriggerKeyBoard

Methods inherited from class com.rational.test.ft.domain.flex.FlexScrollControlBaseProxy

scroll, scroll

Methods inherited from class com.rational.test.ft.domain.flex.FlexObjectProxy

addAdditionalRecognitionProperties, addRecognitionProperty, changeFocus, changeFocus, changeFocus, changeFocus, click, doubleClick, doubleClick, doubleClick, drag, drag, drag, drag, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, ensureObjectIsVisible, getAddedRecognitionProperty, getAddedRecognitionPropertyValue, getAddedRecognitionPropertyWeight, getAutomationChildAt, getChildren, getClientRectangle, getClippedScreenRectangle, getDescriptiveName, getIndexer, getIndexers, getLabel, getMappableParent, getMethods, getMethodSpecForPoint, getNonValueProperties, getObjectClassName, getOwnedObjects, getOwner, getParent, getPlayerId, getPropertiesList, getProperty, getRecognitionProperties, getRecognitionPropertyWeight, getScreenPoint, getScreenPoint, getScreenRectangle, getScriptCommandFlags, getStandardProperties, getTestDomain, getTopMappableParent, getTopParent, getTransactionId, getUniqueId, getValue, getVisualTopParent, hasAddedRecognitionProperties, hasFocus, hover, hover, hover, hover, isEnabled, isOpaque, isPointInObject, isShowing, mouseMove, mouseMove, nClick, nClickDrag, nClickDragToScreenPoint, performAction, performAction, performAction, performAction, performAction, performAction, processMouseEvent, setIndexer, setProperty, setTransactionId, shouldBeMapped, suppressKeyAction

Methods inherited from class com.rational.test.ft.domain.ProxyTestObject

addDataDrivableCommands, baseClassMatch, canTakeVP, equals, findChildrenWithProperties, findChildrenWithPropertiesAndInvoke, getChannel, getChildren, getDataDrivableCommands, getElementWithFocus, getField, getIgnorableProperties, getMappableChildren, getMappableParent, getObjectCustomClassName, getOwnedObjects, getParent, getProxy, getScriptCommandAnchor, getVisualClippableParent, getVisualClippedRectangle, getVisualMappableChildren, getVOMSpecificProperty, hasSpecialFrameState, isClassIndexConsidered, isSameObject, isValidObject, ping, updateTestData

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

FLEXMENUCLASSNAME

protected static final java.lang.String FLEXMENUCLASSNAME

See Also:

Constant Field Values

Constructor Detail

FlexListProxy

public FlexListProxy(FlexTestDomainImplementation theDomain,
             IChannel channel,
             java.lang.String theAutomationID)

FlexListProxy

public FlexListProxy(FlexTestDomainImplementation theDomain,
             java.lang.String theAutomationID)

Method Detail

getRole

public java.lang.String getRole()

Description copied from class: FlexObjectProxy

Returns a brief type name that describes the role this object plays in the UI. For instance a 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.

Overrides:

getRole in class FlexObjectProxy

Returns:

A brief type name that describes the role this object plays in the UI.

getChildAtPoint

public java.lang.Object getChildAtPoint(java.awt.Point pt)

Description copied from class: FlexObjectProxy

Finds the child object that is at the specified point. Note that the point is relative to the top-left corner of the screen and not to the component itself or its parent.

Overrides:

getChildAtPoint in class FlexObjectProxy

Parameters:

pt - Screen-relative point to check

Returns:

The object at the point, or null if no child object is found

See Also:

FlexObjectProxy.getScreenRectangle()

getProperties

public java.util.Hashtable getProperties()

Description copied from class: FlexObjectProxy

Returns a complete set of properties for the associated test object. 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.

This method does not return properties whose values are references to objects. The method FlexObjectProxy.getNonValueProperties() returns information about such properties.

Overrides:

getProperties in class FlexListBaseProxy

Returns:

The set of known properties associated with a test object.

See Also:

FlexObjectProxy.getProperty(String), FlexObjectProxy.setProperty(String,Object), FlexObjectProxy.getStandardProperties(), FlexObjectProxy.getNonValueProperties()

getTestDataTypes

public java.util.Hashtable getTestDataTypes()

Returns a hashtable of data type descriptions of the verification point data available with the associated object. The hashtable keys are 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.

Overrides:

getTestDataTypes in class FlexObjectProxy

Returns:

An hashtable of type/description pairs used to describe the verification data available from this proxy.

Since:

RFT1.0

See Also:

getTestData(String), com.rational.test.ft.vp.ITestData

getTestData

public ITestData getTestData(java.lang.String type)

Description copied from class: ProxyTestObject

Constructs the specified verification data object. The testDataType parameter is a hashtable key returned by getTestDataTypes().

Overrides:

getTestData in class ProxyTestObject

Parameters:

type - A test data type supplied by getTestDataTypes().

Returns:

The verification data for the supplied type.

See Also:

ProxyTestObject.getTestDataTypes(), com.rational.test.ft.vp.ITestData

getDataDrivableCommand

public MethodSpecification getDataDrivableCommand()

This method must be implemented by any proxy that wishes to support data driving. By default a null value is returned.

Specified by:

getDataDrivableCommand in interface IDataDriven

Overrides:

getDataDrivableCommand in class FlexObjectProxy

Since:

RFT2.0

See Also:

ProxyTestObject.getDataDrivableCommands(int)

getMappableChildren

public ProxyTestObject[] getMappableChildren()

Returns an array of proxies, visible by using the TestObject interface from a script, for the children of this object. This method is always used when building up the test objects to be added to a map, because a side additional recognition properties may be added to the child objects.

Overrides:

getMappableChildren in class FlexObjectProxy

Returns:

An array of child proxies of this proxy.

Since:

RFT1.0

getItems

public java.lang.Object[] getItems()

getSelectedOptions

public java.lang.String[] getSelectedOptions()

GetMethodSpec

public MethodSpecification GetMethodSpec(java.lang.String eventName,
                                java.lang.String eventArgs)

Overrides:

GetMethodSpec in class FlexScrollControlBaseProxy

getActionArgs

public java.util.Vector getActionArgs(java.lang.String methodName)

click

public void click(Subitem opt)

Description copied from class: FlexObjectProxy

Performs a left-mouse click on the specified object, relative to coordinates within the associated TestObject.

Overrides:

click in class FlexObjectProxy

click

public void click(MouseModifiers modifiers,
         Subitem opt)

Description copied from class: FlexObjectProxy

Performs a left-mouse click on the specified coordinates, relative to the associated TestObject.

Overrides:

click in class FlexObjectProxy

inputKeys

public void inputKeys(java.lang.String keyCode)

inputKeys

public void inputKeys(java.lang.String keyCode,
             Subitem opt)

isValidOption

protected boolean isValidOption(java.lang.String option)

change

public void change(java.lang.String text)