Name: deleteButton

Type: message

Syntax: deleteButton

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

Associations: button

Introduced: 1.0

OS: mac,windows,linux,ios,android

Platforms: desktop,server,web,mobile

Example:
on deleteButton -- prevent the deletion by immediately undoing it
  beep
  send "undo" to this card in 5 milliseconds
end deleteButton

Description:
Handle the <deleteButton> message if you want to perform cleanup before a <button> is removed from the <stack>.

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

However, the undo <command> will restore a <button> after it is deleted by the user.

References: button (keyword), delete (command), stack (object), trap (glossary), button (glossary), message (glossary), command (glossary), pass (control_st)

Tags: objects
