<doc>
	<legacy_id>1846</legacy_id>
	<name>click</name>
	<type>command</type>

	<syntax>
		<example>click [button <i>mouseButtonNumber</i>] at <i>point</i> [with <i>key</i> [,<i>key</i> [,<i>key</i>]]]</example>
	</syntax>

	<synonyms>
	</synonyms>

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

	<examples>
<example>click at "100,200"</example>
<example>click button 2 at the loc of field 1</example>
<example><p>click at the mouseLoc with controlKey</p></example>
<example>click button 2 at the loc of button "Start"</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/>
		<web/>
	</classes>

	<security>
	</security>


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

	<references>
		<function tag="mouseClick">mouseClick Function</function>
		<function tag="clickLoc">clickLoc Function</function>
		<command tag="grab">grab Command</command>
		<command tag="type">type Command</command>
		<command tag="choose">choose Command</command>
		<property tag="dragSpeed">dragSpeed Property</property>
		<message tag="mouseUp">mouseUp Message</message>
		<message tag="linkClicked">linkClicked Message</message>
		<message tag="dragStart">dragStart Message</message>
		<message tag="mouseStillDown">mouseStillDown Message</message>
		<message tag="mouseDoubleUp">mouseDoubleUp Message</message>
	</references>

	<description>Use the <b>click</b> <glossary tag="command">command</glossary> to simulate the action of a click, instead of sending a <message tag="mouseDown">mouseDown</message> or <message tag="mouseUp">mouseUp</message> message--for example, to create a <keyword tag="graphic">graphic</keyword> or <keyword tag="image">image</keyword> with a <glossary tag="handler">handler</glossary>.<p></p><p><b>Parameters:</b></p><p>The <i>mouseButtonNumber</i> is the number of a <glossary tag="mouse button">mouse button</glossary>:</p><p></p><p>&#9;* 1 is the mouse button on Mac OS systems and the left button on Windows and Unix systems.</p><p>&#9;* 2 is the middle button on Unix systems.</p><p>&#9;* 3 is the right button on Windows and Unix systems, or Control-click on Mac OS systems.</p><p></p><p>If you don't specify a <i>mouseButtonNumber</i>, button 1 is used.</p><p></p><p>The <i>point</i> is any <glossary tag="expression">expression</glossary> that evaluates 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>key</i> is one of,,, or. You can specify up to three keys, separated by commas. (On Windows and <glossary tag="Unix">Unix</glossary>,indicates the Control key.)</p><p></p><p><b>Comments:</b></p><p>The <b>click</b> <glossary tag="command">command</glossary> sends a <message tag="mouseDown">mouseDown</message> and <message tag="mouseUp">mouseUp</message> <keyword tag="message box">message</keyword> to the <glossary tag="object">object</glossary> at the clicked location. If two <glossary tag="object">objects</glossary> both occupy the clicked location--one overlapping the other--the <glossary tag="message">messages</glossary> are sent to the <glossary tag="object">object</glossary> on top.</p><p></p><p>If the object under the <i>point</i> is a <keyword tag="button">button</keyword> whose <property tag="autoHilite">autoHilite</property> is true, the <b>click</b> <glossary tag="command">command</glossary> causes the <keyword tag="button">button</keyword> to <property tag="hilite">highlight</property> and unhighlight, just as though the user had clicked.</p><p></p><p>If the <i>point</i> is not within one of the <glossary tag="application">application's</glossary> windows, the <b>click</b> <glossary tag="command">command</glossary> has no effect. This means that you cannot use the <b>click</b> <glossary tag="command">command</glossary> to switch to another application.</p></description>
</doc>