newCard

Typemessage
DictionaryLCS
LibraryLiveCode Script
Syntax
newCard
Associationscard
Summary

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

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
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
RelatedKeyword: card, templateCard
Property: script
Message: newBackground
Command: create card, paste, copy, clone
Glossary: object, trap, message, tool, message path
Control Structure: pass
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 trapping the message and not allowing it to pass does not prevent the card from being created.

Tagsobjects