topLevel

Opens a stack in an editable window.

# Metadata

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

# Syntax

topLevel stack

# Params

- stack : Any stack reference.

# Examples

toplevel stack "project1"

toplevel this stack

topLevel the mousestack

# Description

Use the topLevel command to display a stack in an editable window.

An editable window can be resized (if its resizable property is true), and its controls can be selected, moved, and changed. To edit a stack of a different style (a palette, modeless, or modal dialog box), use the topLevel command to display it in an editable window.

The topLevel command closes the stack and reopens it as an editable window, so closeStack and openStack, closeCard and openCard, and (if applicable) closeBackground and openBackground messages are sent to the current card as a result of execute this command. Use the lock messages command before executing topLevel if you want to prevent these messages from being sent.

If the stack is already in an editable window, the topLevel command does not close and reopen it.

# Tags

windowing,

# See

- **property:** cantModify, selected - **message:** openCard, closeStack, closeCard, closeBackground, openStack, openBackground - **command:** palette, lock messages, modeless, choose - **object:** stack - **glossary:** property, current card, execute, message, editable window, command, control, modal dialog box