externals

Typeproperty
DictionaryLCS
LibraryLiveCode Script
Syntax
set the externals of <stack> to <filePathsList>
Associationsstack
Summary

Specifies a list of files containing external code that are to be loaded into memory when the stack opens.

Introduced1.0
Changes

Support for using the externals property on OS X systems was added in version 2.0.

OSmac, windows, linux
Platformsdesktop, server
Example
set the externals of stack "Apps" to field "Executables"
Values
NameTypeDescription
Value

The externals of a stack reports a list of file paths, one per line.

RelatedKeyword: file
Property: defaultFolder, imagePixmapID, externalPackages, destroyWindow, externals
Function: deleteResource, files
Glossary: property, external, file path, loaded into memory
Object: stack
Description

Use the externals property to use the externals in the specified files.

Each line of the externals specifies the name and location of a file containing external commands and external functions. If you specify a name but not a location, the file is assumed to be in the defaultFolder.

The files are executed when the stack is opened, making the externals in them available to handlers in the stack.

Important: When you install a new external by setting a stack's externals property, LiveCode cannot use it until you either quit LiveCode and then reopen the stack, or close the stack (after setting its destroyWindow property to true) and then reopen it.