CopyLink

Web function.

The CopyLink function returns the link associated at the specified html element. Not available in WinTask Lite.

Usage

It's the same usage as a right click on a link and then in the context menu, the selection of Copy shortcut option.

Syntax

ret=CopyLink(<html_descriptor> ,result$)

Parameters

<html_descriptor>, unique identifier for the HTML element to look for its link.

result$, string, returns the link.

Return value

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

List of negative error codes

-1

No browser in use (no previous UsePage or StartBrowser)

-3

Bad descriptor, invalid syntax

-4

The browser has been lost (for instance because of a Closewindow)

-5

Page not found

-8

Specified element not found

-11

Any other error

-404,405

Usual http error codes (requires IE 6 or above)

Remarks

CopyLink function returns the actual link which is behind a clickable link. It simulates a right click on the specified html element, and in the context menu takes the option Copy shortcut.

Example

On WinTask Web site, we click the Download your 30-day trial now! link below the product picture:

StartBrowser("IE","www.wintask.com")

UsePage("Macro and Data Extraction with WinTask - the automation software for Windows and internet")

CopyLink("A[INNERTEXT= 'DOWNLOAD your 30-day']",link$)

msgbox(link$)

'link$ contains http://www.wintask.com/download-wintask.php
CloseBrowser()