SelectProxy (HCL OneTest UI)

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.ElementProxy
        
        com.rational.test.ft.domain.html.ControlProxy
        
        com.rational.test.ft.domain.html.SelectProxy

All Implemented Interfaces:: IHtmlGraphicalSubitem, 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, com.rational.test.ft.object.interfaces.IGraphicalSubitem, com.rational.test.ft.object.interfaces.ISelect, com.rational.test.ft.object.interfaces.ISubitem

public class SelectProxy
extends ControlProxy
implements com.rational.test.ft.object.interfaces.ISubitem, com.rational.test.ft.object.interfaces.IGraphicalSubitem, IHtmlGraphicalSubitem, com.rational.test.ft.object.interfaces.ISelect

Implements the proxy for HTML SELECT elements. Select elements in HTML provide the equivalent of Listboxes and ComboListboxes.

TestObject Interface: GuiSubitemTestObject

Supported Test Data Types:

Type	Desciption
list	List Elements	`ITestDataList`
selected	Selected List Elements	`ITestDataList`

Default Recognition Properties:
- .class
- .classIndex
- .id
- .name
- .text
- .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
.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.
.length	The value of the length attribute of an element. For a Select element this indicates the number of items in the list.
.multiple	The value of the multiple attribute of an element. For a Select element (Listbox or combo dropdown) this indicates that the list supports multiple selection, returned as a boolean.
.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.
.selectedIndex	The value of the selectedIndex attribute of an element. For a single selection Select element, this indicates which option element is selected. Integer in the range of >=0.
.screenLeft	Upper left corner of bounding rectangle in screen coordinates, x component.
.screenTop	Upper left corner of bounding rectangle in screen coordinates, y component.
.size	The value of the size attribute of an element. For a Select element this indicates the number of items displayed at once in the list. If size > 1 then the list appears as listbox, otherwise the list appears as a Combodropdown.
.tag	This is the Html tag for the element
.target	The value of the target attribute of an element. For anchors this indicates the name of the target frame, that is, the frame where the document should be opened.
.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.
.type	This is the value of the Type attribute of an element. For example, for an Input element this will be text, password, checkbox, radio, submit, image, reset, button, hidden,orfile.
.type	This is the value of the Type attribute of an element. For example, for an Input element this will be text, password, checkbox, radio, submit, image, reset, button, hidden,orfile.
.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
Modifier and Type Class and Description

protected class SelectProxy.OptionElementEnumeration
An enumerator for option elements.
- 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

Nested Classes
Modifier and Type	Class and Description
`protected class`	`SelectProxy.OptionElementEnumeration` An enumerator for option elements.

Field Summary
- Fields inherited from class com.rational.test.ft.domain.html.ElementProxy
  TESTDATA_SUBMIT
- 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, debug, 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

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

Constructors
Constructor and Description
`SelectProxy(HtmlTestDomainImplementation domain, com.rational.test.ft.domain.IChannel channel, long handle)`

Method Summary

