com.rational.test.ft.domain.html.dojo

Class DojoTextBoxProxy

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.generichtmlsubdomain.GenericHtmlGuiProxy

com.rational.test.ft.domain.html.generichtmlsubdomain.GenericTextareaProxy

com.rational.test.ft.domain.html.dojo.DojoTextareaProxy

com.rational.test.ft.domain.html.dojo.DojoTextBoxProxy

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

public class DojoTextBoxProxy
extends DojoTextareaProxy

Implements the Proxy for Html TEXTBOX elements

• TestObject Interface: GuiTestObject
  
  
• Supported Test Data Types:
  

  Type	Desciption
  text	Visible Text	ITestDataText

  
  
• Default Recognition Properties:
  • .class
  • .classIndex
  • .id
  • .name
  • .title
  
  
• Supported Canonical Properties:
  

  Property	Usage
  .bounds	A rectangle representing the bounding rectangle of the object in screen coordinates.
  .class	This is the test object class name, for example "HtmlTable" for a <Table> element.
  .className	This the value of the class attribute of an element
  .defaultValue	This is the value of the defaultValue attribute of the element.
  .disabled	The value of the disabled attribute of an element, returned as a boolean. If true then user input is currently disabled for this item.
  .hasScript	This value is returned as a boolean. If true then script as been associated with actions on this element.
  .id	This is the value of the id attribute of an element.
  .name	This is the value of the name attribute (Form elements and Frames only)
  .offsetHeight	The height of the element.
  .offsetLeft	The offset of the element from its offset parent in the DOM.
  .offsetTop	The offset of the element from its offset parent in the DOM.
  .offsetWidth	The width of the element.
  .rows	The value of the rows attribute of a TEXTAREA element, indicating the size of the edit control in number of rows of text.
  .screenLeft	Upper left corner of bounding rectangle in screen coordinates, x component.
  .screenTop	Upper left corner of bounding rectangle in screen coordinates, y component.
  .tag	This is the Html tag for the element
  .text	This is the text inside of the HTML tags for bounding the element. For example, <A>This is an Anchor<IMG src=map.gif></a> the text property will return "This is an Anchor. All white space are combined and reduced to a single a blank character if consecutive white space characters are found.
  .title	This is the value of the title attribute of an element. This is frequently the text displayed when hovering over the element with the mouse.
  .value	This is the value of the value attribute of an element. In Form elements this represents the value which will be sent when the form is posted.

  
  

Since:

RFT1.0

Nested Class Summary

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 inherited from class com.rational.test.ft.domain.html.generichtmlsubdomain.GenericTextareaProxy

debug

Fields inherited from class com.rational.test.ft.domain.html.generichtmlsubdomain.GenericHtmlGuiProxy

defaultRecognitionProperty, DISPLAYPROPERTY, subDomain

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

COLON, COMMA, currentMethod, ESC_DBLQUOTE, GETSCREENSNAPSHOT, IS_WEB_PLAYER, JSON_CLOSE_BRACE, JSON_OPEN_BRACE, 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.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
DojoTextBoxProxy(HtmlTestDomainImplementation domain, com.rational.test.ft.domain.IChannel channel, long handle)
DojoTextBoxProxy(HtmlTestDomainImplementation domain, com.rational.test.ft.domain.IChannel channel, long handle, com.rational.test.ft.domain.html.chrome.IBrowserCommunicator jswrap)

Method Summary

Methods

Modifier and Type	Method and Description
com.rational.test.ft.domain.ProxyTestObject[]	getChildren() Uses getChildrenEnumeration to implement.
static long	getControlHandle(HtmlProxy proxy)
static HtmlProxy	getCustomProxy(HtmlProxy defaultProxy, HtmlTestDomainImplementation domain, com.rational.test.ft.domain.IChannel channel, com.rational.test.ft.domain.html.chrome.IBrowserCommunicator jswrap)
com.rational.test.ft.sys.MethodSpecification	getDataDrivableCommand() This method must be implemented by any proxy that wishes to support data driving.
java.lang.String	getDescriptiveName() Returns a name that can be used to describe the associated UI object in a script.
boolean	getDisabledProperty() Check if the control is disabled.
com.rational.test.ft.domain.ProxyTestObject[]	getMappableChildren() Uses getChildrenEnumeration to implement.
java.lang.String	getObjectClassName()
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.vp.ITestData	getTestData(java.lang.String testDataType) This method constructs the specified verification data object.
java.lang.String	getText() Allow direct acess to the text property on the control.
boolean	isEditable() Check if the text component is editable.
boolean	isEnabled() This method returns if user input is currently enabled for the element
static boolean	isOfMyType(HtmlProxy proxy)
void	setText(java.lang.String text) Directly modify the text on the control.

Methods inherited from class com.rational.test.ft.domain.html.dojo.DojoTextareaProxy

getSubmitData, getTextProperty

Methods inherited from class com.rational.test.ft.domain.html.generichtmlsubdomain.GenericTextareaProxy

getRole, getTestObjectClassName, updateTestData

Methods inherited from class com.rational.test.ft.domain.html.generichtmlsubdomain.GenericHtmlGuiProxy

