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 java.lang.String	CANCEL_KEY
protected java.lang.String	cancelText
protected static com.rational.test.ft.util.FtDebug	debug
protected static java.lang.String	OK_KEY
protected java.lang.String	okText

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, MULTIWINDOW_SECOND_WINDOW_CUSTOMIZED, NAMEPROPERTY, OUTERTEXT, parentsTextDescendantsMayBeInteresting, READONLYPROPERTY, TAGPROPERTY, TESTDATA_TEXT, TEXTPROPERTY, TITLEPROPERTY, UNIQUEIDPROPERTY, weightedHtmlPropsForXPath

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

Modifier and Type	Method and Description
com.rational.test.ft.domain.ProxyTestObject[]	findElementsDirectly(boolean mappable)
java.lang.Object	getChildAtPoint(java.awt.Point pt) Finds the most interesting child object at the specified point.
com.rational.test.ft.domain.ProxyTestObject[]	getChildren() Uses getChildrenEnumeration to implement.
java.util.Enumeration	getChildrenEnumeration() Enumerate child objects of the Html Element.
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	getOwner() Returns null always because object relationships are not understood at this level of abstaction.
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)
com.rational.test.ft.script.ScriptCommandFlags	getScriptCommandFlags()
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()
void	inputChars(java.lang.String keysToSend)
void	inputKeys(java.lang.String keysToSend)
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, 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, findElementsMatchingRegex, findElementsViaQuery, findElementWithDynamicFind, findElementWithName, getAddedRecognitionProperty, getAddedRecognitionPropertyValue, getAddedRecognitionPropertyWeight, getBrowserAppVersion, getBrowserProcessId, getCachedData, getChannel, getChildren, getChildren, 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, getMainWindowForProcessId, 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

OK_KEY

protected static final java.lang.String OK_KEY

See Also:

Constant Field Values

CANCEL_KEY

protected static final java.lang.String CANCEL_KEY

See Also:

Constant Field Values

okText

protected java.lang.String okText

cancelText

protected java.lang.String cancelText

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

getChildrenEnumeration

public java.util.Enumeration getChildrenEnumeration()

Description copied from class: HtmlProxy

Enumerate child objects of the Html Element.

Overrides:

getChildrenEnumeration in class HtmlProxy

Returns:

java.util.Enumeration - enumeration of all immediate children in the Html container hierarchly of this element. null if no children.

getChildren

public com.rational.test.ft.domain.ProxyTestObject[] getChildren()

Description copied from class: HtmlProxy

Uses getChildrenEnumeration to implement.

Overrides:

getChildren in class HtmlProxy

Returns:

null, if no known children.

findElementsDirectly

public com.rational.test.ft.domain.ProxyTestObject[] findElementsDirectly(boolean mappable)

Specified by:

findElementsDirectly in interface com.rational.test.ft.domain.IQuickFind

Overrides:

findElementsDirectly in class HtmlProxy

inputChars

public void inputChars(java.lang.String keysToSend)

Specified by:

inputChars in interface com.rational.test.ft.object.interfaces.ITopWindow

Overrides:

inputChars in class TopLevelWindowProxy

inputKeys

public void inputKeys(java.lang.String keysToSend)

Specified by:

inputKeys in interface com.rational.test.ft.object.interfaces.ITopWindow

Overrides:

inputKeys in class TopLevelWindowProxy

getScriptCommandFlags

public com.rational.test.ft.script.ScriptCommandFlags getScriptCommandFlags()

Overrides:

getScriptCommandFlags in class TopLevelWindowProxy

getOwner

public com.rational.test.ft.domain.ProxyTestObject getOwner()

Description copied from class: HtmlProxy

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

Overrides:

getOwner in class TopLevelWindowProxy

Returns:

null, no known parent.