<doc>
	<legacy_id>1213</legacy_id>
	<name>lock screen</name>
	<type>command</type>

	<syntax>
		<example>lock screen [for visual effect] [in rect <i>rect</i>]</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Sets the lockScreen property to true, temporarily preventing the screen from being updated.</summary>

	<examples>
<example><p>lock screen</p><p>   hide image 1</p><p>unlock screen</p></example>
<example><p>lock screen for visual effect</p><p>   show control 1</p><p>unlock screen with visual effect &quot;dissolve&quot;</p></example>
<example><p>lock screen for visual effect in rect (the rect of control 1)</p><p>   show control 1</p><p>   show image 1</p><p>unlock screen with visual effect &quot;dissolve&quot;</p></example>
<example>if the shiftKey is not down then lock screen</example>
	</examples>

	<history>
		<introduced version="1.0">Added.</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		<changed version="5.0">Updated.</changed>
	</history>

	<objects>
	</objects>

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

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

	<security>
	</security>


	<classification>
		<category>Appearance &amp; Positioning</category>
	</classification>

	<references>
		<command tag="lock menus">lock menus Command</command>
		<command tag="lock messages">lock messages Command</command>
		<command tag="lock cursor">lock cursor Command</command>
		<command tag="lock colorMap">lock colorMap Command</command>
		<property tag="allowFieldRedraw">allowFieldRedraw Property</property>
		<property tag="alwaysBuffer">alwaysBuffer Property</property>
	</references>

	<description>
	<overview>Use the <b>lock screen</b> command to rearrange items on the screen or to change locations without the user seeing the transition.</overview>

		<parameters>
  <parameter>
    <name>rect</name>
    <description>(optional) A string containing the rect of the object represented as 4 comma separated values. left, top, right, bottom. (0,0,100,100).</description>
  </parameter>		</parameters>

	<value></value>
	<comments>Use the (optional) 'for visual effect' variant of the <b>lock screen</b> command if you want to subsequently unlock the screen using a visual effect.<p></p><p>Use the (optional) 'rect' parameter of the <b>lock screen</b> command if you want to subsequently unlock the screen using a visual effect in a particular area of the screen.</p><p></p><p>A handler may need to open a stack and then close it before the handler is completed, or to move or change the appearance of a number of objects on the screen. If the screen is locked before these changes occur, the user does not see the changes happen on screen. Locking the screen can prevent user confusion or unsightly screen flashing. It also increases the speed of the handler, since LiveCode does not have to redraw all the intermediate states of the screen.</p><p></p><p>The <b>lock screen</b> command sets the lockScreen property to true. When all pending handlers are finished executing, the lockScreen property is set back to false and the user sees the current state of stack windows on the screen.</p><p></p><p></p><note>When using script debug mode, the screen cannot be locked and the <b>lock screen</b> command has no effect.</note></comments>
	</description>
</doc>