Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.5b

Application v 5.24b

  

 

Chapter NineDialog Functions (continued)

PageControlGetNavTarget Function

Overview

The PageControlGetNavTarget function retrieves the target associated with the last link clicked on by the user.

Syntax/Parameters

Syntax

string = PageControlGetNavTarget ( int id );

Parameters

id

An int containing the control ID of the page control.

Return Value

A string containing the target or empty on failure. Since it is possible to have an empty string as a value, the last error must be retrieved or tested to differentiate between no data and an error. Use the IsError to test for an error and the GetLastError function to retrieve a formatted error code. Common errors include: ERROR_RANGE if id is an invalid control ID for the open dialog or ERROR_INVALID_HANDLE if no dialog is open.

Remarks

The control is notified when a link is clicked on via the ENX_NAVIGATE message.

The value is derived from the TARGET attribute of the <A> tag.

Related Functions

Platform Support

Go13, Go16, GoFiler Complete, GoFiler Corporate, GoFiler, GoFiler Lite, GoXBRL

Legato IDE, Legato Basic