Embed Netscape's Mozilla Browser in MFC Views

Wednesday May 7th 2003 by Bill SerGio
Share:

Embed Netscape's Mozilla Browser into MFC Views.

Environment: Internet, Networking.

Introduction

This is an updated version of the article and source code I originally wrote, showing how to embed the ActiveX Control created by Adam Lock for the Mozilla Browser in CViews and Dialogs in MFC applications that can easily be extended for ATL applications as well.

I have never liked Microsoft's restrictive license agreement for Internet Explorer's ActiveX Control, i.e., their WebBrowser ActiveX Control. So, if you want a browser that you can use in your applications sans Microsoft, you should consider using the Mozilla Browser because the source code is available for free and it is very easy to compile and put in any MFC or ATL project. Let me point out that both Mozilla and the ActiveX Control for Mozilla are independent projects that are not associated with either Netscape or AOL.

The source code is available free for both the ActiveX Control for Mozilla and Mozilla itself. I was able to compile the source code for both the first time I tried it with NO problems whatsoever, and the binaries are available for those people who don't want to bother compiling the source code.

Anyone who looks at the source code for the native Gecko API calls will see that there are much better ways of doing things than just Microsoft's way. For example, you can use Gecko's powerful APIs that are implemented via XPCOM (COM-like) interfaces directly in your own code.

Anyone who has every run Mozilla on Linux and experienced its lightning fast speed will find it hard to go back to ever using the very slow and often buggy Internet Explorer!

The demo project included here creates a dynamic instance of either Microsoft's WebBrowser ActiveX Control or the Mozilla ActiveX Control in a CView of an MFC SDI application. It furthers allows you to switch between these two very different browsers by setting a single variable, m_bMozilla, in the CGlobal class or through a popup dialog that allows the user to select the browser to use as follows:

CGlobal::CGlobal() {
  ...
  // Set condition for loading either Microsoft's WebBrowser
  // ActiveX Control or Mozilla's ActiveX Control
  //
  m_bMozilla = TRUE;
  }

Source Code

The source code for the demo project that goes with this article does NOT include the binary or source code for the Mozilla ActiveX Control because the source code for the Mozilla ActiveX Control is 4.5 megs and my Web site will not bear the download traffic! But, both the binary and full source code for the Mozilla ActiveX Control are available at the following locations:

http://ftp.mozilla.org/pub/mozilla/nightly/latest/embed-win32.zip
www.mozilla.org/ in subdirectory mozilla/embedding/browser/activex/src

Overview of the Mozilla ActiveX Control

The Mozilla ActiveX Control is implemented in ATL and it has a very small size of only 3 to 4Mb for the Gecko embedding engine compared to over 10Mb needed for IE. What is really cool is that the Mozilla ActiveX Control has an API that is identical to that of Internet Explorer, which makes it a breeze to implement in existing or new MFC and ATL applications because you can use your existing IE code with only a change in the CLSID. In other words, you only need to replace the CLSID_WebBrowser with CLSID_MozillaBrowser. VB developers just need to delete the IE control from their project and insert a Mozilla one with the same instance name.

The Mozilla ActiveX Control implements the IWebBrowser, IWebBrowserApp, IWebBrowser2, DWebBrowserEvents, and DWebBrowserEvents2 interfaces defined for Internet Explorer. It also implements a simple DOM using the same COM interfaces as you find in Internet Explorer 4.0 for IHtmlDocument2, IHtmlElement, IHtmlElementCollection, and so forth. This means that you can easily parse the contents of a page programmatically and even modify the page via the the Mozilla ActiveX Control. The control works any ActiveX control-compatible container, including IE HTML pages that can contain controls. The only thing you need to do is to register the single Mozilla control, mozctlx.dll, as follows:

Type and run "regsvr32 mozctlx.dll"

Using The Mozilla Control in C++

Included in the demo project with this article is a modified wrapper class that provides stub functions for creating and calling methods from either Microsoft's WebBrowser ActivexX Control or the Mozilla ActiveX Control.

// CWebBrowser2 wrapper class for Mozilla and IE WebBrowser
// Controls
class CWebBrowser2 : public CWnd
{
protected:
  DECLARE_DYNCREATE(CWebBrowser2)
public:
  CLSID const& GetClsid()
  {
  if ( g_Global.m_bMozilla ) {
    // For Mozilla ActiveX Control
    static CLSID const clsid
    =     { 0x1339b54c, 0x3453, 0x11d2, { 0x93, 0xb9, 0x0, 0x0,
                                          0x0, 0x0, 0x0, 0x0 } };
    return clsid;
  } else {
    // For Microsoft WebBrowser ActiveX Control
    static CLSID const clsid
    =     { 0x8856f961, 0x340a, 0x11d0, { 0xa9, 0x6b, 0x0, 0xc0,
                                          0x4f, 0xd7, 0x5,
                                          0xa2 } };
    return clsid;
  }
}

Using the Mozilla ActiveX Control requires nothing more than simply replacing the reference to CLSID_Browser with CLSID_MozillaBrowser and declaring the CLSID_MozillaBrowser as follows:

static const CLSID CLSID_MozillaBrowser=
  { 0x1339B54C, 0x3453, 0x11D2, { 0x93, 0xB9, 0x00, 0x00,
                                  0x00, 0x00, 0x00, 0x00 } };

For ATL programmers and those who just hate MFC, you can simply use the CControlSite class that is part of the control and based on ATL and not MFC so it is lighter and more suitable for non-MFC projects. There is a sample project called "CBrowse" on the Mozilla Web site that demonstrates how to use this class.

For Visual Basic Developers

To use the control in a Visual Basic:

  • Compile the control and ensure it is registered.
  • Right mouse over the VB control bar and select "Components...".
  • Choose "MozillaControl 1.0 Type Library" from the list of controls.
  • Voilá! The Mozilla ActiveX Control will appear in the toolbar and can be directly inserted into a project.
  • You can simply replace Microsoft's WebBrowser control now with the Mozilla control. That's it!

For Really Lazy Programmers

For really lazy programmers, there is even a tool on the Mozilla Web site, called "IEPatcher," that will scan an executable or DLL and patch it to replace instances of the IE control with the Mozilla control. Just use the IEPatcher tool on an existing binary and that binary will then run using the Mozilla control instead of Microsoft's WebBrowser ActiveX control.

Remember, guys and gals, think for yourself! Don't let Microsoft sell you a bill of goods that their way is the only way or the best way...

Anyone interested in new digital production techniques for shooting 35mm movies and new methods of syndicating television programming should call me or visit my Web site.

If you have any questions about this article or source code, please feel free to contact me. I have over 100 commercial software programs that you can purchase the source code for, as well as numerous systems for displaying advertising, with the user's full, informed consent, on millions of computers.

Bill SerGio, The Infomercial KingTM
http://www.software-rus.com
tvmogul1@yahoo.com
Wipeout61402@aol.com

Downloads

Download source - 288 Kb
Share:
Home
Mobile Site | Full Site
Copyright 2017 © QuinStreet Inc. All Rights Reserved