reloadStack

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

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

reloadStack pStackName, pFileName

# Params

- 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.

# Examples

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

# 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 trap the reloadStack message and not pass 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.

# Tags

objects,

# See

- **property:** destroyStack, name - **object:** stack - **function:** mainStacks - **glossary:** property, pass, message, main stack, trap