calculateParentsTextDescendantsMayBecomeInteresting, getAncestorAtLevel, getAncestorHandleMatchingByPropertyNames, getAncestorHandleMatchingProperty, getAncestorHandleMatchingProperty, getAncestorHandleMatchingProperty, getAncestorHandleMatchingProperty, getHtmlChildren, getHtmlParent, getObjectCustomClassName, getSubDomain, getVisibleTextProperty, isVisible, setClickArgs, setDownPointArgs, setMethodSpecification, setMethodSpecification, setSubDomain, shouldBeMapped

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, getChildAtPoint, getChildAtPointN, getChildrenHandlesMatchingProperty, getClippedScreenRectangle, getClippingParent, 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, isInView, isInView, isOpaque, isPointInObject, isPointInObject, isShowing, mouseMove, mouseMove, nClick, nClick, nClickAtScreenPoint, nClickDrag, nClickDragAtScreenPoint, nClickDragToScreenPoint, performAction, performClick, performClick, performDoubleClick, performSelect, performSetText, performWindowAction, processHoverMouseEvent, processMouseEvent, 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, 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, getChildrenEnumeration, getChildrenEnumeration, getChildrenHandleEnumeration, getChildrenHandles, getChildrenN, getChildrenWithTagType, getClassIndex, getCustomClassProperty, getCustomClassPropertyValue, getCustomDomainName, getCustomDomainName, getCustomDomainName, getCustomDomainNameForChildren, getCustomDomainNameForParent, getCustomObject, 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, getMappableElementsByNameInProxyTestObjects, getMappableElementsByTagInProxyTestObjects, getMappableParent, getMappableParent, getMethods, getNonValueProperties, getObject, getOwnedObjects, getOwnedObjects, getOwner, getParent, getParent, getParent, getParentN, getProperties, getProperties, getProperty, getPropertyInternalRunnable, getPropertyN, getProxyTestObjectsFromEnumeration, getReadOnlyProperty, getRecognitionProperties, getRecognitionPropertyWeight, getSavedDescriptiveName, getScriptCommandFlags, getStandardProperties, getStandardProperties, getTestDataTypes, getTestDomain, getTopMappableParent, getTopParent, getTopParent, getTopParentInternal, getTopParentN, getUniqueId, 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

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

baseClassMatch, canTakeVP, findChildrenWithProperties, findChildrenWithPropertiesAndInvoke, getDataDrivableCommands, getElementWithFocus, getField, 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

Constructor Detail

DojoTextBoxProxy

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

DojoTextBoxProxy

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

Method Detail

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.

getCustomProxy

public static HtmlProxy getCustomProxy(HtmlProxy defaultProxy,
                       HtmlTestDomainImplementation domain,
                       com.rational.test.ft.domain.IChannel channel,
                       com.rational.test.ft.domain.html.chrome.IBrowserCommunicator jswrap)

getControlHandle

public static long getControlHandle(HtmlProxy proxy)

isOfMyType

public static boolean isOfMyType(HtmlProxy proxy)

getObjectClassName

public java.lang.String getObjectClassName()

Overrides:

getObjectClassName 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 GenericHtmlGuiProxy

getPropertyInternal

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

Overrides:

getPropertyInternal in class DojoTextareaProxy

getTestData

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

Description copied from class: HtmlProxy

This method constructs the specified verification data object. The testDataType parameter is one of the hashtable keys returned by getTestDataTypes.

Overrides:

getTestData in class GenericTextareaProxy

Parameters:

testDataType - A test data type supplied by getTestDataTypes.

Returns:

The verification data for the supplied type.

See Also:

HtmlProxy.getTestDataTypes(), ITestData

setText

public void setText(java.lang.String text)

Directly modify the text on the control. Any existing text in the control is replaced with the specified text value. This command will attempt to playback this action from the glass when possible.

Overrides:

setText in class GenericTextareaProxy

Parameters:

text - The text to update the control with.

Since:

RFT2.0

getText

public java.lang.String getText()

Description copied from class: GenericTextareaProxy

Allow direct acess to the text property on the control.

Overrides:

getText in class GenericTextareaProxy

Returns:

The active text in the control.

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.

getMappableChildren

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

Description copied from class: HtmlProxy

Uses getChildrenEnumeration to implement.

Overrides:

getMappableChildren in class HtmlProxy

Returns:

null, if no known children.

getDisabledProperty

public boolean getDisabledProperty()

Description copied from class: HtmlProxy

Check if the control is disabled. If unable to tell if a control is disabled then a false value is returned (the control is assumed to be enabled).

Overrides:

getDisabledProperty in class DojoTextareaProxy

Returns:

true is returned if the control is disabled.

isEnabled

public boolean isEnabled()

This method returns if user input is currently enabled for the element

Specified by:

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

Overrides:

isEnabled in class DojoTextareaProxy

Returns:

Boolean: if true, input is enabled

isEditable

public boolean isEditable()

Check if the text component is editable.

Overrides:

isEditable in class DojoTextareaProxy

Returns:

true is returned if the text component is editable.

Since:

RFT8.2.2

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

Overrides:

getDataDrivableCommand in class GenericTextareaProxy

Since:

RFT8.2.2

See Also:

ProxyTestObject.getDataDrivableCommands(int)