Methods
Modifier and Type	Method and Description
`protected void`	`activateTopWindow()`
`void`	`click(com.rational.test.ft.script.MouseModifiers modifiers)`
`void`	`click(com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem)`
`void`	`click(com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem, java.awt.Point pt)`
`void`	`click(com.rational.test.ft.script.Subitem subitem)`
`void`	`click(com.rational.test.ft.script.Subitem subitem, java.awt.Point pt)`
`void`	`deselectAll()`
`void`	`doubleClick(com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem)`
`void`	`doubleClick(com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem, java.awt.Point pt)`
`void`	`doubleClick(com.rational.test.ft.script.Subitem subitem)`
`void`	`doubleClick(com.rational.test.ft.script.Subitem subitem, java.awt.Point pt)`
`void`	`drag(com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem)`
`void`	`drag(com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem1, java.awt.Point pt1, com.rational.test.ft.script.Subitem subitem2, java.awt.Point pt2)`
`void`	`drag(com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem1, com.rational.test.ft.script.Subitem subitem2)`
`void`	`drag(com.rational.test.ft.script.Subitem subitem)`
`void`	`drag(com.rational.test.ft.script.Subitem subitem1, java.awt.Point pt1, com.rational.test.ft.script.Subitem subitem2, java.awt.Point pt2)`
`void`	`drag(com.rational.test.ft.script.Subitem subitem1, com.rational.test.ft.script.Subitem subitem2)`
`void`	`dragToScreenPoint(com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem, java.awt.Point screenPt)`
`void`	`dragToScreenPoint(com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem, java.awt.Point subitemPt, java.awt.Point screenPt)`
`void`	`dragToScreenPoint(com.rational.test.ft.script.Subitem subitem, java.awt.Point screenPt)`
`void`	`dragToScreenPoint(com.rational.test.ft.script.Subitem subitem, java.awt.Point subitemPt, java.awt.Point screenPt)`
`protected java.util.Vector`	`getActionArgs(java.awt.Point point)` Override of getActionArgs in base class to provide the subitem action data requested inside the base class implementation of processMouseEvent.
`protected java.lang.String[]`	`getAllText(int limit)`
`java.lang.Object`	`getChildAtPoint(java.awt.Point pt)` All children of Select elements are subitems, so this method always returns `null`.
`protected ComboListboxProxy`	`getComboListboxProxy()`
`protected ComboListItemProxy`	`getComboListItem(int index)` If this SELECT element is a ComboListbox, get the associated ComboListItemProxy (subobject) by list index
`com.rational.test.ft.sys.MethodSpecification`	`getDataDrivableCommand()` This method must be implemented by any proxy that wishes to support data driving.
`protected java.lang.String`	`getItemText(int index)` Returns the value at the specified index.
`protected SubobjectProxy`	`getOption(int index)` Get the option element (subobject) at the corresponding index.
`protected SubobjectProxy`	`getOption(java.awt.Point point)` Get an option element (subobject) at the given point.
`int`	`getOptionIndex(OptionProxy option)`
`protected java.lang.String[]`	`getOptionItems()`
`protected java.lang.String[]`	`getOptionItems(int limit)`
`protected java.lang.String[]`	`getOptionItems(com.rational.test.ft.domain.html.SelectProxy.IOptionChoice choice)`
`java.lang.String`	`getRole()` Returns `TestObjectRole.ROLE_HTML`.
`java.awt.Point`	`getScreenPoint(HtmlGuiProxy subObject)` Returns the screen relative point to the center of the supplied subitem.
`java.awt.Point`	`getScreenPoint(HtmlGuiProxy subObject, java.awt.Point pt)` Returns the screen relative point given a subitem and a subitem relative point.
`java.awt.Point`	`getScreenPoint(com.rational.test.ft.script.Subitem subitem)`
`java.awt.Point`	`getScreenPoint(com.rational.test.ft.script.Subitem subitem, java.awt.Point pt)`
`java.awt.Rectangle`	`getScreenRectangle(HtmlGuiProxy subObject)` Returns the rectangle that contains the component being evaluated relative to the top left corner of the screen.
`java.awt.Rectangle`	`getScreenRectangle(com.rational.test.ft.script.Subitem subitem)`
`protected java.lang.String[]`	`getSelectedOptionItems()`
`java.lang.String`	`getSelectedText()` Allows direct access to the selected text property on the control.
`java.lang.Object`	`getSubitem(com.rational.test.ft.script.Subitem subitem)` Returns an object that represents the specified subitem in the associated test object.
`java.lang.String[]`	`getSubmitData()` Return an array of String objects which contains Submit Data for the control.
`HtmlGuiProxy`	`getSubobject(com.rational.test.ft.script.Subitem subitem)` Returns the subobject specified by the subitem
`com.rational.test.ft.vp.ITestData`	`getTestData(java.lang.String testDataType)` This method constructs the specified verification data object.
`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()` The default GUI marshaller is returned.
`void`	`hover(double secondDelay, com.rational.test.ft.script.Subitem subitem)`
`void`	`hover(double secondDelay, com.rational.test.ft.script.Subitem subitem, java.awt.Point pt)`
`void`	`hover(com.rational.test.ft.script.Subitem subitem)`
`void`	`hover(com.rational.test.ft.script.Subitem subitem, java.awt.Point pt)`
`boolean`	`isDropdownList()`
`boolean`	`isDropDownReady()`
`boolean`	`isEnabled()` This method returns if user input is currently enabled for the element
`boolean`	`isFullyInView()`
`boolean`	`isInView()` Is the object in view (not clipped)?
`boolean`	`isMultiSelect()` Does the Select element allow multiple selections?
`void`	`mouseMove(com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem)`
`void`	`mouseMove(com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem, java.awt.Point pt)`
`void`	`mouseMove(com.rational.test.ft.script.Subitem subitem)`
`void`	`mouseMove(com.rational.test.ft.script.Subitem subitem, java.awt.Point subitemPt)`
`void`	`nClick(int clickCount, com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem, java.awt.Point pt)`
`void`	`nClickDrag(int clickCount, com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem1, java.awt.Point pt1, com.rational.test.ft.script.Subitem subitem2, java.awt.Point pt2)`
`void`	`nClickDrag(int clickCount, com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem1, com.rational.test.ft.script.Subitem subitem2)`
`void`	`nClickDragToScreenPoint(int clickCount, com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem, java.awt.Point screenPt)`
`void`	`nClickDragToScreenPoint(int clickCount, com.rational.test.ft.script.MouseModifiers modifiers, com.rational.test.ft.script.Subitem subitem, java.awt.Point subitemPt, java.awt.Point screenPt)`
`boolean`	`performSelect(java.lang.String item)`
`protected void`	`processPreDownMouseEvent(com.rational.test.ft.domain.IMouseActionInfo action)`
`void`	`select(int index)`
`void`	`select(java.lang.String item)`
`void`	`setState(com.rational.test.ft.script.Action action)`
`void`	`setState(com.rational.test.ft.script.Action action, com.rational.test.ft.script.Subitem item)`
`void`	`setState(com.rational.test.ft.script.Action action, com.rational.test.ft.script.Subitem start, com.rational.test.ft.script.Subitem end)`
`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.html.ElementProxy
shouldBeMapped

Methods inherited from class com.rational.test.ft.domain.html.HtmlGuiProxy
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, 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, isOpaque, isPointInObject, isPointInObject, isShowing, mouseMove, mouseMove, nClick, nClick, nClickAtScreenPoint, nClickDrag, nClickDragAtScreenPoint, nClickDragToScreenPoint, performAction, performClick, performClick, performDoubleClick, performSetText, performWindowAction, processHoverMouseEvent, processMouseEvent, 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, getDescriptiveName, 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, getMappableParent, getMappableParent, getMethods, getNonValueProperties, getObject, getObjectClassName, getOwnedObjects, getOwnedObjects, getOwner, getParent, getParent, getParent, getParentN, getProperties, getProperties, getProperty, getProperty, getPropertyInternal, getPropertyInternalRunnable, getPropertyN, getProxyTestObjectsFromEnumeration, getReadOnlyProperty, getRecognitionProperties, getRecognitionPropertyWeight, getSavedDescriptiveName, getScriptCommandFlags, getStandardProperties, getStandardProperties, getTestDomain, getText, 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, 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.ISelect
getText

- Constructor Detail
  - SelectProxy
```
public SelectProxy(HtmlTestDomainImplementation domain,
           com.rational.test.ft.domain.IChannel channel,
           long handle)
