com.rational.test.ft.domain.flex

Class FlexDataGridProxy

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

All Implemented Interfaces:

IDataDriven, IProxyBase

Direct Known Subclasses:

SparkDataGridProxy

public class FlexDataGridProxy
extends FlexListBaseProxy

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
class	FlexDataGridProxy.FlexDataGridRow

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.String	TESTDATA_CONTENTS
protected static java.lang.String	TESTDATA_SELECTED
protected static java.lang.String	TESTDATA_VISIBLECONTENTS

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_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
FlexDataGridProxy(FlexTestDomainImplementation theDomain, IChannel channel, java.lang.String theAutomationID)
FlexDataGridProxy(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	doubleClick(Subitem cell) Performs a left-mouse double-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.
int	getColCount()
java.lang.String[]	getColumnNames()
protected ITestData	getGridData(java.lang.String strGridItems)
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.
FlexDataGridProxy.FlexDataGridRow	getRow(int index)
int	getRowCount()
FlexDataGridProxy.FlexDataGridRow[]	getRows()
FlexDataGridProxy.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 index)
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, 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

Field Detail

TESTDATA_CONTENTS

protected static final java.lang.String TESTDATA_CONTENTS

See Also:

Constant Field Values

TESTDATA_SELECTED

protected static final java.lang.String TESTDATA_SELECTED

See Also:

Constant Field Values

TESTDATA_VISIBLECONTENTS

protected static final java.lang.String TESTDATA_VISIBLECONTENTS

See Also:

Constant Field Values

Constructor Detail

FlexDataGridProxy

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

FlexDataGridProxy

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

getRowCount

public int getRowCount()

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)

getColCount

public int getColCount()

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

doubleClick

public void doubleClick(Subitem cell)

Description copied from class: FlexObjectProxy

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

Overrides:

doubleClick 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 index)

resizeColumns

public void resizeColumns(Subitem index,
                 Subitem position)

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 FlexDataGridProxy.FlexDataGridRow getRow(int index)

getColumnNames

public java.lang.String[] getColumnNames()

getSelectedRows

public FlexDataGridProxy.FlexDataGridRow[] getSelectedRows()

getRows

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

getGridData

protected ITestData getGridData(java.lang.String strGridItems)