com.rational.test.ft.domain.html

Class HtmlDialogProxy

java.lang.Object

RegisteredObject

com.rational.test.ft.domain.ProxyTestObject

com.rational.test.ft.domain.html.HtmlProxy

com.rational.test.ft.domain.html.HtmlGuiProxy

com.rational.test.ft.domain.html.TopLevelWindowProxy

com.rational.test.ft.domain.html.HtmlDialogProxy

All Implemented Interfaces:

IDataDriven, IGetInterestingRecogProsForDynFind, IHtmlCustomDomainEnablement, IInternalObjectStatus, IProxyBase, IQuickFind, IXPathFind

Direct Known Subclasses:

BrowserDialogProxy

public class HtmlDialogProxy
extends TopLevelWindowProxy

Provides the proxy for HTML browser objects in the HtmlTestDomainImplementation.

• TestObject Interface: TopLevelTestObject
  
  
• Default Recognition Properties:
  • .caption
  • .class
  
  
• Supported Canonical Properties:
  

  Property	Usage
  .bounds	A rectangle representing the bounding rectangle of the object in screen coordinates.
  .caption	For TABLE elements is the the value of the caption attribute. For an Html dialog this is the text of the dialog's caption.
  .class	This is the test object class name, for example "HtmlTable" for a <Table> element.
  .window	This is the heavyweight window for the element returned as a long. For the Browser, this is the top level window.

  
  

Since:

RFT1.0

Nested Class Summary

Nested classes/interfaces inherited from class com.rational.test.ft.domain.html.TopLevelWindowProxy

TopLevelWindowProxy.CharEmiter, TopLevelWindowProxy.KeyEmiter

Nested classes/interfaces inherited from class com.rational.test.ft.domain.html.HtmlGuiProxy

HtmlGuiProxy.Clicker, HtmlGuiProxy.DoubleClicker, HtmlGuiProxy.Dragger, HtmlGuiProxy.Hoverer, HtmlGuiProxy.nClickDragger, HtmlGuiProxy.nClicker, HtmlGuiProxy.PointIterator

Nested classes/interfaces inherited from class com.rational.test.ft.domain.html.HtmlProxy

HtmlProxy.GetObjectRunnable, HtmlProxy.HtmlElementEnumeration, HtmlProxy.IntegerByReference, HtmlProxy.InvalidNativeHandleException, HtmlProxy.JSObjectHtmlElementEnumeration, HtmlProxy.NativeProxyReleasedException

Field Summary

Fields

Modifier and Type	Field and Description
protected static FtDebug	debug

Fields inherited from class com.rational.test.ft.domain.html.HtmlGuiProxy

currentMethod, LEFT, MAXIMIZE, OFFSETHEIGHTPROPERTY, OFFSETLEFTPROPERTY, OFFSETRECTPROPERTY, OFFSETTOPPROPERTY, OFFSETWIDTHPROPERTY, RESTORE

Fields inherited from class com.rational.test.ft.domain.html.HtmlProxy

BODYTAG, BOUNDSPROPERTY, channel, CLASSINDEX, CLASSPROPERTY, CLIENTRECTPROPERTY, DISABLEDPROPERTY, DOCCLASSINDEX, dojoProps, domain, HTMLPROXYCHANNELRUNNABLE_TIMEOUTVALUE, IDPROPERTY, isSiebelActive, jswarapper, NAMEPROPERTY, parentsTextDescendantsMayBeInteresting, READONLYPROPERTY, TAGPROPERTY, TESTDATA_TEXT, TEXTPROPERTY, TITLEPROPERTY, UNIQUEIDPROPERTY

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

CUSTOM_DOMAIN_LIST, DOJO_CUSTOM_DOMAIN_NAME, SAPWEBPORTAL_CUSTOM_DOMAIN_NAME

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

INCLUDE_ALL, INCLUDE_JUSTOBJECT, INCLUDE_SIBLINGS

Constructor Summary

Constructors

