com.rational.test.ft.domain.flex

Class FlexComboBoxProxy

java.lang.Object

com.rational.test.ft.sys.RegisteredObject

com.rational.test.ft.domain.ProxyTestObject

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

com.rational.test.ft.domain.flex.FlexComboBoxProxy

All Implemented Interfaces:

com.rational.test.ft.domain.IChannelObject, com.rational.test.ft.domain.IDataDriven, com.rational.test.ft.domain.IProxyBase, com.rational.test.ft.object.interfaces.IGraphical

public class FlexComboBoxProxy
extends FlexObjectProxy

Field Summary

Fields

Modifier and Type	Field and Description
protected static com.rational.test.ft.util.FtDebug	debug

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

addedRecProps, addedRecPropsWeight, ARG_SEPARATOR, COLUMN_SEPARATOR, 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, 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 class com.rational.test.ft.sys.RegisteredObject

theTestObject

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

INCLUDE_ALL, INCLUDE_JUSTOBJECT, INCLUDE_SIBLINGS

Constructor Summary

Constructors

Constructor and Description
FlexComboBoxProxy(FlexTestDomainImplementation theDomain, com.rational.test.ft.domain.IChannel channel, java.lang.String theAutomationID)
FlexComboBoxProxy(FlexTestDomainImplementation theDomain, java.lang.String theAutomationID)

Method Summary

Modifier and Type	Method and Description
void	close()
void	close(java.lang.String triggerEvent)
com.rational.test.ft.sys.MethodSpecification	getDataDrivableCommand() This method must be implemented by any proxy that wishes to support data driving.
java.lang.String[]	getItems()
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.sys.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.Object	getProperty(java.lang.String propertyName) Gets the value for a specific property defined in getProperties() or getRecognitionProperties().
java.lang.String	getRole() Returns a brief type name that describes the role this object plays in the UI.
com.rational.test.ft.vp.ITestData	getTestData(java.lang.String testDataType)
java.util.Hashtable	getTestDataTypes() Returns a hashtable of data type descriptions of the verification point data available with the associated object.
java.lang.String	getTestObjectClassName() Returns a valid class name specification.
java.lang.String	getValue()
void	input(java.lang.String text)
void	inputKeys(java.lang.String keyCode)
void	inputKeys(java.lang.String keyCode, int keyModifier)
boolean	itemExists(java.lang.String item)
void	open()
void	scroll(com.rational.test.ft.script.Subitem subitem, java.lang.String scrollDirection)
void	scroll(com.rational.test.ft.script.Subitem subitem, java.lang.String scrollDirection, java.lang.String scrollDetails)
void	select(int itemIndex)
void	select(java.lang.String itemName)
void	selectText(java.awt.Point point)

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

addAdditionalRecognitionProperties, addRecognitionProperty, changeFocus, changeFocus, changeFocus, changeFocus, click, click, click, click, doubleClick, doubleClick, doubleClick, doubleClick, drag, drag, drag, drag, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, ensureObjectIsVisible, getAddedRecognitionProperty, getAddedRecognitionPropertyValue, getAddedRecognitionPropertyWeight, getAutomationChildAt, getChildAtPoint, getChildren, getClientRectangle, getClippedScreenRectangle, getDescriptiveName, getIndexer, getIndexers, getLabel, getMappableParent, getMethods, getMethodSpecForPoint, getNonValueProperties, getObjectClassName, getOwnedObjects, getOwner, getParent, getPlayerId, getPropertiesList, getRecognitionProperties, getRecognitionPropertyWeight, getScreenPoint, getScreenPoint, getScreenRectangle, getScriptCommandFlags, getStandardProperties, getTestDomain, getTopMappableParent, getTopParent, getTransactionId, getUniqueId, 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 com.rational.test.ft.sys.RegisteredObject

addProxyReference, dereference, getObject, getRegisteredId, isReferenced, isReleaseRequired, register, registerTransiently, release, toString, unregister

Methods inherited from class java.lang.Object

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

Field Detail

debug

protected static com.rational.test.ft.util.FtDebug debug

Constructor Detail

FlexComboBoxProxy

public FlexComboBoxProxy(FlexTestDomainImplementation theDomain,
                         com.rational.test.ft.domain.IChannel channel,
                         java.lang.String theAutomationID)

FlexComboBoxProxy

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

Method Detail

getTestObjectClassName

public java.lang.String getTestObjectClassName()

Description copied from class: FlexObjectProxy

Returns a valid class name specification. The test script (which runs in a separate process) interacts with a class that supports a shared interface with a specific proxy. This class is called a 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.

Specified by:

getTestObjectClassName in interface com.rational.test.ft.domain.IProxyBase

Overrides:

getTestObjectClassName in class FlexObjectProxy

Returns:

The associated testObject class full name.

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.

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 FlexObjectProxy

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()

Description copied from class: FlexObjectProxy

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.

See Also:

ProxyTestObject.getTestData(String), ITestData

getTestData

public com.rational.test.ft.vp.ITestData getTestData(java.lang.String testDataType)

Overrides:

getTestData in class com.rational.test.ft.domain.ProxyTestObject

getDataDrivableCommand

public com.rational.test.ft.sys.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 com.rational.test.ft.domain.IDataDriven

Overrides:

getDataDrivableCommand in class FlexObjectProxy

Since:

RFT2.0

See Also:

ProxyTestObject.getDataDrivableCommands(int)

getItems

public java.lang.String[] getItems()

itemExists

public boolean itemExists(java.lang.String item)

GetMethodSpec

public com.rational.test.ft.sys.MethodSpecification GetMethodSpec(java.lang.String eventName,
                                                                  java.lang.String eventArgs)

Overrides:

GetMethodSpec in class FlexObjectProxy

getProperty

public java.lang.Object getProperty(java.lang.String propertyName)

Description copied from class: FlexObjectProxy

Gets the value for a specific property defined in getProperties() or getRecognitionProperties(). If the property is not defined by either of these methods, this method throws PropertyNotFoundException.

Overrides:

getProperty in class FlexObjectProxy

Parameters:

propertyName - The name of the property to fetch.

Returns:

The active value of the specified property for the associated test object.

See Also:

FlexObjectProxy.getProperties(), FlexObjectProxy.setProperty(String,Object), FlexObjectProxy.getRecognitionProperties(), FlexObjectProxy.addRecognitionProperty(String,Object,int)

getMappableChildren

public 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. 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

open

public void open()

close

public void close()

close

public void close(java.lang.String triggerEvent)

select

public void select(java.lang.String itemName)

select

public void select(int itemIndex)

input

public void input(java.lang.String text)

selectText

public void selectText(java.awt.Point point)

scroll

public void scroll(com.rational.test.ft.script.Subitem subitem,
                   java.lang.String scrollDirection)

scroll

public void scroll(com.rational.test.ft.script.Subitem subitem,
                   java.lang.String scrollDirection,
                   java.lang.String scrollDetails)

inputKeys

public void inputKeys(java.lang.String keyCode)

inputKeys

public void inputKeys(java.lang.String keyCode,
                      int keyModifier)

getValue

public java.lang.String getValue()

Overrides:

getValue in class FlexObjectProxy