com.rational.test.ft.domain.html

Class HtmlDialogProxy

java.lang.Object

com.rational.test.ft.sys.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:

com.rational.test.ft.domain.IChannelObject, com.rational.test.ft.domain.IDataDriven, com.rational.test.ft.domain.IGetInterestingRecogProsForDynFind, com.rational.test.ft.domain.IHtmlCustomDomainEnablement, com.rational.test.ft.domain.IInternalObjectStatus, com.rational.test.ft.domain.IProxyBase, com.rational.test.ft.domain.IQuickFind, com.rational.test.ft.domain.IXPathFind, com.rational.test.ft.object.interfaces.IFrame, com.rational.test.ft.object.interfaces.IGraphical, com.rational.test.ft.object.interfaces.ITopWindow

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 com.rational.test.ft.util.FtDebug	debug

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

currentMethod, GETSCREENSNAPSHOT, IS_WEB_PLAYER, LEFT, MAXIMIZE, OFFSETHEIGHTPROPERTY, OFFSETLEFTPROPERTY, OFFSETRECTPROPERTY, OFFSETTOPPROPERTY, OFFSETWIDTHPROPERTY, ONCHANGE, ONMOUSEOVER, RESTORE, TEXT

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, OUTERTEXT, 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 class com.rational.test.ft.sys.RegisteredObject

theTestObject

Fields inherited from interface com.rational.test.ft.object.interfaces.ITopWindow

INPUTCHARS_METHOD, INPUTKEYS_METHOD

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, com.rational.test.ft.domain.IChannel channel, long handle)
HtmlDialogProxy(HtmlTestDomainImplementation domain, com.rational.test.ft.domain.IChannel channel, long handle, com.rational.test.ft.domain.html.chrome.IBrowserCommunicator jswrap)
HtmlDialogProxy(HtmlTestDomainImplementation domain, com.rational.test.ft.domain.IChannel channel, com.rational.test.ft.sys.graphical.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.
com.rational.test.ft.domain.ProxyTestObject	getMappableParent() Walks the HtmlProxy.getParent() relationship until a mappable parent is encountered.
com.rational.test.ft.domain.ProxyTestObject	getMappableParent(com.rational.test.ft.sys.ContextObject co) Walks the HtmlProxy.getParent() relationship until a mappable parent is encountered.
com.rational.test.ft.domain.ProxyTestObject	getParent() Returns null always because object relationships are not understood at this level of abstaction.
com.rational.test.ft.domain.ProxyTestObject	getParent(com.rational.test.ft.sys.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()
com.rational.test.ft.sys.graphical.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, switchTo

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

activateTopWindow, click, click, click, click, clickAtScreenPoint, clickWithMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouse, clickWithOutMouseN, convertFromScreenToOffset, doScroll, doubleClick, 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, getScreenSnapshot, 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, exists, fetchProperties, filterProxiesBasedOnProps, find, findElementsByXpath, findElementsDirectly, findElementsViaQuery, findElementWithDynamicFind, findElementWithName, getAddedRecognitionProperty, getAddedRecognitionPropertyValue, getAddedRecognitionPropertyWeight, getBrowserAppVersion, getBrowserProcessId, 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, 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, getParent, 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 com.rational.test.ft.sys.RegisteredObject

addProxyReference, dereference, getRegisteredId, getTransactionId, isReferenced, register, registerTransiently, toString, unregister

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.rational.test.ft.object.interfaces.IGraphical

click, click, click, click, doubleClick, doubleClick, doubleClick, doubleClick, drag, drag, drag, drag, dragToScreenPoint, dragToScreenPoint, dragToScreenPoint, getClippedScreenRectangle, getScreenPoint, getScreenPoint, getScreenRectangle, hasFocus, hover, hover, hover, hover, isEnabled, isOpaque, isPointInObject, mouseMove, mouseMove, nClick, nClickDrag, nClickDragToScreenPoint

Field Detail

debug

protected static com.rational.test.ft.util.FtDebug debug

Constructor Detail

HtmlDialogProxy

public HtmlDialogProxy(HtmlTestDomainImplementation domain,
               com.rational.test.ft.domain.IChannel channel,
               long handle)

HtmlDialogProxy

public HtmlDialogProxy(HtmlTestDomainImplementation domain,
               com.rational.test.ft.domain.IChannel channel,
               long handle,
               com.rational.test.ft.domain.html.chrome.IBrowserCommunicator jswrap)

HtmlDialogProxy

public HtmlDialogProxy(HtmlTestDomainImplementation domain,
               com.rational.test.ft.domain.IChannel channel,
               com.rational.test.ft.sys.graphical.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 com.rational.test.ft.domain.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()

Overrides:

getUniqueId in class HtmlProxy

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.

Specified by:

getChildAtPoint in interface com.rational.test.ft.object.interfaces.IGraphical

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 com.rational.test.ft.sys.graphical.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

isShowing

public boolean isShowing()

Specified by:

isShowing in interface com.rational.test.ft.object.interfaces.IGraphical

Overrides:

isShowing in class TopLevelWindowProxy

getMappableParent

public com.rational.test.ft.domain.ProxyTestObject getMappableParent(com.rational.test.ft.sys.ContextObject co)

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.

getMappableParent

public com.rational.test.ft.domain.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 com.rational.test.ft.domain.ProxyTestObject getParent(com.rational.test.ft.sys.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

Returns:

null, no known parent.

getParent

public com.rational.test.ft.domain.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