com.rational.test.ft.domain.flex

Class FlexAdvancedDataGridProxy

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

All Implemented Interfaces:

IDataDriven, IProxyBase

public class FlexAdvancedDataGridProxy
extends FlexListBaseProxy

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	FlexAdvancedDataGridProxy.FlexDataGridRow

Field Summary

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

argsArray, EVENTTRIGGER_KEYBOARD, EVENTTRIGGER_MOUSE, PROPERTY_ALLOWMULTISELECT, PROPERTY_LOCKEDCOLCOUNT, PROPERTY_LOCKEDROWCOUNT, PROPERTY_NUMCHILDREN, PROPERTY_SELECTABLE, PROPERTY_SELINDEX, PROPERTY_SELINDICES, PROPERTY_SELITEM, PROPERTY_SELITEMS, PROPERTY_SHOWDATATIPS, 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
FlexAdvancedDataGridProxy(FlexTestDomainImplementation theDomain, IChannel channel, java.lang.String theAutomationID)
FlexAdvancedDataGridProxy(FlexTestDomainImplementation theDomain, java.lang.String theAutomationID)

Method Summary

Methods

Modifier and Type	Method and Description
void	click(MouseModifiers modifiers, Subitem cell) Performs a left-mouse click on the specified coordinates, relative to the associated TestObject.
void	click(Subitem cell) Performs a left-mouse click on the specified object, relative to coordinates within the associated TestObject.
void	collapse(Subitem atText)
void	columnShift(Subitem columnTo, Subitem columnFrom)
void	expand(Subitem atText)
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.
java.lang.String	getExpandArgs(java.lang.String groupName)
ProxyTestObject[]	getMappableChildren() Returns an array of proxies, visible by using the TestObject interface from a script, for the children of this object.
protected java.lang.String	getMethodName(java.lang.String eventName)
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.
FlexAdvancedDataGridProxy.FlexDataGridRow	getRow(int index)
FlexAdvancedDataGridProxy.FlexDataGridRow[]	getRows()
FlexAdvancedDataGridProxy.FlexDataGridRow[]	getSelectedRows()
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.
java.lang.String	getTestObjectClassName() Returns a valid class name specification.
void	headerClick(Subitem colHeader)
void	headerClick(Subitem colHeader, java.lang.String fKeyModifier, Subitem headerPart, java.lang.String triggerEvent)
void	headerShift(Subitem newIndex, Subitem oldIndex)
void	inputKeys(java.lang.String keyCode)
void	inputKeys(java.lang.String keyCode, Subitem cell)
boolean	isEditable()
void	resizeColumns(Subitem index, Subitem position)

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

getModifiers, getSelectedIndex, getSelectedIndices, 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, getDataDrivableCommand, 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, 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

Constructor Detail

FlexAdvancedDataGridProxy

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

FlexAdvancedDataGridProxy

public FlexAdvancedDataGridProxy(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 IProxyBase

Overrides:

getTestObjectClassName in class FlexListBaseProxy

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

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

GetMethodSpec

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

Overrides:

GetMethodSpec in class FlexScrollControlBaseProxy

click

public void click(Subitem cell)

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

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

headerShift

public void headerShift(Subitem newIndex,
               Subitem oldIndex)

headerClick

public void headerClick(Subitem colHeader)

headerClick

public void headerClick(Subitem colHeader,
               java.lang.String fKeyModifier,
               Subitem headerPart,
               java.lang.String triggerEvent)

resizeColumns

public void resizeColumns(Subitem index,
                 Subitem position)

columnShift

public void columnShift(Subitem columnTo,
               Subitem columnFrom)

collapse

public void collapse(Subitem atText)

expand

public void expand(Subitem atText)

getExpandArgs

public java.lang.String getExpandArgs(java.lang.String groupName)

getActionArgs

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

isEditable

public boolean isEditable()

getMethodName

protected java.lang.String getMethodName(java.lang.String eventName)

Overrides:

getMethodName in class FlexListBaseProxy

getRow

public FlexAdvancedDataGridProxy.FlexDataGridRow getRow(int index)

getSelectedRows

public FlexAdvancedDataGridProxy.FlexDataGridRow[] getSelectedRows()

getRows

public FlexAdvancedDataGridProxy.FlexDataGridRow[] getRows()

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 visible child proxies of this proxy.

Since:

RFT7.0.1

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)