livecode/docs/dictionary/command/insert-script.lcdoc at develop · livecodeali/livecode · GitHub

48 lines (32 loc) · 1.34 KB

Name: insert script

Type: command

Syntax: insert [the] script of <object> into {front | back}

Summary:

Places an <object|object's> <script> into the <message path>.

Introduced: 1.0

OS: mac, windows, linux, ios, android

Platforms: desktop, server, mobile

Example:

insert the script of button "Message Library" into back

Example:

insert the script of this card into front

Parameters:

object:

The object is any object in an open stack.

Description:

Use the insert script command to use an object's script as a library for

frequently-used handlers.

A script inserted into the front receives messages first, before the

target object receives them. A script inserted into the back receives

messages after all objects in the message path, just before the engine

itself receives the message.

Objects added to the front or back are placed at the start of the

<frontScripts> or <backScripts> list: the last-inserted object gets

messages first.

Be aware that inserting scripts may make it difficult to understand how

a stack behaves. If you use this command for development, be sure to

carefully document which scripts are inserted, where, and when.

References: remove script (command), place (command), call (command),

start using (command), backScripts (function), frontScripts (function),

object (glossary), message path (glossary), script (property)

Tags: objects

Expand file tree