IBM Rational Functional Tester
Version 8.1.1000
IBM Rational Functional Tester Proxy SDK Reference

Project Version 2.3

com.rational.test.ft.domain.java.jfc
Class JTableProxy

java.lang.Object   extended by com.rational.test.ft.sys.RegisteredObject       extended by com.rational.test.ft.domain.ProxyTestObject
          extended by com.rational.test.ft.domain.java.JavaProxy
              extended by com.rational.test.ft.domain.java.JavaGuiProxy
                  extended by com.rational.test.ft.domain.java.awt.ComponentProxy
                      extended by com.rational.test.ft.domain.java.jfc.JComponentProxy
                          extended by com.rational.test.ft.domain.java.jfc.JfcGraphicalSubitemProxy
                              extended by com.rational.test.ft.domain.java.jfc.JScrollPaneProxy
                                  extended by com.rational.test.ft.domain.java.jfc.JTableProxy
All Implemented Interfaces:
IChannelObject, IDataDriven, IProxyBase, IPropertyFilter, ISetParent, com.rational.test.ft.object.interfaces.IGraphical, com.rational.test.ft.object.interfaces.IGraphicalSubitem, com.rational.test.ft.object.interfaces.ISubitem
Direct Known Subclasses:
SiebelTableProxy

public class JTableProxy
extends JScrollPaneProxy

Proxy class for javax.swing.JTable.


Nested Class Summary
 
Nested classes/interfaces inherited from class com.rational.test.ft.domain.java.awt.ComponentProxy
ComponentProxy.ChildEnumerator, ComponentProxy.ImmediateChildEnumerator
 
Field Summary
 
Fields inherited from class com.rational.test.ft.domain.java.jfc.JScrollPaneProxy
theScrollBar
 
Fields inherited from class com.rational.test.ft.domain.java.jfc.JComponentProxy
TAB_INDEX, TAB_TEXT
 
Fields inherited from class com.rational.test.ft.domain.java.awt.ComponentProxy
childrenEnumerated, CLASSINDEX, CLASSINDEXWEIGHT, MAX_NAME, NAMEPROPERTY, NAMEPROPERTYWEIGHT, PRIORLABEL, PRIORLABELWEIGHT
 
Fields inherited from class com.rational.test.ft.domain.java.JavaGuiProxy
LEFT, preDownState, processMouseEventHandler, ROLEINDEX, ROLEINDEXWEIGHT, TESTDATA_SPECIALFRAMESTATE, TESTDATA_SPECIALFRAMESTATE_DESCRIPTION, topLevelWindow
 
Fields inherited from class com.rational.test.ft.domain.java.JavaProxy
debug, uniqueId
 
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, 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
JTableProxy(java.lang.Object theObjectInTheSUT)
          This sole constructor for all proxy objects sets the SUT object as a member variable for the proxy.
 
Method Summary
protected  void addColumnSelectionInterval(int index0, int index1)
          Adds the columns from index0 to index1, inclusive, to the current selection.
protected  void addDataDrivableCommands(ProxyTestObject proxy, java.util.Vector commands, int includeChildren)
           
protected  void addRowSelectionInterval(int index0, int index1)
          Adds the rows from index0 to index1, inclusive, to the current selection.
 boolean canBeScrolled()
          Returns true if the object is associated with scrollbar(s).
protected  void changeSelection(int rowIndex, int columnIndex, boolean toggle, boolean extend)
           
protected  void clearSelection()
          Deselects all selected columns and rows.
protected  int columnAtPoint(java.awt.Point pt)
          This method returns the column index for the column at the specified Point.
protected  com.rational.test.ft.script.Cell getCell(int columnIndex, int rowIndex)
           
protected  com.rational.test.ft.script.Cell getCell(java.awt.Point pt)
           
protected  java.awt.Rectangle getCellRectangle(int nColumn, int nRow)
          This method returns the table relative rectangle for the specified cell.
protected  com.rational.test.ft.script.Column getColumn(int columnIndex)
           
protected  com.rational.test.ft.script.Column getColumn(java.awt.Point pt)
           
protected  int getColumnCount()
          This method returns the number of columns in the table header component under evaluation.
protected  java.lang.String getColumnHeader(int nColumn)
          This method returns the name of the column at the specified column index.
protected  java.lang.String getColumnName(int nColumn)
          This method returns the name of the column at the specified column index.
