<doc>

<legacy_id>3052</legacy_id>

<name>browserClick</name>

<type>message</type>

<syntax>

<example>browserClick <i>instanceId, elementId</i></example>

<example>XBrowser_Click<i> elementId, instanceId</i></example>

</syntax>

<library>Browser Library</library>

<objects>

<card/>

</objects>

<synonyms>

<synonym>XBrowser_Click</synonym>

</synonyms>

<classification>

</classification>

<references>

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

</references>

<history>

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

</history>

<platforms>

<windows/>

</platforms>

<classes>

<desktop/>

</classes>

<security>

<network/>

</security>

<summary>Sent when the mouse is clicked in a browser object.</summary>

<examples>

<example>on browserClick pInstanceId, pElementId</p><p> if pElementId is "help" then</p><p> helpShowPopup</p><p> end if</p><p>end browserClick</example>

</examples>

<description>

<p>The <b>browserClick</b> message is sent to the current card of a stack containing a browser object when the mouse is clicked in the browser.</p><p/><p><b>Parameters:</b></p><p>The <i>instanceId</i> is the integer identifier of the browser object</p><p>The <i>elementId</i> is the id of the html element that was clicked</p><p/><p><b>Note:</b> The <b>browserClick</b> message is only sent if advanced browser messages are turned on. To turn on advanced browser messages use the following command:</p><p/><p><command tag="revBrowserSet">revBrowserSet</command> &lt;instanceId&gt;, "messages", "true"</p><p/><p>The <b>browserClick</b> message is currently only available on Windows.</p><p/><p>The id of an html element is the element's "id" attribute. For example &lt;div id="navbar"&gt;. As this attribute is optional in most cases, not all html elements will have an id. If the html element that the mouse was clicked over does not have an id, then the <i>elementId</i> parameter will be empty.</p><p/><p><b>Note:</b> The <b>browserClick</b> message is not sent on OS X due to lack of system support in the underlying browser object.</p><p/><p><b>Note:</b> For general information on using the browser library, see the notes in the <function tag="revBrowserOpen">revBrowserOpen function</function> reference.</p><p/>

</description>

</doc>