com.rational.test.ft.domain.html

Class ComboListboxProxy

  • 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 ComboListboxProxy
extends ElementProxy
    Implements the proxy for HTML ComboListbox elements
    • TestObject Interface: GuiTestObject

    • Supported Test Data Types:
      TypeDesciption
      list Selected List Elements ITestDataList
      selected List Elements ITestDataList

    • Default Recognition Properties:
      • .class
      • .classIndex
      • .id
      • .name
      • .text
      • .title

    • Supported Canonical Properties:
      PropertyUsage
      .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
      .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.
      .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

    • Constructor Detail

      • ComboListboxProxy

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

    • Method Detail

      • getRole

        public java.lang.String getRole()
        Returns TestObjectRole.ROLE_COMBO_LIST_BOX.
        Overrides:
        getRole in class HtmlProxy
        Returns:
        A brief type name that describes the role this object plays in the UI.
        Since:
        RFT1.0

      • 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()

      • 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

      • getVisualTopParent

        public com.rational.test.ft.domain.ProxyTestObject getVisualTopParent()
        Overrides:
        getVisualTopParent in class HtmlProxy

      • processMouseEvent

        public void processMouseEvent(com.rational.test.ft.domain.IMouseActionInfo action)
        Return a MethodSpecification for the specified mouse event. This is the primary record interface for mouse events against a particular control. This implementation calls getActionArgs to generate the appropriate subitem specification. Subclasses which generate subitem specifications should override getActionArgs.
        Overrides:
        processMouseEvent in class HtmlGuiProxy
        Parameters:
        action - The event cache and other mouse state information for this mouse action.
        See Also:
        MethodSpecification, getActionArgs(java.awt.Point)

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

      • getComboListItem

        protected ComboListItemProxy getComboListItem(java.awt.Point point)
        Get a combolist item element (subobject) at the given point.
        Parameters:
        point - point in screen coordinates
        Returns:
        SubobjectProxy - proxy for option element, null if not found.

      • getTestDataTypes

        public java.util.Hashtable getTestDataTypes()
        Description copied from class: HtmlProxy
        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:
        HtmlProxy.getTestData(String), ITestData

      • 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 HtmlProxy
        Parameters:
        testDataType - A test data type supplied by getTestDataTypes.
        Returns:
        The verification data for the supplied type.
        See Also:
        HtmlProxy.getTestDataTypes(), ITestData

      • updateTestData

        public com.rational.test.ft.vp.ITestData updateTestData(java.lang.String testDataType,
                                                        com.rational.test.ft.vp.ITestData testData)
        Description copied from class: HtmlProxy
        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:
        HtmlProxy.getTestDataTypes(), ITestData
Skip navigation links