protected  boolean getColumnSelectionAllowed()
          Returns true<\b> if columns can be selected.
 com.rational.test.ft.sys.MethodSpecification getDataDrivableCommand()
          This method must be implemented by any proxy that wishes to support data driving.
protected  int getFirstSelectedRow()
           
 int[] getKeyColumns(int nRow)
          This method returns a list of up to three "key" columns that may be used to determine a row in the table in a unique fashion.
 com.rational.test.ft.sys.MethodSpecification getMethodSpecForPoint(java.awt.Point pt)
          Return a MethodSpecification for a method that returns a java.awt.Point for the specified coordinates.
protected  javax.swing.table.TableModel getModel()
           
protected  java.lang.String getObjectStringAt(int nRow, int nColumn)
           
protected  java.lang.String getRenderedStringAt(int nRow, int nColumn)
           
protected  java.lang.String getRenderedStringAt(int nRow, int nColumn, boolean checkLength)
          This method returns the value in the specified table cell.
 java.lang.String getRole()
          Returns TestObjectRole.ROLE_TABLE.
protected  com.rational.test.ft.script.Row getRow(int rowIndex)
           
protected  com.rational.test.ft.script.Row getRow(java.awt.Point pt)
           
protected  int getRowCount()
          This method returns the number of rows in the table component under evaluation.
protected  boolean getRowSelectionAllowed()
          Returns true<\b> if columns can be selected.
 java.awt.Rectangle getScreenRectangle(com.rational.test.ft.script.Subitem subitem)
          Returns the rectangle that contains the component being evaluated relative to the top left corner of the screen.
protected  int[] getSelectedColumns()
          Returns the indices of all selected columns.
protected  int[] getSelectedRows()
          Returns the indices of all selected rows.
 java.lang.Object getSubitem(com.rational.test.ft.script.Subitem subitem)
          Returns an object that represents the specified subitem in the associated test object.
 com.rational.test.ft.vp.ITestData getTestData(java.lang.String testDataType)
          Constructs the specified verification data object.
protected  java.lang.Object getTestDataTableAt(int row, int col, java.lang.String type, javax.swing.table.TableModel model)
           
 java.util.Hashtable getTestDataTypes()
          Returns a hashtable of data type descriptions of the verification point data available with the associated object.
protected  java.lang.Object getValueAt(int nRow, int nColumn)
          This method returns the value in the specified table cell.
protected  boolean isCellEditable(int nColumn, int nRow)
          This method returns TRUE if the specified cell is read/write and FALSE if the cell is read/only.
protected  boolean isCellSelected(int rowIndex, int columnIndex)
          Returns true if the column at the specified index is selected.
protected  boolean isColumnSelected(int columnIndex)
          Returns true if the column at the specified index is selected.
protected  boolean isRowSelected(int rowIndex)
          Returns true if the row at the specified index is selected.
 void processSingleMouseEvent(IMouseActionInfo action)
          Return a MethodSpecification for the specified mouse event.
protected  int rowAtPoint(java.awt.Point pt)
          This method returns the row index for the row at the specified Point.
protected  void setColumnSelectionInterval(int index0, int index1)
          Selects the columns from index0 to index1, inclusive.
protected  void setRowSelectionInterval(int index0, int index1)
          Selects the rows from index0 to index1, inclusive.
 void setState(com.rational.test.ft.script.Action action)
          This method performs a specific action.
 void setState(com.rational.test.ft.script.Action action, com.rational.test.ft.script.Subitem item)
          This method performs a specific action against the subitem.
 void setState(com.rational.test.ft.script.Action action, com.rational.test.ft.script.Subitem start, com.rational.test.ft.script.Subitem end)
          This method performs a specific action against the subitem range defined by the specified indices.
 boolean shouldBeMapped()
          Returns true for JTableProxy.
protected  boolean testKeysForUniqueness(int row, int roCol, int[] roCols, java.lang.String[] roValues)
           
 com.rational.test.ft.vp.ITestData updateTestData(java.lang.String testDataType, com.rational.test.ft.vp.ITestData testData)
          Updates the supplied test data object and returns it.
 
Methods inherited from class com.rational.test.ft.domain.java.jfc.JScrollPaneProxy
click, getAssociateProxy, getClippedRect, getHScroll, getRealTestObject, getScroll, getScrollPaneProxy, getViewport, getVScroll, isPointInObject, isScroll
 
