Legato
Legato

GoFiler Legato Script Reference

 

Legato v 1.4j

Application v 5.22b

  

 

Chapter FiveGeneral Functions (continued)

AttachApplicationProgress Function

Overview

The AttachApplicationProgress function checks if the application has a progress window open and then borrows the application class for the script.

Syntax/Parameters

Syntax

int = AttachApplicationProgress ( );

Parameters

(none) 

Return Value

Returns an int value as ERROR_NONE or a formatted error code on failure. The sub codes are as follows:

1 — The application does not have a progress class open.

2 — The script already has a program class open.

Remarks

When a script is called as a hook or from another running process, it can be desirable to use the existing program window. The script must comply with the caller’s structure. For example, if the caller has set phases, the script should obey the phase structure. Generally, it is advisable to update the progress and use the second status line.

The term application class is used rather than window since attaching does not require the progress window to be visible, only that the class has been instantiated and setup.

ProgressClose will not close the progress, but rather releases the script’s attachment to the application progress window.

Related Functions

Platform Support

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

Legato IDE, Legato Basic