BrowserStore Function

Action

This function can be used to store a handle for reuse. A handle can be obtained by the BrowserFind function. The HANDLE_STORED constant refers to the last handle stored. Alternatively, you can store the handle by passing true to the BrowserFind function for the store parameter.

Include file

BrowserAPI.bdh

Syntax

BrowserStore( nHandle : in number );

Parameter	Description
nHandle	The handle that should be stored.

Return value

none

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
  var
    liHandle : number;
    liText : string;
  begin
    BrowserStart(BROWSER_MODE_DEFAULT, 800, 600);
    BrowserNavigate("http://demo.borland.com");
    
    // find the first list item (LI) tag on this page and store it into a variable (liHandle)
    liHandle := BrowserFind(HANDLE_DESKTOP, "//LI");    
    // store the handle into the internal handle variable (HANDLE_STORED)
    BrowserStore(liHandle);
    // get the text of the list item and print it
    BrowserGetText(liHandle, liText);
    print(liText);    
    //get the text of item represented by the internally stored handle and print it
    BrowserGetText(HANDLE_STORED, liText);
    print(liText);
  end TMain;