Methods inherited from class com.rational.test.ft.domain.java.jfc.JfcGraphicalSubitemProxy
click, click, click, doubleClick, doubleClick, doubleClick, doubleClick, drag, drag, drag, drag, drag, drag, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, getScreenPoint, getScreenPoint, getTestObjectClassName, hover, hover, hover, hover, mouseMove, mouseMove, mouseMove, mouseMove, nClick, nClickDrag, nClickDrag, nClickDragToScreenPoint, nClickDragToScreenPoint
 
Methods inherited from class com.rational.test.ft.domain.java.jfc.JComponentProxy
getBorderTitle, getClippedScreenRectangle, getDescriptiveName, getProperties, getProperty, getStandardProperties, getText, getVisibleRectangle, getVisualClippedRectangle, hasFocus, isOpaque, isType, scrollRectToVisible
 
Methods inherited from class com.rational.test.ft.domain.java.awt.ComponentProxy
childConstructed, getChildAtPoint, getChildProxy, getChildrenEnumeration, getComponentChildren, getEmbeddedBrowsers, getImmediateChildren, getLabelText, getLeadingLabel, getLocationOnScreen, getMappableChildren, getMappableParent, getName, getOwnedObjects, getOwner, getParent, getParent2, getParentObject, getScreenRectangle, getTopParent, getWindow, isDopeyDynamicName, isEnabled, isHScroll, isLabelled, isRecognitionProperty, isShowing, isVScroll, setParent
 
Methods inherited from class com.rational.test.ft.domain.java.JavaGuiProxy
activateTopWindow, click, click, click, click, doubleClick, doubleClick, doubleClick, doubleClick, drag, drag, drag, drag, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, dumpAction, ensureObjectIsVisible, getActionRect, getCachedRectX, getCachedRectY, getProcessMouseEventHandler, getRegisteredTopLevelWindow, getScreenPoint, getScreenPoint, getScriptCommandFlags, getTopMappableWindow, getTopWindow, hover, hover, hover, hover, isDrag, isPointInObject, modifiersChanged, mouseMove, mouseMove, nClick, nClickDrag, nClickDragToScreenPoint, processHoverMouseEvent, processMouseEvent, setProcessMouseEventHandler, setTopLevelWindow
 
Methods inherited from class com.rational.test.ft.domain.java.JavaProxy
addMappableChildrenToVector, addRecognitionProperty, allowProperty, getAddedRecognitionPropertyValue, getChildren, getIndexer, getIndexers, getMethods, getNonValueProperties, getRecognitionProperties, getRecognitionPropertyWeight, getTestDomain, getTopMappableParent, getUniqueId, getVisualClippableParent, hasAddedRecognitionProperties, setIndexer, setProperty
 
Methods inherited from class com.rational.test.ft.domain.ProxyTestObject
baseClassMatch, canTakeVP, equals, findChildrenWithProperties, findChildrenWithPropertiesAndInvoke, getChannel, getChildren, getDataDrivableCommands, getField, getIgnorableProperties, getMappableChildren, getMappableParent, getObjectClassName, getObjectCustomClassName, getOwnedObjects, getParent, getProxy, getScriptCommandAnchor, getVisualMappableChildren, getVisualTopParent, getVOMSpecificProperty, hasSpecialFrameState, isClassIndexConsidered, isSameObject, isValidObject, ping, suppressKeyAction
 
Methods inherited from class com.rational.test.ft.sys.RegisteredObject
addProxyReference, dereference, getObject, getRegisteredId, getTransactionId, isReferenced, isReleaseRequired, register, registerTransiently, release, toString, unregister
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

JTableProxy

public JTableProxy(java.lang.Object theObjectInTheSUT)
This sole constructor for all proxy objects sets the SUT object as a member variable for the proxy. All interactions with the supplied object are performed through this class.

Method Detail

getRole

public java.lang.String getRole()
Returns TestObjectRole.ROLE_TABLE.

Overrides:
getRole in class JScrollPaneProxy
Returns:
A brief type name that describes the role this object plays in the UI.
Since:
RFT1.0

shouldBeMapped

public boolean shouldBeMapped()
Returns true for JTableProxy.

Overrides:
shouldBeMapped in class JScrollPaneProxy
Returns:
true

getSubitem

public java.lang.Object getSubitem(com.rational.test.ft.script.Subitem subitem)
Returns an object that represents the specified subitem in the associated test object. SubitemNotFoundException will be thrown if the specified subitem is invalid relative to the associated test object. null may be returned if the subitem does not have an object association that can be returned.

