Name: browserBeforeNavigateFrame

Type: message

Syntax: browserBeforeNavigateFrame <instanceId>, <url> 

Syntax: XBrowser_BeforeNavigateFrame <url>, <instanceId> 

Summary: Sent when a browser is about to navigate to a new url in a frame

Synonyms: XBrowser_BeforeNavigateFrame

Associations: card

Introduced: 2.8.1

OS: mac,windows

Platforms: desktop

Security: network

Example:
on browserBeforeNavigateFrame pInstanceId, pUrl
  if not browserFrameNavAllowed() then
    global browserCancel
    put true into browserCancel
  end if
end browserBeforeNavigateFrame

Parameters:
instanceId: The integer identifier of the browser object >*Note:* For general information on using the browser library, see the notes in the revBrowserOpen function reference.
url: The new url that is about to be navigated to in the frame

Description:
The <browserBeforeNavigateFrame> message is sent to the current card of a stack containg a browser object when the browser object is about to navigate to a new url in a frame. i.e. a change in the url in the target browser has been requested but not yet actioned.

If the target is the main frame of the browser then the <browserBeforeNavigate message> is sent instead.

To prevent the navigation occuring, set the global variable <browserCancel> to true

>*Note:* For general information on using the browser library, see the notes in the <revBrowserOpen function> reference.

References: revBrowserOpen function (function), browserBeforeNavigate message (message), browserBeforeNavigate (message), browserDownloadRequest (message), browserNavigateCompleteFrame (message), browserCancel (glossary)