```
- Method Detail
  - getTestObjectClassName
```
public java.lang.String getTestObjectClassName()
```
    Description copied from class: HtmlProxy
    
    The default GUI marshaller is returned. More specific marshallers are returned by more constrained proxy classes. This level of support is always required.
    
    Specified by:
    
    getTestObjectClassName in interface com.rational.test.ft.domain.IProxyBase
    
    Overrides:
    
    getTestObjectClassName in class HtmlGuiProxy
    
    Returns:
    The default mashaller class full name.
  - getChildAtPoint
```
public java.lang.Object getChildAtPoint(java.awt.Point pt)
```
    All children of Select elements are subitems, so this method always returns 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()
  - setState
```
public void setState(com.rational.test.ft.script.Action action,
            com.rational.test.ft.script.Subitem item)
```
    Specified by:
    
    setState in interface com.rational.test.ft.object.interfaces.ISubitem
  - setState
```
public void setState(com.rational.test.ft.script.Action action)
```
    Specified by:
    
    setState in interface com.rational.test.ft.object.interfaces.ISubitem
  - 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)
```
    Specified by:
    
    setState in interface com.rational.test.ft.object.interfaces.ISubitem
  - deselectAll
```
public void deselectAll()
```
  - 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 HtmlProxy
    
    Since:
    
    RFT2.0
    
    See Also:
    ProxyTestObject.getDataDrivableCommands(int)
  - getSelectedText
