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 Free Downloads link in the menu on the left:

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

UsePage("WinTask - Automation software and Task Scheduler. Macro software with Macro Recorder")

CopyLink("A[INNERTEXT= 'Free Downloads']",link$)

msgbox(link$)

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