newCard

Sent to a new card right after it's created.

# Metadata

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

# Syntax

newCard

# Examples

on newCard -- ask the user to name the new card ask "What do you want to call this card?" if the result is "Cancel" then delete the target else set the name of the target to it end newCard

# Description

Handle the newCard message if you want to create additional objects, switch tools, or do other tasks when a new card is created.

Normally, the newCard message is handled at a higher level of the message path, since the newly-created card does not yet have a script unless the templateCard contains one.

The actual creation is not triggered by the newCard message, so trap the message and not allowing it to pass does not prevent the card from being created.

# Tags

objects,

# See

- **keyword:** card, templateCard - **property:** script - **message:** newBackground - **command:** create card, paste, copy, clone - **glossary:** object, trap, message, tool, message path - **control structure:** pass