Constructor and Description
HtmlDialogProxy(HtmlTestDomainImplementation domain, IChannel channel, long handle)
HtmlDialogProxy(HtmlTestDomainImplementation domain, IChannel channel, long handle, IBrowserCommunicator jswrap)
HtmlDialogProxy(HtmlTestDomainImplementation domain, IChannel channel, Window window)

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	getChildAtPoint(java.awt.Point pt) Finds the most interesting child object at the specified point.
com.rational.test.ft.object.interfaces.IGraphical	getClippingParent() Get the clipping parent for this object.
java.lang.String	getDescriptiveName() Returns a name that can be used to describe the associated UI object in a script.
ProxyTestObject	getMappableParent() Walks the HtmlProxy.getParent() relationship until a mappable parent is encountered.
ProxyTestObject	getMappableParent(ContextObject co) Walks the HtmlProxy.getParent() relationship until a mappable parent is encountered.
ProxyTestObject	getParent() Returns null always because object relationships are not understood at this level of abstaction.
ProxyTestObject	getParent(ContextObject co) Returns null always because object relationships are not understood at this level of abstaction.
java.lang.Object	getProperty(java.lang.String propertyName) Get the value for a specific property.
java.lang.Object	getPropertyInternal(java.lang.String propertyName)
java.util.Hashtable	getStandardProperties() overriding getstandard properties for js domain, else call super.getproperties
java.lang.String	getTestObjectClassName() Returns the class name for the TestObject.
java.lang.String	getUniqueId() Returns a string for the associated object.
TopLevelWindow	getWindow()
boolean	isShowing()
boolean	shouldBeMapped() Always returns true, because browser objects must always be mapped.

Methods inherited from class com.rational.test.ft.domain.html.TopLevelWindowProxy

activate, clickDisabled, close, contextHelp, getOwner, getScriptCommandFlags, inputChars, inputKeys, isIconified, maximize, minimize, move, processBrowserPostUpMouseEvent, processBrowserPreDownMouseEvent, processMouseEvent, resize, restore

Methods inherited from class com.rational.test.ft.domain.html.HtmlGuiProxy

activateTopWindow, click, click, click, clickAtScreenPoint, clickWithMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouseN, convertFromScreenToOffset, doScroll, doubleClick, doubleClick, doubleClick, doubleClickAtScreenPoint, drag, drag, drag, drag, dragAtScreenPoint, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, ensureObjectIsVisible, getActionArgs, getChildAtPoint, getChildAtPointN, getChildrenHandlesMatchingProperty, getClippedScreenRectangle, getClippingParentRectangle, getCurrentMethod, getDefaultActionArgs, getDefaultPointToClick, getDefaultPointToClick, getMappableDocument, getMethodName, getMethodSpecForPoint, getPointFromAction, getPointOnObject, getPointToClick, getScreenCenter, getScreenPoint, getScreenPoint, getScreenRectangle, getTargetChildHandles, getTargetChildItem, getTargetChildItem, getTargetChildItems, getVisualClippableParent, hasFocus, hover, hover, hover, hover, hoverAtScreenPoint, isEnabled, isInView, isInView, isOpaque, isPointInObject, isPointInObject, mouseMove, mouseMove, nClick, nClick, nClickAtScreenPoint, nClickDrag, nClickDragAtScreenPoint, nClickDragToScreenPoint, performAction, performClick, performClick, performDoubleClick, performSelect, performSetText, performWindowAction, processHoverMouseEvent, processPreDownMouseEvent, processPreUpMouseEvent, proxyGetChildAtPoint, restoreTopLevelWindow, scrollIntoView, scrollIntoView, scrollIntoView, scrollIntoViewN, scrollIntoViewWithDirection, scrollIntoViewWithDirectionN, setClickArgs, setCurrentMethod, setDownPointArgs, setDrag, setMethodSpecification, setMethodSpecification, setMultiClickAction, snapToRectangle

Methods inherited from class com.rational.test.ft.domain.html.HtmlProxy

