<doc>
  <legacy_id>1672</legacy_id>
  <name>lockLocation</name>
  <type>property</type>
  <syntax>
    <example>set the lockLocation of <i>object</i> to {true | false}</example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
    <synonym>locked</synonym>
    <synonym>lockLoc</synonym>
  </synonyms>
  <classification>
    <category>Appearance &amp; Positioning</category>
  </classification>
  <references>
    <command tag="revChangeWindowSize">revChangeWindowSize Command</command>
    <property tag="lockCursor">lockCursor Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Specifies whether the user can move a <keyword tag="control">control</keyword>.</summary>
  <examples>
    <example>set the lockLocation of button "Next" to true</example>
    <example>set the lockLocation of group ID 4455 to false</example>
  </examples>
  <description>
    <p>Use the <b>lockLocation</b> <glossary tag="property">property</glossary> to protect a <keyword tag="control">control</keyword> from being moved by the user, or to change the result of setting the <property tag="height">height</property> or <property tag="width">width</property> <glossary tag="property">property</glossary>, or to prevent an <keyword tag="image">image</keyword> or <keyword tag="player">player</keyword> from changing its size to fit the contents.</p><p/><p><b>Value:</b></p><p>The <b>lockLocation</b> of a <keyword tag="control">control</keyword> is true or false.</p><p/><p>By default, the <b>lockLocation</b> property of a newly created <keyword tag="control">control</keyword> is set to false.</p><p/><p><b>Comments:</b></p><p>If the <b>lockLocation</b> <glossary tag="property">property</glossary> of an <glossary tag="object">object</glossary> is false, the user can drag its handles with the <glossary tag="Pointer tool">Pointer tool</glossary> to move or resize the <glossary tag="object">object</glossary>. If the <glossary tag="object">object's</glossary> <b>lockLocation</b> is true, the user cannot move it or resize it.</p><p/><p>If the <b>lockLocation</b> of a <keyword tag="player">player</keyword> or <keyword tag="image">image</keyword> that references an external <keyword tag="file">file</keyword> is false, the <keyword tag="image">image</keyword> or <keyword tag="player">player</keyword> is resized to fit its contents whenever the <keyword tag="card">card</keyword> opens. If the <b>lockLocation</b> is true, the <keyword tag="image">image</keyword> retains whatever size you set, even if it's not the same size as the <glossary tag="object">object's</glossary> contents.</p><p/><p>If the <b>lockLocation</b> of a <command tag="group">group</command> is false, the <command tag="group">group</command> is automatically resized when the <glossary tag="object">objects</glossary> in it are moved, resized, hidden, or shown. If the <b>lockLocation</b> is true, this automatic resizing does not occur, and <glossary tag="object">objects</glossary> that move outside the <glossary tag="group">group's</glossary> boundaries are not shown. If a <command tag="group">group</command> has a <keyword tag="scrollbar">scrollbar</keyword>, set its <b>lockLocation</b> to true to ensure that the <command tag="group">group</command> does not automatically resize to fit its contents.</p><p/><p>If a control's <b>lockLocation</b> <glossary tag="property">property</glossary> is false, when you change its height, it shrinks or grows from the center:  the <glossary tag="control">control's</glossary> top and bottom edges both shift, while its <property tag="location">location</property> <glossary tag="property">property</glossary> stays the same. If the <glossary tag="control">control's</glossary> <b>lockLocation</b> <glossary tag="property">property</glossary> is true, it shrinks or grows from the top left corner: the <glossary tag="control">control's</glossary> top edge stays in the same place, and the bottom edge moves.</p><p/><p><b>Note:</b> Changing a control's <property tag="width">width</property> or <property tag="height">height</property> in the property inspector always preserves its location, regardless of the <property tag="lockLocation">lockLocation</property> setting. </p><p/><p>The setting of the <b>lockLocation</b> <glossary tag="property">property</glossary> does not prevent a <glossary tag="handler">handler</glossary> from moving or resizing an <glossary tag="object">object</glossary>.</p>
  </description>
</doc>