BrowserNativeClick Function

Action

Clicks a DOM element with a specified position and mouse button. A left-button click executes the default actions of the clicked element type.

Include file

BrowserAPI.bdh

Syntax

BrowserNativeClick( uTestObject : in union,
                    nX          : in number optional,
                    nY          : in number optional,
                    nButton     : in number optional,
                    sTimer      : in string optional ): boolean;

Parameter	Description
uTestObject	Either a locator that identifies the DOM element or a handle to a previously found DOM element. Throws an error if an invalid handle is used or if the locator can not be resolved.
nX	Optional: X position relative to the top left corner of the DOM element. Defaults to the middle of the DOM element. If the middle of the DOM element cannot be clicked, which can be the case when another element is placed in front of it, a different position will be used. If no such position can be found, a legacy click function will be used instead.
nY	Optional: Y position relative to the top left corner of the DOM element. Defaults to the middle of the DOM element. If the middle of the DOM element cannot be clicked, which can be the case when another element is placed in front of it, a different position will be used. If no such position can be found, a legacy click function will be used instead.
nButton	Optional: `BUTTON_LEFT` to use the left mouse button (default), `BUTTON_RIGHT` to use the right mouse button. You can combine mouse buttons with modifier keys using an OR operator. Specify `MODIFIER_SHIFT`, `MODIFIER_ALT`, or `MODIFIER_CTRL` for the respective modifier key. For example: `BUTTON LEFT \| MODIFIER_CTRL`
sTimer	Optional: Name of the timer used for page measurements. If this parameter is omitted, no measurements are performed.

Return value

true if successful
false otherwise

Example

benchmark SilkPerformerRecorder

use "Kernel.bdh"
use "BrowserAPI.bdh"

dcluser
  user
    VUser
  transactions
    TInit           : begin;
    TMain           : 1;

var

dclrand

dcltrans
  transaction TInit
  begin
  end TInit;

  transaction TMain
  begin
    BrowserStart(BROWSER_MODE_DEFAULT, 800, 600);
    BrowserNavigate("http://demo.borland.com/TestSite/gwt/Showcase.html#CwBasicButton");
      
    // store the button press action to perform when if the dialog with the given name pops up during replay
    BrowserDlgSetButton("Message from webpage #1", "OK");    
    // click the button to make the dialog pop up
    BrowserNativeClick("//BUTTON[@textContents='Normal Button']", 5, 5, BUTTON_Left);        
    // clear the dialog command storage
    BrowserDlgStop();
  end TMain;