<doc>

<legacy_id>1075</legacy_id>

<name>hotspotClicked</name>

<type>message</type>

<syntax>

<example>hotspotClicked <i>hotspotID</i></example>

</syntax>

<library></library>

<objects>

<player/>

</objects>

<synonyms>

</synonyms>

<classification>

<category>User Interaction</category>

<category>Images &amp; Multimedia</category>

</classification>

<references>

<property tag="hotspots">hotspots Property</property>

<message tag="nodeChanged">nodeChanged Message</message>

<message tag="QTDebugStr">QTDebugStr Message</message>

</references>

<history>

<introduced version="1.0">Added.</introduced>

</history>

<platforms>

<mac/>

<windows/>

</platforms>

<classes>

<desktop/>

<server/>

<web/>

</classes>

<security>

</security>

<summary>Sent to a player containing a <glossary tag="QuickTime VR">QuickTime VR</glossary> movie when the user clicks one of the movie's hot spots.</summary>

<examples>

<example>on hotSpotClicked theNode <code><i>-- show a text description</i></code></p><p> if theNode is among the lines of the clickableNodes of me then</p><p> put line theNode of field "Tips" into field "Display"</p><p> end if</p><p>end hotspotClicked</example>

</examples>

<description>

<p>Handle the <b>hotspotClicked</b> <keyword tag="message box">message</keyword> if you want to perform some additional action when the user clicks a hot spot in a <glossary tag="QuickTime VR">QuickTime VR</glossary> movie.</p><p/><p><b>Parameters:</b></p><p>The <i>hotspotID</i> is the ID of the <glossary tag="QuickTime VR">QuickTime VR</glossary> hot spot that was clicked.</p><p/><p><b>Comments:</b></p><p>Each hot spot of a QuickTime VR movie is a clickable link, usually from one node to another. The movie author sets the hot spots during development of the movie. The user clicks a hot spot in the player to activate the link.</p><p/><p>If the user navigates to another node by clicking a hot spot in the QuickTime VR movie, a <b>nodeChanged</b> <keyword tag="message box">message</keyword> is sent after the <b>hotspotClicked</b> <keyword tag="message box">message</keyword>.</p>

</description>

</doc>