Specified by:
getSubitem in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
Overrides:
getSubitem in class JScrollPaneProxy
Parameters:
subitem - The subitem to fetch an object for.
Returns:
An object representation of the subitem.

columnAtPoint

protected int columnAtPoint(java.awt.Point pt)
This method returns the column index for the column at the specified Point. The supplied point is the Header relative location and NOT the screen relative location. If the appropriate column can not be determined then a negative one (-1) should be returned to indicate that the column could not be determined.

Parameters:
pt - The Header component relative coordinates that should be used to determine the column index.
Returns:
The column index at the specified point or -1 if the column can not be determined.

rowAtPoint

protected int rowAtPoint(java.awt.Point pt)
This method returns the row index for the row at the specified Point. The supplied point is the Table relative location and NOT the screen relative location. If the appropriate row can not be determined then a negative one (-1) should be returned to indicate that the row could not be determined.

Parameters:
pt - The Table component relative coordinates that should be used to determine the row index.
Returns:
The row index at the specified point or -1 if the row can not be determined.

getColumnCount

protected int getColumnCount()
This method returns the number of columns in the table header component under evaluation.

Returns:
The column count, zero if the count can not be determined.

getRowCount

protected int getRowCount()
This method returns the number of rows in the table component under evaluation.

Returns:
The row count, zero if the count can not be determined.

getColumnName

protected java.lang.String getColumnName(int nColumn)
This method returns the name of the column at the specified column index. This is typically the title of the column, but may be an icon description or other value that uniquely identifies the column. If the column does not have name then null or "" should be returned. Note, that without a name to identify a column the column index will be used in it's place.

Parameters:
nColumn - The column index for which a name should be created.
Returns:
The title (or other name) for the column at nColumn index into the table header.

getColumnHeader

protected java.lang.String getColumnHeader(int nColumn)
This method returns the name of the column at the specified column index. This is typically the title of the column, but may be an icon description or other value that uniquely identifies the column. If the column does not have name then null or "" should be returned. Note, that without a name to identify a column the column index will be used in it's place.

Parameters:
nColumn - The column index for which a name should be created.
Returns:
The title (or other name) for the column at nColumn index into the table header.

getCellRectangle

protected java.awt.Rectangle getCellRectangle(int nColumn,                                               int nRow)
This method returns the table relative rectangle for the specified cell. This is used to get the cell relative coordinates for drag operations against a table component.

Parameters:
nColumn - The column index to get the table rectangle for.
nRow - The row index to get the table rectangle for.
Returns:
The table relative rectangle for nColumn's header. Null should be returned if the rectangle can not be computed.

isCellEditable

protected boolean isCellEditable(int nColumn,                                  int nRow)
This method returns TRUE if the specified cell is read/write and FALSE if the cell is read/only.

Parameters:
nColumn - The column index to get the cell state for.
nRow - The row index to get the cell state for.
Returns:
true only if the specified cell is read/write.

isColumnSelected

protected boolean isColumnSelected(int columnIndex)
Returns true if the column at the specified index is selected.

Parameters:
columnIndex - the index of the column in the column model
Returns:
true if the column at the specified index is selected, where 0 is the first column.

isCellSelected

protected boolean isCellSelected(int rowIndex,                                  int columnIndex)
Returns true if the column at the specified index is selected.

Parameters:
columnIndex - the index of the column in the column model
Returns:
true if the column at the specified index is selected, where 0 is the first column.

isRowSelected

protected boolean isRowSelected(int rowIndex)
Returns true if the row at the specified index is selected.

Parameters:
rowIndex - the index of the row
Returns:
true if the row at the specified index is selected, where 0 is the first row.

getColumnSelectionAllowed

protected boolean getColumnSelectionAllowed()
Returns true<\b> if columns can be selected.

Returns:
true<\b> if columns can be selected, otherwise false<\b>

getRowSelectionAllowed

protected boolean getRowSelectionAllowed()
Returns true<\b> if columns can be selected.

Returns:
true<\b> if columns can be selected, otherwise false<\b>

getSelectedColumns

protected int[] getSelectedColumns()
Returns the indices of all selected columns.

Returns:
an array of integers containing the indices of all selected columns, or an empty array if no column is selected

getSelectedRows

protected int[] getSelectedRows()
Returns the indices of all selected rows.

