GoFiler Legato Script Reference   Legato v 1.5d Application v 5.25a

Table of Contents	< < Previous	Next >>

 

Chapter Four — Flow Control (continued)

4.13 Executing External Programs

4.13.1 Overview

In many cases it is desirable to run an external program either as a script or as a completely separate application. This can include other scripts or other programs. There are several options:

–  Running a menu function

–  Running another script

–  Running another script in a background thread

–  Running another program within Windows (shell)

–  Running a DLL (Dynamic Link Library)‡

4.13.2 Menu Functions

All menu functions are accessible from a script (the set of menu features varies depending on the host application). The RunMenuFunction allows application menu functions to be run, which in turn can cause other scripts and hooks to be run. Programmers should use caution not to cause loops between scripts and the menu functions which will cause a stack overflow and the host application to terminate.

4.13.3 Scripts

Scripts can be called with the RunScript or the RunBackgroundScript function. The RunScript function will load the specified script (and its associated included files), run the script from the default entry point or a specified function name. The RunBackgroundScript performs the same task but immediately returns with a thread handle. Background threads are covered in the next section, Section 4.14 Control and Background Processes.

[call script]

4.13.4 Shell

Legato allows for access to the Windows Shell via the RunProgram function. A separate windows process is spawned. Any program can be run.

4.14.3 DLLs‡

[DLLs are also known as libraries

[can be in any language

[does not have to be part of the application]

[loss of control]

[traps]

4.13.5 External Program Functions

CreateProcess — Creates a new process and immediately returns with a process handle.

CreateProcessAsElevated — Creates an elevated process and returns with a process handle.

EnumerateScripts — Enumerates all properties for all loaded scripts.

GetProcessExitCode — Retrieves the process return code for a completed process.

RunMenuFunction — Runs the specified menu function as if it is being run from the ribbon or menu. Dialog and message boxes may appear and suspend the script.

RunBackgroundScript — Starts a new thread and runs an external script in a separate script engine.

RunProgram — Runs another executable (exe) as a separate process and immediately returns.

RunProgramElevated — Runs another executable (exe) as a separate elevated process and immediately returns.

RunScript — Runs an external script in a separate script engine in the current process thread.

WaitForObject — Waits for an object with an optional specified time.

 

Table of Contents	< < Previous	Next >>

GoFiler Legato Script Reference — Generated on 12/16/2024

© 2012-2024 Novaworks, LLC. All rights reserved worldwide. Unauthorized use, duplication or transmission prohibited by law. Portions of the software are protected by US Patents 10,095,672, 10,706,221 and 11,210,456. GoFiler™ and Legato™ are trademarks of Novaworks, LLC. EDGAR® is a federally registered trademark of the U.S. Securities and Exchange Commission. Novaworks is not affiliated with or approved by the U.S. Securities and Exchange Commission. All other trademarks are property of their respective owners. Use of the features specified in this language are subject to terms, conditions and limitations of the Software License Agreement.