newGroup

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

newGroup

# Examples

on newGroup -- automatically set a property of all new groups set the backgroundBehavior of the target to true end newGroup

# Description

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

Normally, the newGroup 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 newGroup message, so trap the message and not allowing it to pass does not prevent the group from being created.

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

# Tags

objects,

# See

- **keyword:** templateGroup - **property:** script - **message:** newBackground - **command:** paste, group, copy, clone - **glossary:** object, trap, message, HyperCard, message path - **control structure:** pass