<doc>
	<legacy_id>1053</legacy_id>
	<name>lock messages</name>
	<type>command</type>

	<syntax>
		<example>lock messages</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Sets the <property tag="lockMessages">lockMessages</property> <glossary tag="property">property</glossary> to true, preventing <glossary tag="setProp trigger">setProp triggers</glossary>, <glossary tag="getProp call">getProp calls</glossary>, and certain <glossary tag="message">messages</glossary> from being sent.</summary>

	<examples>
<example>lock messages</example>
<example>if the commandKey is down then lock messages</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
		<experimental version=""></experimental>
		<nonexperimental version=""></nonexperimental>
	</history>

	<objects>
	</objects>

	<platforms>
		<mac/>
		<windows/>
		<linux/>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
		<server/>
		<web/>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
		<category>Objects &amp; Messages</category>
	</classification>

	<references>
		<command tag="lock moves">lock moves Command</command>
		<command tag="lock error dialogs">lock error dialogs Command</command>
		<command tag="lock recent">lock recent Command</command>
		<command tag="lock screen">lock screen Command</command>
		<command tag="unlock messages">unlock messages Command</command>
		<command tag="revCacheGeometry">revCacheGeometry Command</command>
		<command tag="revUpdateGeometry">revUpdateGeometry Command</command>
		<property tag="lockMessages">lockMessages Property</property>
	</references>

	<description>Use the <b>lock messages</b> <glossary tag="command">command</glossary> when a <glossary tag="handler">handler</glossary> performs an action (such as opening a <object tag="stack">stack</object>) and you want to speed up access by preventing unnecessary navigation messages (such as <message tag="openStack">openStack</message>) from being sent.<p></p><p><b>Comments:</b></p><p>The <b>lock messages</b> <glossary tag="command">command</glossary> sets the <property tag="lockMessages">lockMessages</property> <glossary tag="property">property</glossary> to true.</p><p></p><p>When all pending handlers are finished executing, the <b>lockMessages</b> <glossary tag="property">property</glossary> is set back to false.</p></description>
</doc>