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

Retired KB Content Disclaimer

View products that this article applies to.

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.

Back to the top

CAUSE

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

Back to the top

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.

Back to the top

STATUS

This behavior is by design.

Back to the top

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.

Back to the top

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.

Back to the top

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://msdn.microsoft.com/ie/)

http://support.microsoft.com/iep (http://support.microsoft.com/iep)

Back to the top

APPLIES TO

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

Back to the top

kbcode kbfaq kbnofix kbprb KB183048

Back to the top

Retired KB Content Disclaimer

This article was written about products for which Microsoft no longer offers support. Therefore, this article is offered "as is" and will no longer be updated.

Back to the top