Knowledge Base

PRB: Events Not Firing When IE4 WebBrowser Placed On Web Page

Article ID: 183048

Article Last Modified on 5/11/2006

APPLIES TO

Microsoft Internet Explorer 4.0 128-Bit Edition
Microsoft Internet Explorer 4.01 Service Pack 2
Microsoft Internet Explorer 5.5

This article was previously published under Q183048

SYMPTOMS

WebBrowser events such as DocumentComplete, DownloadComplete, BeforeNavigate2, and others do not fire when you host the WebBrowser control in an HTML page under Internet Explorer 4.0x.

CAUSE

The WebBrowser ActiveX control is not designed to be used in an HTML OBJECT tag.

RESOLUTION

Microsoft does not support use of the WebBrowser control in an HTML OBJECT tag. Microsoft recommends using IFRAME or FRAMEs instead of embedding the WebBrowser control in HTML.

STATUS

This behavior is by design.

MORE INFORMATION

You cannot write Script event handlers for WebBrowser control events, such as DocumentComplete, BeforeNavigate2, and other events, when you host the WebBrowser control in an HTML page by using the OBJECT tag. These events are not fired. These events are not fired even if the WebBrowser control is wrapped in another ActiveX control and then embedded in HTML.

If the reason for hosting the WebBrowser control in an HTML page is to display documents within your Web page, Microsoft recommends that you use the IFRAME tag.

Steps to Reproduce the Behavior

Type and then save the following HTML as C:\Page1.htm:

<HTML>
<HEAD>
   <TITLE>WebBrowser Control in HTML</TITLE>
</HEAD>
<BODY>

<SCRIPT LANGUAGE="VBScript">
Sub WebBrowser1_BeforeNavigate2(pDisp, URL, Flags, _
      TargetFrameName,  PostData, Headers, Cancel)
   MsgBox "BeforeNavigate2"
end sub

Sub WebBrowser1_DocumentComplete(pDisp, URL)
   MsgBox "DocumentComplete"
end sub

Sub Window_OnLoad()
   WebBrowser1.Navigate "http://www.microsoft.com"
End Sub
</SCRIPT>

Navigate to C:\Page1.htm from Internet Explorer 4.0.

DocumentComplete and BeforeNavigate2 events are not fired.

REFERENCES

For more information about developing Web-based solutions for Microsoft Internet Explorer, visit the following Microsoft Web sites:

http://msdn.microsoft.com/ie/

http://support.microsoft.com/iep

Keywords: kbnofix kbprb kbfaq kbcode KB183048

Microsoft KB Archive/183048

Contents