<doc>
  <legacy_id>3049</legacy_id>
  <name>browserBeforeNavigate</name>
  <type>message</type>
  <syntax>
    <example>browserBeforeNavigate <i>instanceId, url</i></example>
    <example>XBrowser_BeforeNavigate<i> url, instanceId</i></example>
  </syntax>
  <library>Browser Library</library>
  <objects>
    <card/>
  </objects>
  <synonyms>
    <synonym>XBrowser_BeforeNavigate</synonym>
  </synonyms>
  <classification>
  </classification>
  <references>
    <command tag="revBrowserNavigate">revBrowserNavigate Command</command>
    <message tag="browserDownloadRequest">browserDownloadRequest Message</message>
    <message tag="browserBeforeNavigateFrame">browserBeforeNavigateFrame Message</message>
    <message tag="browserNewUrlWindow">browserNewUrlWindow Message</message>
  </references>
  <history>
    <introduced version="2.8.1">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
  </platforms>
  <classes>
    <desktop/>
  </classes>
  <security>
    <network/>
  </security>
  <summary>Sent before a browser navigates to a new url.</summary>
  <examples>
    <example>on browserBeforeNavigate pInstanceId, pUrl</p><p>  put pUrl into field "Browser Address" of group ("Browser" &amp;&amp; pInstanceId) of me</p><p>end browserBeforeNavigate</example>
  </examples>
  <description>
    <p>The <b>browserBeforeNavigate</b> message is sent to a the current card of the stack containing a browser object when the browser object is about to navigate to a new url, ie a change in url in the target browser has been requested but not yet actioned. </p><p/><p>If the target is the main frame of the browser (e.g. the html page containing the "FRAMESET" declaration), then the <b>browserBeforeNavigate</b> message is sent, otherwise the <message tag="browserBeforeNavigateFrame">browserBeforeNavigateFrame message</message> is sent instead</p><p/><p>To prevent the navigatation from occurring, set the global variable <href tag="dictionary/keyword/3071.xml">browserCancel</href> to true.</p><p/><p><b>Parameters:</b></p><p><i>url</i> : The new url that the browser is about to navigate to</p><p><i>instanceId</i> : the integer identifier of a 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>
  </description>
</doc>