Returns:
an array of integers containing the indices of all selected rows, or an empty array if no row is selected

getFirstSelectedRow

protected int getFirstSelectedRow()

clearSelection

protected void clearSelection()
Deselects all selected columns and rows.


setColumnSelectionInterval

protected void setColumnSelectionInterval(int index0,                                           int index1)
Selects the columns from index0 to index1, inclusive.

Parameters:
index0 - one end of the interval index1 the other end of the interval

addColumnSelectionInterval

protected void addColumnSelectionInterval(int index0,                                           int index1)
Adds the columns from index0 to index1, inclusive, to the current selection.

Parameters:
index0 - one end of the interval index1 the other end of the interval

setRowSelectionInterval

protected void setRowSelectionInterval(int index0,                                        int index1)
Selects the rows from index0 to index1, inclusive.

Parameters:
index0 - one end of the interval index1 the other end of the interval

addRowSelectionInterval

protected void addRowSelectionInterval(int index0,                                        int index1)
Adds the rows from index0 to index1, inclusive, to the current selection.

Parameters:
index0 - one end of the interval index1 the other end of the interval

changeSelection

protected void changeSelection(int rowIndex,                                int columnIndex,                                boolean toggle,                                boolean extend)

getRenderedStringAt

protected java.lang.String getRenderedStringAt(int nRow,                                                int nColumn)

getRenderedStringAt

protected java.lang.String getRenderedStringAt(int nRow,                                                int nColumn,                                                boolean checkLength)
This method returns the value in the specified table cell. nColumn+nRow determines which cell to query the value from. If the value in the cell is not a String type value then a String image of the cell contents should be constructed. For instance if the cell contents are int/Integer then the Integer.toString method could be used.

Parameters:
nColumn - The column index to get the table cell image for.
nRow - The row index to get the table cell image for.
checkLength - The flag to check the lenght
Returns:
Image of the contents of the cell at nColumn plus nRow in the Table being evaluated.

getValueAt

protected java.lang.Object getValueAt(int nRow,                                       int nColumn)
This method returns the value in the specified table cell. nColumn+nRow determines which cell to query the value from. If the value in the cell is not a String type value then a String image of the cell contents should be constructed. For instance if the cell contents are int/Integer then the Integer.toString method could be used.

Parameters:
nColumn - The column index to get the table cell image for.
nRow - The row index to get the table cell image for.
Returns:
Image of the contents of the cell at nColumn plus nRow in the Table being evaluated.

getModel

protected javax.swing.table.TableModel getModel()

getObjectStringAt

protected java.lang.String getObjectStringAt(int nRow,                                              int nColumn)

getCell

protected com.rational.test.ft.script.Cell getCell(java.awt.Point pt)

getCell

protected com.rational.test.ft.script.Cell getCell(int columnIndex,                                                    int rowIndex)

getColumn

protected com.rational.test.ft.script.Column getColumn(java.awt.Point pt)

getColumn

protected com.rational.test.ft.script.Column getColumn(int columnIndex)

getRow

protected com.rational.test.ft.script.Row getRow(java.awt.Point pt)

getRow

protected com.rational.test.ft.script.Row getRow(int rowIndex)

getKeyColumns

public int[] getKeyColumns(int nRow)
This method returns a list of up to three "key" columns that may be used to determine a row in the table in a unique fashion. Typically we would choose the first three read/only columns in the table and use them if they proved to be unique for this instance of a table. The algorithm chosen may vary, but checking for the editable state of a column before using it as a key field is typically a good choice. Key columns are paired with the value in a row to be uniquely identified. For instance if there is a column titled "Employee ID", pairing this column title with the value in a particular row "8042" could uniquely identify the row as row index 12. Using more than one key increases the chances that the key+value across all the key columns will uniquely identify only one row. If no key columns can be definitively determined then a zero length list should be returned. If more then three key columns are returned then the keys past the third will be ignored.

Returns:
A list of up to three column indices to be used to uniquely identify a row in the table. null or a zero length list should be returned if no good key columns can be determined.

testKeysForUniqueness

protected boolean testKeysForUniqueness(int row,                                         int roCol,                                         int[] roCols,                                         java.lang.String[] roValues)

setState

public void setState(com.rational.test.ft.script.Action action)
This method performs a specific action.

Specified by:
setState in interface com.rational.test.ft.object.interfaces.ISubitem
Overrides:
setState in class JScrollPaneProxy
Parameters:
action - The action that should be performed.

