lockMessages

Specifies whether setProp triggers, getProp calls, and certain built-in messages are sent automatically.

# Metadata

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

# Syntax

set the lockMessages to {true | false}

# Examples

set the lockMessages to false

# Description

Use the lockMessages property to prevent unwanted handlers from being trigger, or to speed up operations when handlers that are normally run automatically are not needed.

If the lockMessages property is set to true, the following are not sent:

* Navigation messages (such as openCard, closeStack, and so on) * Object creation messages (such as newCard, newButton, and so on) * getProp calls * setProp triggers

It is useful to set this property if a handler temporarily visits a card and you don't want the normal messages to be triggered.

The lockMessages property is automatically set to false when a palette, modeless, or modal stack is opened, even if a handler is still running.

# Tags

objects, messages,

# See

- **message:** newButton, closeStack - **command:** reset, lock messages, modal, modeless, palette - **object:** stack - **glossary:** message, property, getProp call, built-in message, handler, setProp trigger, trigger, execute