com.rational.test.ft.domain.html

Class HtmlHTMLDialogProxy

  • 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.IBrowserObject, com.rational.test.ft.object.interfaces.IFrame, com.rational.test.ft.object.interfaces.IGraphical, com.rational.test.ft.object.interfaces.ITopWindow


    public class HtmlHTMLDialogProxy
    extends HtmlBrowserProxy
    Provides the proxy for HTML browser objects in the HtmlTestDomainImplementation.
    • TesObject Interface: BrowserTestObject

    • Supported Test Data Types:
      TypeDesciption
      text Visible Text ITestDataText

    • Default Recognition Properties:
      • .class
      • .classIndex
      • .text

    • Supported Canonical Properties:
      PropertyUsage
      .alignThis is the value of the align attribute of the element.  Valid values are bottom, middle, and top.
      .alt The value of the alt attribute an element.  This is the "alternate" text  for the element, frequently displayed by the browser when the mouse hovers over the element.
      .border This is the value of the border attribute of the element. Returns the number of pixels.
      .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.
      .cellIndex The cell index of an element with respect to its row (0>=)
      .checked This is a boolean value indicating whether a checkboxed is currently checked (true) or not (false).
      .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 (used for stylesheets in HTML).
      .clientRect The bounding rectangle of the element in client coordinates.
      .colSpan The value of the colspan attribute of an element.
      .code The value of the code attribute of an APPLET element.
      .codeBase The value of codebase attribute of an APPLET element.
      .cookie This is the current value of the cookie for the document.
      .coords The value of the coords attribute of an element.  This is  string containing the coordinates used to define the AREA of client side image map.  In the form x1, y1, x2,y2, etc.
      .defaultChecked This is a boolean value for the defaultchecked attribute of the element.
      .defaultSelected This is a boolean value that when true indicates that the Option element in a Select element (listbox or dropdown) is selected by default when the page is displayed.
      .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.
      .height The value of the height attribute of an element.  For an Image element this is the display height  in pixels for the image.
      .href The value of the href attribute of an element.  This is a URL used by ANCHOR and AREA elements to indicate the result of clicking on the corresponding element.
      .hspace The value of the hspace attribute of an element, the amount of whitespace inserted to the left or right of an IMG, OBJECT, or APPLET.
      .id This is the value of the id attribute of an element.
      .index This is the index of the  OPTION element within a listbox or combodropdown list. 
      .isMap The value of the isMap attribute of an element returned as a boolean.  For Image elements (IMG) if this is TRUE then this indicates a server side image map.
      .length The value of the length attribute of an element.  For a Select element this indicates the number of items in the list.
      .maxLength For an edit control (Input type=Text or TextArea) this indicates the maximum number of characters a user may enter.
      .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)
      .noHref The value of the nohref attribute of an element.  When set on an AREA element indicates that the corresponding area has no associated action.
      .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.
      .readOnly The value of the readonly attribute of an element.  A boolean value that  when true indicates the form element is read only.
      .readyState This is the current status of a browser, indicating whether it is currently loading  a document or is ready for user input.   This is an integer value:

      0  - Uninitialized

      1 - Loading

      2 - Loaded

      3- Interactive

      4 - Complete (ready)

      .rowIndex The row index of an element in a table (0>= ). 
      .rows The value of the rows attribute of  a TEXTAREA element, indicating the size of the edit control in number of rows of text.
      .rowSpan The value of the rowspan attribute of an element. 
      .select This is boolean value that Indicates whether  the form element is highlighted to receive user input.
      .selected This is a boolean value that indicates whether the Option element in a Select (Listbox or dropdown) is selected.
      .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.
      .shape The value of the shapeattribute of an element. Used for AREA elements in client side image maps.  Valid values are default, rect, circle, and poly
      .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.
      .src This is the value of the src attribute for the element. For images and image buttons this is a URL specifying the desired image file.
      .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.
      .url This is the url of the document.
      .useMap The value of the usemap attribute of an element.  The value is a string specifying a URL and is used for Image elements (IMG) to indicate a client side image map.  The URL points to the map associated MAP.  Frequently, this is a document relative reference.
      .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.
      .vspace The value of the vspace attribute of an element, the amount of whitespace inserted to the above or below of an IMG, OBJECT, or APPLET.
      .width The value of the width attribute of an element.  For an Image element this is the display width in pixels for the image.
      .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
    • Field Detail

      • debug

        protected static com.rational.test.ft.util.FtDebug debug
    • Constructor Detail

      • HtmlHTMLDialogProxy

        public HtmlHTMLDialogProxy(HtmlTestDomainImplementation domain,
                                   com.rational.test.ft.domain.IChannel channel,
                                   long handle)
    • 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 HtmlBrowserProxy
        Returns:
        A descriptive object name.