```
public java.lang.String getSelectedText()
```
    Allows direct access to the selected text property on the control.
    
    Specified by:
    
    getSelectedText in interface com.rational.test.ft.object.interfaces.ISelect
    
    Returns:
    The selected text in the control
    Since:
    
    RFT2.0
  - 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.
  - getAllText
```
protected java.lang.String[] getAllText(int limit)
```
  - select
```
public void select(java.lang.String item)
```
    Specified by:
    
    select in interface com.rational.test.ft.object.interfaces.ISelect
  - performSelect
```
public boolean performSelect(java.lang.String item)
```
    Overrides:
    
    performSelect in class HtmlGuiProxy
  - select
```
public void select(int index)
```
    Specified by:
    
    select in interface com.rational.test.ft.object.interfaces.ISelect
  - 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 ControlProxy
    
    Returns:
    Boolean: if true, input is enabled
  - getRole
```
public java.lang.String getRole()
```
    Description copied from class: HtmlProxy
    
    Returns TestObjectRole.ROLE_HTML.
    
    Overrides:
    
    getRole in class HtmlProxy
    
    Returns:
    A brief type name that describes the role this object plays in the UI.
  - isDropdownList
```
public boolean isDropdownList()
```
  - isFullyInView
```
public boolean isFullyInView()
```
  - isInView
```
public boolean isInView()
```
    Description copied from class: HtmlGuiProxy
    
    Is the object in view (not clipped)?
    
    Overrides:
    
    isInView in class HtmlGuiProxy
  - processPreDownMouseEvent
```
protected void processPreDownMouseEvent(com.rational.test.ft.domain.IMouseActionInfo action)
```
    Overrides:
    
    processPreDownMouseEvent in class HtmlGuiProxy
  - getComboListboxProxy
```
protected ComboListboxProxy getComboListboxProxy()
```
  - isDropDownReady
```
public boolean isDropDownReady()
```
  - getScreenRectangle
```
public java.awt.Rectangle getScreenRectangle(com.rational.test.ft.script.Subitem subitem)
```
    Specified by:
    
    getScreenRectangle in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - getScreenPoint
```
public java.awt.Point getScreenPoint(com.rational.test.ft.script.Subitem subitem)
```
    Specified by:
    
    getScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - getScreenPoint
```
public java.awt.Point getScreenPoint(com.rational.test.ft.script.Subitem subitem,
                            java.awt.Point pt)
```
    Specified by:
    
    getScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - 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
    
    Parameters:
    subitem - The subitem to fetch an object for.
    
    Returns:
    An object representation of the subitem.
  - click
```
public void click(com.rational.test.ft.script.MouseModifiers modifiers)
```
    Specified by:
    
    click in interface com.rational.test.ft.object.interfaces.IGraphical
    
    Overrides:
    
    click in class HtmlGuiProxy
  - click