addAdditionalRecognitionProperties, addChildrenHandlesToVector, addChildrenToVector, addChildrenToVector, addDataDrivableCommands, addDojoDomain, addRecognitionProperty, adjustCustomDomains, calculateParentsTextDescendantsMayBecomeInteresting, callJqueryFind, clearAllSubdomains, clearCustomSubdomains, detach, disableAllHtmlCustomDomains, disableHtmlCustomDomain, disableHtmlCustomDomains, enableAllHtmlCustomDomains, enableHtmlCustomDomain, enableHtmlCustomDomains, equals, fetchProperties, find, findElementsByXpath, findElementsDirectly, findElementsViaQuery, findElementWithDynamicFind, findElementWithName, getAddedRecognitionProperty, getAddedRecognitionPropertyValue, getAddedRecognitionPropertyWeight, getBrowserAppVersion, getCachedData, getChannel, getChildren, getChildren, getChildren, getChildrenEnumeration, getChildrenEnumeration, getChildrenHandleEnumeration, getChildrenHandles, getChildrenN, getChildrenWithTagType, getClassIndex, getCustomClassProperty, getCustomClassPropertyValue, getCustomDomainName, getCustomDomainName, getCustomDomainName, getCustomDomainNameForChildren, getCustomDomainNameForParent, getCustomObject, getDataDrivableCommand, getDisabledProperty, getDocClassIndex, getDocument, getDocument, getDocumentHandle, getDocumentWindow, getDomain, getElementHandlesByTag, getElementObjectsByTag, getElementsByNameInProxyTestObjects, getElementsByTag, getElementsByTag, getElementsByTagEnumeration, getElementsByTagInProxyTestObjects, getElementsByTagN, getElementsByXpath, getElementsByXpath, getElementsByXpathEnumeration, getElementsDirectly, getHandle, getHtmlTag, getHtmlTagNameFromClassProperty, getIgnorableProperties, getIndexer, getIndexers, getInterestingRecogPropsForDynFind, getJsProps, getJswarapper, getMappableChildren, getMappableChildren, getMappableElementsByNameInProxyTestObjects, getMappableElementsByTagInProxyTestObjects, getMethods, getNonValueProperties, getObject, getObjectClassName, getOwnedObjects, getOwnedObjects, getParentN, getProperties, getProperties, getProperty, getPropertyInternalRunnable, getPropertyN, getProxyTestObjectsFromEnumeration, getReadOnlyProperty, getRecognitionProperties, getRecognitionPropertyWeight, getRole, getSavedDescriptiveName, getStandardProperties, getTestData, getTestDataTypes, getTestDomain, getText, getTopMappableParent, getTopParent, getTopParent, getTopParentInternal, getTopParentN, getValueProperty, getVisualTopParent, hasAddedRecognitionProperties, isClassIndexConsidered, isClassIndexPropertyAndValueDefined, isClassIndexSet, isContextObjectSet, isContextObjectSet, isDocClassIndexSet, isEqual, isFindOptimized, isObjectDead, isPropertyOptimizable, isReleaseRequired, isSameObject, isScoreForFindBYIdorName, isValidRecognitionProperty, isXpathSupported, matches, release, release, release, release, release, release, releaseElementHandle, releaseN, replaceAll, restoreAllCustomSubDomains, restoreCustomSubDomains, setCachedData, setClass, setClassIndex, setClassIndex, setClassIndex, setClassIndex, setClassIndex, setClassIndexOfChild, setCustomClassProperty, setCustomClassPropertyValue, setCustomDomainInContext, setDocClassIndex, setDocClassIndex, setDocClassIndex, setDocClassIndex, setDomain, setIndexer, setJswarapper, setProperty, setProperty, setSavedDescriptiveName, shouldDocumentBeAdded, split, updateTestData

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

baseClassMatch, canTakeVP, findChildrenWithProperties, findChildrenWithPropertiesAndInvoke, getDataDrivableCommands, getElementWithFocus, getField, getObjectCustomClassName, getProxy, getScriptCommandAnchor, getVisualClippedRectangle, getVisualMappableChildren, getVOMSpecificProperty, hasSpecialFrameState, isValidObject, ping, suppressKeyAction

Methods inherited from class java.lang.Object

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

Field Detail

debug

protected static FtDebug debug

Constructor Detail

HtmlDialogProxy

public HtmlDialogProxy(HtmlTestDomainImplementation domain,
               IChannel channel,
               long handle)

HtmlDialogProxy

public HtmlDialogProxy(HtmlTestDomainImplementation domain,
               IChannel channel,
               long handle,
               IBrowserCommunicator jswrap)

HtmlDialogProxy

public HtmlDialogProxy(HtmlTestDomainImplementation domain,
               IChannel channel,
               Window window)

Method Detail

getTestObjectClassName

