<doc>
  <legacy_id>1181</legacy_id>
  <name>nameChanged</name>
  <type>message</type>
  <syntax>
    <example>nameChanged <i>oldName</i>,<i>newName</i></example>
  </syntax>
  <library></library>
  <objects>
    <stack/>
    <card/>
    <group/>
    <field/>
    <button/>
    <graphic/>
    <scrollbar/>
    <player/>
    <image/>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Objects &amp; Messages</category>
  </classification>
  <references>
    <property tag="cardNames">cardNames Property</property>
    <property tag="groupNames">groupNames Property</property>
    <message tag="IDChanged">IDChanged Message</message>
    <property tag="name">name Property</property>
    <property tag="number">number Property</property>
    <property tag="showName">showName 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>Sent to an <glossary tag="object">object</glossary> when its <property tag="name">name</property> is changed.</summary>
  <examples>
    <example>on nameChanged myOldName,myNewName <code><i>-- replace name in a menu button</i></code></p><p>  put lineOffset(myOldName,button "Window List") into namePosition</p><p>  put myNewName into line namePosition of button "Window List"</p><p>end nameChanged</example>
  </examples>
  <description>
    <p>Handle the <b>nameChanged</b> <keyword tag="message box">message</keyword> if you want to make updates when an <glossary tag="object">object's</glossary> <property tag="name">name</property> is changed. For example, if you have a <glossary tag="popup menu">popup menu</glossary> with the names of <function tag="stacks">stacks</function>, the <keyword tag="menu">menu</keyword> should be updated when a <glossary tag="stack">stack's</glossary> name changes.</p><p/><p><b>Parameters:</b></p><p>The <i>oldName</i> is the <glossary tag="object">object's</glossary> original name.</p><p/><p>The <i>newName</i> is the <glossary tag="object">object's</glossary> new name.</p><p/><p><b>Comments:</b></p><p>The actual change is not triggered by the <b>nameChanged</b> <keyword tag="message box">message</keyword>, so <glossary tag="trap">trapping</glossary> the <keyword tag="message box">message</keyword> and not allowing it to <control_st tag="pass">pass</control_st> does not prevent the name from being changed.</p>
  </description>
</doc>