```
public void click(com.rational.test.ft.script.Subitem subitem)
```
    Specified by:
    
    click in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - click
```
public void click(com.rational.test.ft.script.MouseModifiers modifiers,
         com.rational.test.ft.script.Subitem subitem)
```
    Specified by:
    
    click in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - click
```
public void click(com.rational.test.ft.script.Subitem subitem,
         java.awt.Point pt)
```
    Specified by:
    
    click in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - click
```
public void click(com.rational.test.ft.script.MouseModifiers modifiers,
         com.rational.test.ft.script.Subitem subitem,
         java.awt.Point pt)
```
    Specified by:
    
    click in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - doubleClick
```
public void doubleClick(com.rational.test.ft.script.Subitem subitem)
```
    Specified by:
    
    doubleClick in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - doubleClick
```
public void doubleClick(com.rational.test.ft.script.MouseModifiers modifiers,
               com.rational.test.ft.script.Subitem subitem)
```
    Specified by:
    
    doubleClick in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - doubleClick
```
public void doubleClick(com.rational.test.ft.script.Subitem subitem,
               java.awt.Point pt)
```
    Specified by:
    
    doubleClick in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - doubleClick
```
public void doubleClick(com.rational.test.ft.script.MouseModifiers modifiers,
               com.rational.test.ft.script.Subitem subitem,
               java.awt.Point pt)
```
    Specified by:
    
    doubleClick in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - nClick
```
public void nClick(int clickCount,
          com.rational.test.ft.script.MouseModifiers modifiers,
          com.rational.test.ft.script.Subitem subitem,
          java.awt.Point pt)
```
    Specified by:
    
    nClick in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - drag
```
public void drag(com.rational.test.ft.script.Subitem subitem)
```
    Specified by:
    
    drag in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - drag
```
public void drag(com.rational.test.ft.script.MouseModifiers modifiers,
        com.rational.test.ft.script.Subitem subitem)
```
    Specified by:
    
    drag in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - drag
```
public void drag(com.rational.test.ft.script.Subitem subitem1,
        com.rational.test.ft.script.Subitem subitem2)
```
    Specified by:
    
    drag in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - drag
```
public void drag(com.rational.test.ft.script.MouseModifiers modifiers,
        com.rational.test.ft.script.Subitem subitem1,
        com.rational.test.ft.script.Subitem subitem2)
```
    Specified by:
    
    drag in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - drag
```
public void drag(com.rational.test.ft.script.Subitem subitem1,
        java.awt.Point pt1,
        com.rational.test.ft.script.Subitem subitem2,
        java.awt.Point pt2)
```
    Specified by:
    
    drag in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - drag
```
public void drag(com.rational.test.ft.script.MouseModifiers modifiers,
        com.rational.test.ft.script.Subitem subitem1,
        java.awt.Point pt1,
        com.rational.test.ft.script.Subitem subitem2,
        java.awt.Point pt2)
```
    Specified by:
    
    drag in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - nClickDrag
```
public void nClickDrag(int clickCount,
              com.rational.test.ft.script.MouseModifiers modifiers,
              com.rational.test.ft.script.Subitem subitem1,
              com.rational.test.ft.script.Subitem subitem2)
```
    Specified by:
    
    nClickDrag in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - nClickDrag
```
public void nClickDrag(int clickCount,
              com.rational.test.ft.script.MouseModifiers modifiers,
              com.rational.test.ft.script.Subitem subitem1,
              java.awt.Point pt1,
              com.rational.test.ft.script.Subitem subitem2,
              java.awt.Point pt2)
```
    Specified by:
    
    nClickDrag in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - dragToScreenPoint
```
public void dragToScreenPoint(com.rational.test.ft.script.Subitem subitem,
                     java.awt.Point screenPt)
```
    Specified by:
    
    dragToScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - dragToScreenPoint
