reloadStack

Typemessage
DictionaryLCS
LibraryLiveCode Script
Syntax
reloadStack <pStackName>, <pFileName>
Associationsstack
Summary

Sent to a main stack when the user tries to open a main stack with the same name as a previously-opened stack.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Parameters
NameTypeDescription
pStackName

The short name that belongs to the two conflicting main stacks.

pFileName

The full path to the file that is opening--the file that contains the second main stack with the same name.

Example
on reloadStack theStack,thePath -- bring reloaded window to front
 -- if you're trying to open the same file (for example, double-
  -- clicking the file), bring the already-open stack to the front:
  if the effective filename of stack theStack is thePath
  then go stack theStack
  else beep -- trying to open a same-named stack in different file
end reloadStack
RelatedProperty: destroyStack, name
Object: stack
Function: mainStacks
Glossary: property, pass, message, main stack, trap
Description

Handle the reloadStack message when you want to prevent a stack from being reopened, or moderate conflicts between the names of main stacks, or prevent two main stacks with the same name from being open at one time.

The opening of the stack is triggered by the reloadStack message. This means that trapping the reloadStack message and not passing it prevents the second stack from being opened.

If a main stack's destroyStack property is set to false, the stack remains in memory--and can cause a reloadStack message to be sent--even after its window is closed.

Tagsobjects