Name: deleteGroup

Type: message

Syntax: deleteGroup

Summary: Sent to a <group> just before it is removed from the <stack>.

Introduced: 1.0

OS: mac,windows,linux,ios,android

Platforms: desktop,server,web,mobile

Example:

on deleteGroup -- remove the group being deleted from a list

get lineOffset(the short name of the target,field "Groups List")

delete line it of field "Groups List"

pass deleteGroup

end deleteGroup

Description:

Handle the <deleteGroup> message if you want to perform cleanup before a <group> is removed from the <stack>.

The actual deletion is not triggered by the <deleteGroup> <message>, so <trap|trapping> the <message> and not allowing it to <pass> does not prevent the <group> from being removed.

Deleting the last card on which a group appears does not remove the group from the stack, so it does not cause a <deleteGroup> <message> to be sent.

Ungrouping a group does not cause a <deleteGroup> <message> to be sent.

A deleteBackground <message> is sent after the <deleteGroup> <message>.

References: cantDelete (property), delete (command), group (command), stack (object), message (glossary), trap (glossary), pass (control_st)

Tags: objects