OverHTMLElement

Web function.

The OverHTMLElement function puts the mouse on a specified html element and opens the options under it.

Usage

On some Websites, menus are displayed dynamically : it's only when you move the mouse on a menu option that the sub-menu is displayed. OverHTMLElement function deals with this case. You can generate automatically the proper OverHTMLElement line in Recording mode by recording a mouse move on the text of the menu option, then press Shift key, then record the next action.

Syntax

ret=OverHTMLElement(<html_descriptor> [,<x>,<y>])

Parameters

<html_descriptor>, unique identifier for the HTML element to move the mouse on within the current Web page specified by the last UsePage. See HTML descriptor for each HTML objects identification. Use Recording mode for generating automatically the OverHTMLElement syntax : in Recording mode, move manually the mouse on the text of the menu option, press once Shift key, and then record the next action.

<x>,<y>, optional, mouse coordinates relative to the element : it can be used for moving the mouse slightly besides the element.

Return value

Ret, numeric return code. If the specified HTML element at replay is found within 30 seconds (this default value can be changed using #ActionTimeout), the function returns 0. Otherwise use this return code for Error Handling.

Example

 

UsePage("Home Page")

OverHTMLElement("DIV[OUTERTEXT= 'Quality']")

OverHTMLElement("DIV[OUTERTEXT= 'Diabetes']")

ClickHTMLElement("DIV[OUTERTEXT= 'Diabetes Management']")

At replay, the first OverHTMLElement moves the mouse to the top menu Quality, which opens the Quality menu. In this menu, there is a Diabetes option which opens a new menu again where it clicks the option Diabetes Management.