public java.lang.String getTestObjectClassName()

Returns the class name for the TestObject. Browser objects are top-level objects. This class will be instantiated in the client.

Specified by:

getTestObjectClassName in interface IProxyBase

Overrides:

getTestObjectClassName in class HtmlGuiProxy

Returns:

The default mashaller class full name.

Since:

RFT1.0

shouldBeMapped

public boolean shouldBeMapped()

Always returns true, because browser objects must always be mapped.

Overrides:

shouldBeMapped in class HtmlProxy

Returns:

true element has an id or name. false not a supported HTML object type

Since:

RFT1.0

getDescriptiveName

public java.lang.String getDescriptiveName()

Description copied from class: HtmlProxy

Returns a name that can be used to describe the associated UI object in a script. This name may be further adjusted to be made unique to the script, but will act as the base for the name used in the script. Only characters used in Html identifiers should be returned (alphabetic, numeric or underscore characters). Non-identifier characters will cause script compilation failures. An example of what to return may be "OKButton" for a Html.BUTTON with the text "OK" on it.

Overrides:

getDescriptiveName in class HtmlProxy

Returns:

A descriptive object name.

getUniqueId

public java.lang.String getUniqueId()

Description copied from class: ProxyTestObject

Returns a string for the associated object. This string must be unique and must be identical for each call to this method for the same instance of the UI object.

Overrides:

getUniqueId in class HtmlProxy

Returns:

A unique and repeatable identifier for the object being evaluated.

getClippingParent

public com.rational.test.ft.object.interfaces.IGraphical getClippingParent()

Description copied from class: HtmlGuiProxy

Get the clipping parent for this object. The clipping parent is the object whose rectangle will clip all of its children, usually the browser or a frame. Unfortunately, it can also be a div tag in the object hierarchy, so going directly to the document does not worl

Overrides:

getClippingParent in class HtmlGuiProxy

getChildAtPoint

public java.lang.Object getChildAtPoint(java.awt.Point pt)

Description copied from class: HtmlGuiProxy

Finds the most interesting child object at the specified point. Note that the point is relative to the top left corner of the screen, and not the component itself or its parent.

If this object has no children, it should return null.

Overrides:

getChildAtPoint in class HtmlGuiProxy

Parameters:

pt - Screen relative point to check.

Returns:

The object at the point or null if no child object is found.

See Also:

HtmlGuiProxy.getScreenRectangle()

getWindow

public TopLevelWindow getWindow()

Specified by:

getWindow in class TopLevelWindowProxy

getPropertyInternal

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

Overrides:

getPropertyInternal in class HtmlProxy

getProperty

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

Description copied from class: HtmlProxy

Get the value for a specific property.

Overrides:

getProperty in class HtmlProxy

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)

isShowing

public boolean isShowing()

Overrides:

isShowing in class TopLevelWindowProxy

getMappableParent

public ProxyTestObject getMappableParent(ContextObject co)

Description copied from class: HtmlProxy

Walks the HtmlProxy.getParent() relationship until a mappable parent is encountered.

Overrides:

getMappableParent in class HtmlProxy

Parameters:

co - The contextProxy Test object is to set the context while finding the children

Returns:

The first mappable parent located.

getMappableParent

public ProxyTestObject getMappableParent()

Description copied from class: HtmlProxy

Walks the HtmlProxy.getParent() relationship until a mappable parent is encountered.

Overrides:

getMappableParent in class HtmlProxy

Returns:

The first mappable parent located.

getParent

public ProxyTestObject getParent(ContextObject co)

Description copied from class: HtmlProxy

Returns null always because object relationships are not understood at this level of abstaction.

Overrides:

getParent in class HtmlProxy

Parameters:

co - The contextProxy Test object is to set the context while finding the children

Returns:

null, no known parent.

getParent

public ProxyTestObject getParent()

Description copied from class: HtmlProxy

Returns null always because object relationships are not understood at this level of abstaction.

Overrides:

getParent in class HtmlProxy

Returns:

null, no known parent.

getStandardProperties

public java.util.Hashtable getStandardProperties()

overriding getstandard properties for js domain, else call super.getproperties

Overrides:

getStandardProperties in class HtmlProxy

Returns:

The set of standard properties associated with a test object.

See Also:

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