<doc>
        <legacy_id>2225</legacy_id>
        <name>newTool</name>
        <type>message</type>

        <syntax>
                <example>newTool <i>toolName</i></example>
        </syntax>

        <synonyms>
        </synonyms>

        <summary>Sent to the caller of <command tag="choose">choose</command> when a different <function tag="tool">tool</function> is chosen. </summary>

        <examples>
                <example>on newTool newTool</p><p>  if newTool is &quot;Browse&quot; then show stack &quot;Editing Tools&quot;</p><p>  else hide stack &quot;Editing Tools&quot;</p><p>end newTool</example>
        </examples>

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

        <objects>
                <card/>
        </objects>

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

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

        <security>
        </security>


        <classification>
                <category>Developing with LiveCode</category>
        </classification>

        <references>
                <command tag="choose">choose Command</command>
        </references>

        <description>
        <overview>Sent when the choose command is used to change the current tool.</overview>

        <parameters>
        	<parameter>The <i>toolName</i> is the name of the tool that has just been chosen.</parameter>
        </parameters>

        <value></value>
        <comments>The <b>newTool</b> message is sent to the object owning the script that executed the <command tag="choose">choose</command> command.</p><p></p><p><tip>To detect when the user changes tool using the Tools palette in the IDE, handle the message in a frontscript.</tip></p></comments>
        </description>
</doc>