<doc>
	<legacy_id>2093</legacy_id>
	<name>drag</name>
	<type>command</type>

	<syntax>
		<example>drag [button <i>number</i>] from <i>start</i> to <i>end</i> [with <i>key</i> [,<i>key</i> [<i>key</i>]]]</example>
	</syntax>

	<synonyms>
	</synonyms>

	<summary>Simulates a mouse click and drag.</summary>

	<examples>
<example>drag from "120,89" to "180,2"</example>
<example><font face="courier new" size="17">drag from the clickLoc to the loc of button "Trash"</font></example>
<example><p>drag button 1 from "500,200" to tSavedLoc with shiftKey</p></example>
	</examples>

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

	<objects>
	</objects>

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

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

	<security>
	</security>


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

	<references>
		<command tag="move">move Command</command>
		<command tag="grab">grab Command</command>
		<command tag="choose">choose Command</command>
		<property tag="dontResize">dontResize Property</property>
		<property tag="dragSpeed">dragSpeed Property</property>
		<property tag="dragDelta">dragDelta Property</property>
	</references>

	<description>Use the <b>drag</b> <glossary tag="command">command</glossary> to paint with the <glossary tag="paint tool">paint tools</glossary>.<p></p><p><b>Parameters:</b></p><p>The <i>number</i> is the number of a <glossary tag="mouse button">mouse button</glossary>. If you don't specify a number, button 1 is used.</p><p></p><p>The <i>start</i> is any <glossary tag="expression">expression</glossary> that <glossary tag="evaluate">evaluates</glossary> to a <keyword tag="point">point</keyword>--a vertical and horizontal distance from the top left of the <glossary tag="current stack">current stack</glossary>, separated by a comma.</p><p></p><p>The <i>end</i> is any <glossary tag="expression">expression</glossary> that <glossary tag="evaluate">evaluates</glossary> to a <keyword tag="point">point</keyword>.</p><p></p><p>The <i>key</i> is one of commandKey, controlKey, optionKey, or shiftKey. You can specify up to three keys, separated by commas. (On Windows and <glossary tag="Unix">Unix</glossary>, commandKey indicates the Control key.)</p><p></p><p><b>Comments:</b></p><p>You can use the <b>drag</b> <glossary tag="command">command</glossary> to move a <keyword tag="control">control</keyword>, but it is more efficient to use the <command tag="move">move</command> <glossary tag="command">command</glossary> instead.</p><p></p><p>The <b>dragSpeed</b> <glossary tag="property">property</glossary> determines how fast the drag motion is.</p></description>
</doc>