<doc>
	<legacy_id></legacy_id>
	<name>iphoneClearTouches</name>
	<type>command</type>

	<syntax>
		<example>iphoneClearTouches</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Remove all pending touch interactions from the event queue.</summary>

	<examples>
<example>iphoneClearTouches</example>
	</examples>

	<history>
		<introduced version="4.6">Added</introduced>
		<deprecated version=""></deprecated>
		<removed version=""></removed>
		
	</history>

	<objects>
	</objects>

	<platforms>
		<ios/>
	</platforms>

	<classes>
		<mobile/>
	</classes>

	<security>
	</security>


	<classification>
	</classification>

	<references>
		<message tag="touchStart">touchStart Message</message>
		<message tag="touchEnd">touchEnd Message</message>
		<message tag="touchRelease">touchRelease Message</message>
		<message tag="touchMove">touchMove Message</message>
	</references>

	<description>
	<overview>Use <b>iphoneClearTouches</b> to remove all pending touch interactions from the event queue.</overview>

		<parameters>
		</parameters>

	<value></value>
	<comments>As interaction events (touch and mouse messages) are queued, it is possible for such messages to accumulate when they aren't needed. In particular, when executing 'waits', 'moves' or during card transitions. To handle this case, the <b>iphoneClearTouches</b> command has been added. At the point of calling, all pending touch interactions  are removed from the event queue.<p></p><p><b>iphoneClearTouches</b> also cancels any existing mouse or touch sequences, meaning that you (and the engine) will not receive a mouseUp, mouseRelease, touchEnd or touchCancel message for any current interactions.</p><p></p><p>A good example of when this command might be useful is when playing an instructional sound:</p><p></p><p>on tellUserInstructions</p><p>   play specialFolderPath(&quot;engine&quot;) &amp; slash &amp; &quot;Instruction_1.mp3&quot;</p><p>   wait until the sound is &quot;done&quot;</p><p>   iphoneClearTouches</p><p>end tellUserInstructions</p><p></p><p>Here, if the <b>iphoneClearTouches</b> call was not made, any touch events the user created while the sound was playing would be queued and then be delivered immediately afterwards potentially causing unwanted effects.</p></comments>
	</description>
</doc>