```
public void dragToScreenPoint(com.rational.test.ft.script.MouseModifiers modifiers,
                     com.rational.test.ft.script.Subitem subitem,
                     java.awt.Point screenPt)
```
    Specified by:
    
    dragToScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - dragToScreenPoint
```
public void dragToScreenPoint(com.rational.test.ft.script.Subitem subitem,
                     java.awt.Point subitemPt,
                     java.awt.Point screenPt)
```
    Specified by:
    
    dragToScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - dragToScreenPoint
```
public void dragToScreenPoint(com.rational.test.ft.script.MouseModifiers modifiers,
                     com.rational.test.ft.script.Subitem subitem,
                     java.awt.Point subitemPt,
                     java.awt.Point screenPt)
```
    Specified by:
    
    dragToScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - nClickDragToScreenPoint
```
public void nClickDragToScreenPoint(int clickCount,
                           com.rational.test.ft.script.MouseModifiers modifiers,
                           com.rational.test.ft.script.Subitem subitem,
                           java.awt.Point screenPt)
```
    Specified by:
    
    nClickDragToScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - nClickDragToScreenPoint
```
public void nClickDragToScreenPoint(int clickCount,
                           com.rational.test.ft.script.MouseModifiers modifiers,
                           com.rational.test.ft.script.Subitem subitem,
                           java.awt.Point subitemPt,
                           java.awt.Point screenPt)
```
    Specified by:
    
    nClickDragToScreenPoint in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - mouseMove
```
public void mouseMove(com.rational.test.ft.script.Subitem subitem)
```
    Specified by:
    
    mouseMove in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - mouseMove
```
public void mouseMove(com.rational.test.ft.script.Subitem subitem,
             java.awt.Point subitemPt)
```
    Specified by:
    
    mouseMove in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - mouseMove
```
public void mouseMove(com.rational.test.ft.script.MouseModifiers modifiers,
             com.rational.test.ft.script.Subitem subitem)
```
    Specified by:
    
    mouseMove in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - mouseMove
```
public void mouseMove(com.rational.test.ft.script.MouseModifiers modifiers,
             com.rational.test.ft.script.Subitem subitem,
             java.awt.Point pt)
```
    Specified by:
    
    mouseMove in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - hover
```
public void hover(double secondDelay,
         com.rational.test.ft.script.Subitem subitem)
```
    Specified by:
    
    hover in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - hover
```
public void hover(double secondDelay,
         com.rational.test.ft.script.Subitem subitem,
         java.awt.Point pt)
```
    Specified by:
    
    hover in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - hover
```
public void hover(com.rational.test.ft.script.Subitem subitem)
```
    Specified by:
    
    hover in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - hover
```
public void hover(com.rational.test.ft.script.Subitem subitem,
         java.awt.Point pt)
```
    Specified by:
    
    hover in interface com.rational.test.ft.object.interfaces.IGraphicalSubitem
  - getSubobject
```
public HtmlGuiProxy getSubobject(com.rational.test.ft.script.Subitem subitem)
```
    Description copied from interface: IHtmlGraphicalSubitem
    
    Returns the subobject specified by the subitem
    
    Specified by:
    
    getSubobject in interface IHtmlGraphicalSubitem
    
    Parameters:
    subitem - The subitem which identifies the subobject to be returned.
  - getScreenRectangle
```
public java.awt.Rectangle getScreenRectangle(HtmlGuiProxy subObject)
```
    Description copied from interface: IHtmlGraphicalSubitem
    
    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 IHtmlGraphicalSubitem
  - getScreenPoint
```
public java.awt.Point getScreenPoint(HtmlGuiProxy subObject)
```
    Description copied from interface: IHtmlGraphicalSubitem
    
    Returns the screen relative point to the center of the supplied subitem.
    
    Specified by:
    
    getScreenPoint in interface IHtmlGraphicalSubitem
  - getScreenPoint
