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

java.lang.Object   com.rational.test.ft.sys.RegisteredObject       com.rational.test.ft.domain.ProxyTestObject
          com.rational.test.ft.domain.java.JavaProxy
              com.rational.test.ft.domain.java.JavaGuiProxy
                  com.rational.test.ft.domain.java.awt.ComponentProxy
                      com.rational.test.ft.domain.java.jfc.JComponentProxy
                          com.rational.test.ft.domain.java.jfc.JfcGraphicalSubitemProxy
                              com.rational.test.ft.domain.java.jfc.JScrollPaneProxy
                                  com.rational.test.ft.domain.java.jfc.JListProxy

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

public class JListProxy
extends JScrollPaneProxy
implements com.rational.test.ft.object.interfaces.ISubitem

Proxy for the javax.swing.JList class.

• TestObject interface:
  SelectGuiSubitemTestObject
  

• Supported Test Data Types:
  

  Type	Desciption	Data Class
  list	List Elements	ITestDataList
  selected	Selected List Elements	ITestDataList

  
  
  

• Default Recognition Properties:
  

  Property	Usage
  .class	The Java full class name of the test object.
  .classIndex	The zero-based index of the class relative to the immediate parent in the object map.
  .itemCount	The number of items in the list.
  .itemText	The text for the up to ten items from the list.
  .priorLabel	The text of a preceding label. Suppressed if there is no preceding label.
  accessibleContext.accessibleName	A programmatically defined name for the component.
  name	The name property, suppressed if default formatted (default form = className+count).
  toolTipText	The text from the associated tool tip, omitted if there is no associated tool tip.

  
  

• Supported Subitems:
  

  Subitem	Usage
  Text	Defines the element with the specified visible text.
  Index	Defines the element at the specified zero-based index.

  
  

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

JListProxy(java.lang.Object theObjectInTheSUT)
This sole constructor for all proxy objects sets the SUT object as a member variable for the proxy.

Method Summary

boolean	canBeScrolled() Returns true if the object is associated with scrollbar(s).
protected void	deselect(int item) This method deselects a subitem at a specified index.
protected void	deselectAll() Deselects all the selected items.
protected void	ensureIndexIsVisible(int index) If this JList is being displayed within a JViewport and the specified cell isn't completely visible, scroll the viewport to make this cell visible.
protected void	extendSelect(int item) This method extends the current selection to include a subitem at a specified index.
protected int	getAdjustedLastVisibleIndex()
protected java.lang.String[]	getAllText(int limit)
protected java.awt.Rectangle	getCellBounds(int index0, int index1) Returns the bounds of the specified range of items in JList coordinates.
com.rational.test.ft.sys.MethodSpecification	getDataDrivableCommand() This method must be implemented by any proxy that wishes to support data driving.
protected int	getFirstSelectedIndex()
protected int	getFirstVisibleIndex() Returns the index of the cell in the upper left corner of the JList or -1 if nothing is visible or the list is empty.
protected int	getItemCount()
protected int	getItemIndex(java.lang.String item) Returns the index in the JList of item .
protected int	getItemIndex(com.rational.test.ft.script.Subitem item) Returns the index in the JList of item.
protected int	getItemIndex(com.rational.test.ft.script.Text item) Returns the index in the JList of item.
protected java.lang.String	getItemText(int index) Returns the value at the specified index.
protected int	getLastVisibleIndex() Returns the index of the cell in the lower left corner of the JList or -1 if nothing is visible or the list is empty.
ProxyTestObject[]	getMappableChildren() Uses getChildren to implement.
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.ListModel	getModel() Returns the data model that holds the list of items displayed by the JList component.
protected java.lang.Object	getObjectAtIndex(int index)
ProxyTestObject	getOwner() Returns a proxy object for the owner of this object.
java.util.Hashtable	getProperties() Returns a complete set of properties for the associated test object.
java.lang.Object	getProperty(java.lang.String propertyName) Get the value for a specific property.
java.lang.String	getRole() Returns TestObjectRole.ROLE_LIST.
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[]	getSelectedIndices()
protected java.lang.String[]	getSelectedItems()
protected java.lang.Object[]	getSelectedTestDataObjects()
java.lang.String	getSelectedText() Allows direct access to the selected text property on the control.
protected com.rational.test.ft.script.Subitem	getSubitem(int index) Returns the Subitem at the specified index.
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) This method constructs the specified verification data object.
protected java.lang.Object[]	getTestDataObjects()
java.util.Hashtable	getTestDataTypes() Returns a hashtable of data type descriptions of the verification point data available with the associated object in the SUT.
java.lang.String	getTestObjectClassName() Return the ListTestObject classname, the default JList test object.
java.lang.String	getText() Allows direct access to the text property on the control.
protected boolean	isSelectedIndex(int index) Returns true if the specified index is selected.
protected int	locationToIndex(java.awt.Point currentPoint) Returns the origin of the specified item in JList coordinates.
void	processSingleMouseEvent(IMouseActionInfo action) Return a MethodSpecification for the specified mouse event.
void	select(int item)
void	select(java.lang.String item)
protected void	selectProgrammatically(int item) This method selects a subitem at a specified index.
void	setProperty(java.lang.String propertyName, java.lang.Object value) Sets the value for a specific property.
void	setState(com.rational.test.ft.script.Action action) This method performs a specific action.
protected void	setState(com.rational.test.ft.script.Action action, int item) This method performs a specific action against the subitem at a specified index.
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 at a specified index.
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 JListProxy.
com.rational.test.ft.vp.ITestData	updateTestData(java.lang.String testDataType, com.rational.test.ft.vp.ITestData testData) This method 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, 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, 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, getMappableParent, getName, getOwnedObjects, 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

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

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

