newBackground

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

# Metadata

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

# Syntax

newBackground

# Description

Handle the newBackground message if you want to create objects or do other tasks when a new group is created.

Normally, the newBackground message is handled at a higher level of the message path, since the newly created group does not yet have a script unless the templateGroup contains one.

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

A newGroup message is sent before the newBackground message. (The newBackground message is included for compatibility with HyperCard.)

# Tags

objects,

# See

- **keyword:** templateGroup - **property:** script - **message:** openBackground, newGroup, newCard - **command:** copy, group - **glossary:** object, trap, message, HyperCard, message path - **control structure:** pass