<doc>
	<legacy_id></legacy_id>
	<name>touchMove</name>
	<type>message</type>

	<syntax>
		<example>touchMove <i>touchID</i>, <i>touchX</i>, <i>touchY</i></example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Sent when the point at which the user is touching the screen changes.</summary>

	<examples>
<example><p>on touchMove pTouchID, pX, pY</p><p>   if pX &gt; lastX then</p><p>     -- user has moved to the right</p><p>   end if</p><p>end touchMove</p></example>
	</examples>

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

	<objects>
	</objects>

	<platforms>
		<ios/>
		<android/>
	</platforms>

	<classes>
		<desktop/>
	</classes>

	<security>
	</security>


	<classification>
		<category>User Interaction</category>
	</classification>

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

	<description>
	<overview>Handle the <b>touchMove</b> message if you want to perform some action when the user changes the touch position without ending the touch or if you want to keep continuous track of the touch position.</overview>

		<parameters>
		<parameter>The <i>touchID</i> is a number which uniquely identifies a sequence of touch messages corresponding to an individual, physical touch action. This is the same id as the touchStart message which started the sequence.</parameter>
		<parameter>The <i>touchX</i> is the horizontal coordinate of the touchPosition</parameter>
		<parameter>The <i>touchY</i> is the vertical coordinate of the touchPostition</parameter>
		</parameters>

	<value></value>
	<comments>The <b>touchMove</b> message is sent to the control which recived the <message tag="touchStart">touchStart</message> message to begin the touch sequence.<p></p><p>The <i>touchID</i> parameter is a number which uniquely identifies a sequence of touch messages corresponding to an individual, physical touch action. All such sequences start with a <message tag="touchStart">touchStart </message>message, have one or more <b>touchMove</b> messages and finish with either a <message tag="touchEnd">touchEnd</message> or a <message tag="touchRelease">touchRelease</message> message.</p><p></p><p>No two touch sequences will have the same id, and it is possible to have multiple (interleaving) such sequences occurring at once. This allows handling of more than one physical touch at once and, for example, allows you to track two fingers moving on the iPhone's screen.</p><p></p><p>The sequence of touch messages is tied to the control in which the touch started, in much the same way mouse messages are tied to the object a mouse down starts in. The test used to determine what object a touch starts in is identical to that used to determine whether the pointer is inside a control. In particular, invisible and disabled controls will not considered viable candidates.</p></comments>
	</description>
</doc>