setState

public void setState(com.rational.test.ft.script.Action action,                      com.rational.test.ft.script.Subitem item)
This method performs a specific action against the subitem.

Specified by:
setState in interface com.rational.test.ft.object.interfaces.ISubitem
Overrides:
setState in class JScrollPaneProxy
Parameters:
item - The item to act upon.
action - The action that should be performed.

setState

public void setState(com.rational.test.ft.script.Action action,                      com.rational.test.ft.script.Subitem start,                      com.rational.test.ft.script.Subitem end)
This method performs a specific action against the subitem range defined by the specified indices.

Specified by:
setState in interface com.rational.test.ft.object.interfaces.ISubitem
Overrides:
setState in class JScrollPaneProxy
Parameters:
start - The first item to act upon.
end - The last item to act upon.
action - The action that should be performed.

processSingleMouseEvent

public void processSingleMouseEvent(IMouseActionInfo action)
Return a MethodSpecification for the specified mouse event. This is the primary record interface for mouse events against a particular control.

Overrides:
processSingleMouseEvent in class JavaGuiProxy
Parameters:
action - The event cache and other mouse state information for this mouse action.

getMethodSpecForPoint

public com.rational.test.ft.sys.MethodSpecification getMethodSpecForPoint(java.awt.Point pt)
Return a MethodSpecification for a method that returns a java.awt.Point for the specified coordinates. By default a method specification for IGraphical.getScreenPoint will be returned. However, if a proxy can find

Overrides:
getMethodSpecForPoint in class JavaGuiProxy
Parameters:
x - The screen relative x coordinate.
y - The screen relative y coordinate.
See Also:
MethodSpecification

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 JavaProxy
Returns:
An hashtable of type/description pairs used to describe the verification data available from this proxy.
Since:
RFT1.0
See Also:
getTestData(String), ITestData

getTestData

public com.rational.test.ft.vp.ITestData getTestData(java.lang.String testDataType)
Constructs the specified verification data object. The testDataType parameter is a hashtable key returned by getTestDataTypes().

Overrides:
getTestData in class ProxyTestObject
Parameters:
testDataType - A test data type supplied by getTestDataTypes().
Returns:
The verification data for the supplied type.
Since:
RFT1.0
See Also:
getTestDataTypes(), ITestData

getTestDataTableAt

protected java.lang.Object getTestDataTableAt(int row,                                               int col,                                               java.lang.String type,                                               javax.swing.table.TableModel model)

updateTestData

public com.rational.test.ft.vp.ITestData updateTestData(java.lang.String testDataType,                                                         com.rational.test.ft.vp.ITestData testData)
Updates the supplied test data object and returns it. The testDataType parameter is a hashtable key returned by getTestDataTypes(). The testData is a previously supplied ITestData object that needs to be updated to reflect the current state of the associated test object.

Overrides:
updateTestData in class ProxyTestObject
Parameters:
testDataType - A test data type supplied by getTestDataTypes().
testData - The test data base object that requires updating.
Returns:
The testData passed in with appropriate updates.
Since:
RFT1.0
See Also:
getTestDataTypes(), ITestData

getScreenRectangle

public java.awt.Rectangle getScreenRectangle(com.rational.test.ft.script.Subitem subitem)
Returns the rectangle that contains the component being evaluated relative to the top left corner of the screen. This will commonly be two operations (getScreenRectangle for the parent object and then adjusting for the specified subitem) combined into a single operation. The rectangle is exposed so that actions may be directly scripted against a visible subitem. null is returned if the subitem is not showing.

Specified by:
getScreenRectangle in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
Overrides:
getScreenRectangle in class JScrollPaneProxy
Returns:
The adjusted rectangle surrounding subitem relative to the screen. null is returned if the subitem is not showing.

canBeScrolled

public boolean canBeScrolled()
Returns true if the object is associated with scrollbar(s). By default, it returns false<\b>.

Overrides:
canBeScrolled in class ComponentProxy
Returns:
true if the object is associated with scrollbar(s).

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 IDataDriven
Overrides:
getDataDrivableCommand in class ProxyTestObject
Since:
RFT2.0
See Also:
ProxyTestObject.getDataDrivableCommands(int)

addDataDrivableCommands

protected void addDataDrivableCommands(ProxyTestObject proxy,                                        java.util.Vector commands,                                        int includeChildren)
Overrides:
addDataDrivableCommands in class ProxyTestObject