```
public java.awt.Point getScreenPoint(HtmlGuiProxy subObject,
                            java.awt.Point pt)
```
    Description copied from interface: IHtmlGraphicalSubitem
    
    Returns the screen relative point given a subitem and a subitem relative point.
    
    Specified by:
    
    getScreenPoint in interface IHtmlGraphicalSubitem
    
    pt - The subitem relative point.
  - activateTopWindow
```
protected void activateTopWindow()
```
    Overrides:
    
    activateTopWindow in class HtmlGuiProxy
  - getActionArgs
```
protected java.util.Vector getActionArgs(java.awt.Point point)
```
    Override of getActionArgs in base class to provide the subitem action data requested inside the base class implementation of processMouseEvent.
    
    Overrides:
    
    getActionArgs in class HtmlGuiProxy
    
    Parameters:
    point - point in screen coordinates
    
    Returns:
    a vector containing the appropriate subitem arguments.
  - isMultiSelect
```
public boolean isMultiSelect()
```
    Does the Select element allow multiple selections?
    
    Returns:
    true - select has Multiple attribute
  - getComboListItem
```
protected ComboListItemProxy getComboListItem(int index)
```
    If this SELECT element is a ComboListbox, get the associated ComboListItemProxy (subobject) by list index
    
    Parameters:
    index - (0 relative)
    
    Returns:
    ComboListItemProxy - proxy for option element, null if not found.
  - getOption
```
protected SubobjectProxy getOption(java.awt.Point point)
```
    Get an option element (subobject) at the given point.
    
    Parameters:
    point - point in screen coordinates
    
    Returns:
    SubobjectProxy - proxy for option element, null if not found.
  - getOption
```
protected SubobjectProxy getOption(int index)
```
    Get the option element (subobject) at the corresponding index.
    
    Parameters:
    index - (0 relative)
    
    Returns:
    SubobjectProxy - proxy for option element, null if not found.
  - getOptionIndex
```
public int getOptionIndex(OptionProxy option)
```
    Parameters:
    option -
    
    Returns:
  - getSubmitData
```
public java.lang.String[] getSubmitData()
```
    Description copied from class: ControlProxy
    
    Return an array of String objects which contains Submit Data for the control. Submit Data consists of "name=value" pairs (CGI data).
    
    Overrides:
    
    getSubmitData in class ControlProxy
  - getSelectedOptionItems
```
protected java.lang.String[] getSelectedOptionItems()
```
  - getOptionItems
```
protected java.lang.String[] getOptionItems()
```
  - getOptionItems
```
protected java.lang.String[] getOptionItems(int limit)
```
  - getOptionItems
```
protected java.lang.String[] getOptionItems(com.rational.test.ft.domain.html.SelectProxy.IOptionChoice choice)
```
  - 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 HtmlProxy
    
    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 HtmlProxy
    
    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 HtmlProxy
    
    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

Class SelectProxy

Nested Class Summary

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

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

Field Summary

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

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

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

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

Fields inherited from class com.rational.test.ft.sys.RegisteredObject

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

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

Constructor Summary

Method Summary

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

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

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

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

Methods inherited from class com.rational.test.ft.sys.RegisteredObject

Methods inherited from class java.lang.Object

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

Constructor Detail

SelectProxy

Method Detail

getTestObjectClassName

getChildAtPoint

setState

setState

setState

deselectAll

getDataDrivableCommand

getSelectedText

getItemText

getAllText

select

performSelect

select

isEnabled

getRole

isDropdownList

isFullyInView

isInView

processPreDownMouseEvent

getComboListboxProxy

isDropDownReady

getScreenRectangle

getScreenPoint

getScreenPoint

getSubitem

click

click

click

click

click

doubleClick

doubleClick

doubleClick

doubleClick

nClick

drag

drag

drag

drag

drag

drag

nClickDrag

nClickDrag

dragToScreenPoint

dragToScreenPoint

dragToScreenPoint

dragToScreenPoint

nClickDragToScreenPoint

nClickDragToScreenPoint

mouseMove

mouseMove

mouseMove

mouseMove

hover

hover

hover