JListProxy

public JListProxy(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

getTestObjectClassName

public java.lang.String getTestObjectClassName()

Return the ListTestObject classname, the default JList test object.

Specified by:

getTestObjectClassName in interface IProxyBase

Overrides:

getTestObjectClassName in class JfcGraphicalSubitemProxy

Returns:

The default JList test object class full name.

getProperties

public java.util.Hashtable getProperties()

Description copied from class: ProxyTestObject

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 ProxyTestObject.getNonValueProperties() returns information about such properties.

Overrides:

getProperties in class JComponentProxy

Returns:

The set of known properties associated with a test object.

See Also:

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

getProperty

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

Get the value for a specific property.

Overrides:

getProperty in class JComponentProxy

Parameters:

propertyName - The name of the property to fetch.

Returns:

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

See Also:

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

setProperty

public void setProperty(java.lang.String propertyName,                         java.lang.Object value)

Description copied from class: JavaProxy

Sets the value for a specific property.

Overrides:

setProperty in class JavaProxy

Parameters:

propertyName - The name of the property to redefine. This name is the same as that returned by getProperties().

See Also:

ProxyTestObject.getProperties(), ProxyTestObject.getProperty(String)

getMappableChildren

public ProxyTestObject[] getMappableChildren()

Uses getChildren to implement.

Overrides:

getMappableChildren in class ComponentProxy

Returns:

null for JListProxy.

getOwner

public ProxyTestObject getOwner()

Returns a proxy object for the owner of this object. Returns null if this object has no owner.

Overrides:

getOwner in class ComponentProxy

Returns:

The proxy for the owning object or null for a top object without an owner.

getRole

public java.lang.String getRole()

Returns TestObjectRole.ROLE_LIST.

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

Overrides:

shouldBeMapped in class JScrollPaneProxy

Returns:

true

locationToIndex

protected int locationToIndex(java.awt.Point currentPoint)

Returns the origin of the specified item in JList coordinates. Returns null if index isn't valid.

Parameters:

index - the index of the JList cell

Returns:

the origin of the index'th cell

getFirstVisibleIndex

protected int getFirstVisibleIndex()

Returns the index of the cell in the upper left corner of the JList or -1 if nothing is visible or the list is empty. Note that this cell may only be partially visible.

Returns:

the index of the first visible cell

getLastVisibleIndex

protected int getLastVisibleIndex()

Returns the index of the cell in the lower left corner of the JList or -1 if nothing is visible or the list is empty. Note that this cell may only be partially visible.

Returns:

the index of the last visible cell

getAdjustedLastVisibleIndex

protected int getAdjustedLastVisibleIndex()

getCellBounds

protected java.awt.Rectangle getCellBounds(int index0,                                            int index1)

Returns the bounds of the specified range of items in JList coordinates. Returns null if index isn't valid.

Parameters:

index0 - the index of the first JList cell in the range index1 the index of the last JList cell in the range

Returns:

the bounds of the indexed cells in pixels

getModel

protected javax.swing.ListModel getModel()

Returns the data model that holds the list of items displayed by the JList component.

Returns:

the ListModel that provides the displayed list of items

isSelectedIndex

protected boolean isSelectedIndex(int index)

Returns true if the specified index is selected.

Parameters:

index - index to be queried for selection state

Returns:

true if the specified index is selected

getSelectedItems

protected java.lang.String[] getSelectedItems()

getSelectedTestDataObjects

protected java.lang.Object[] getSelectedTestDataObjects()

getSelectedIndices

protected int[] getSelectedIndices()

getFirstSelectedIndex

protected int getFirstSelectedIndex()

getItemText

protected java.lang.String getItemText(int index)

Returns the value at the specified index.

Parameters:

index - the specified index.

Returns:

a String if the object at the specified index is a String or has text on it.

getItemCount

protected int getItemCount()

getObjectAtIndex

protected java.lang.Object getObjectAtIndex(int index)

getTestDataObjects

protected java.lang.Object[] getTestDataObjects()

getAllText

protected java.lang.String[] getAllText(int limit)

getSubitem

protected com.rational.test.ft.script.Subitem getSubitem(int index)

Returns the Subitem at the specified index.

Parameters:

index - the specified index.

Returns:

a Subitem.

getItemIndex

protected int getItemIndex(java.lang.String item)

Returns the index in the JList of item .

Parameters:

item - a String

Returns:

index of the item if it's in JLIst -1 if cannot find it in JList

getItemIndex

protected int getItemIndex(com.rational.test.ft.script.Text item)

Returns the index in the JList of item.

Parameters:

item - a Text

Returns:

index of the item it's in JLIst -1 if cannot find it in JList

getItemIndex

protected int getItemIndex(com.rational.test.ft.script.Subitem item)

Returns the index in the JList of item.

Parameters:

item - a Subitem

Returns:

index of the item it's in JLIst -1 if cannot find it in JList

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.

ensureIndexIsVisible

protected void ensureIndexIsVisible(int index)

If this JList is being displayed within a JViewport and the specified cell isn't completely visible, scroll the viewport to make this cell visible.

Parameters:

index - the index of the cell to make visible

getSelectedText

public java.lang.String getSelectedText()

Allows direct access to the selected text property on the control.

Returns:

The selected text in the control

Since:

RFT2.0

getText

public java.lang.String getText()

Allows direct access to the text property on the control.

Returns:

The text of all elements in the control

Since:

RFT2.0

deselectAll

protected void deselectAll()

Deselects all the selected items.

select

public void select(java.lang.String item)

select

public void select(int item)

selectProgrammatically

protected void selectProgrammatically(int item)

This method selects a subitem at a specified index.

Parameters:

item - The index of the item to select.

deselect

protected void deselect(int item)

This method deselects a subitem at a specified index.

Parameters:

item - The index of the item to deselect.

extendSelect

protected void extendSelect(int item)

This method extends the current selection to include a subitem at a specified index.

Parameters:

item - The index of the item to select.

setState

protected void setState(com.rational.test.ft.script.Action action,                         int item)

This method performs a specific action against the subitem at a specified index.

Parameters:

item - The index of the item to act upon.

action - The action that should be performed.

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 at a specified index.

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.

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)

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

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.

getTestDataTypes

public java.util.Hashtable getTestDataTypes()

Returns a hashtable of data type descriptions of the verification point data available with the associated object in the SUT. 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 defferent then 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.

See Also:

getTestData(String), ITestData

getTestData

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

This method constructs the specified verification data object. The testDataType parameter is one of the hashtable keys 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.

See Also:

getTestDataTypes(), ITestData

updateTestData

public com.rational.test.ft.vp.ITestData updateTestData(java.lang.String testDataType,                                                         com.rational.test.ft.vp.ITestData testData)

This method updates the supplied test data object and returns it. The testDataType parameter is one of the hashtable keys 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.

See Also:

getTestDataTypes(), ITestData

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