Click here to Skip to main content
15,867,488 members
Articles / Desktop Programming / Windows Forms
Article

Using the WebBrowser control in .NET

Rate me:
Please Sign up or sign in to vote.
3.62/5 (53 votes)
14 Mar 20024 min read 1.7M   18.4K   245   232
Create a web browser completely in C#

A Web Browser in C#

This article describes creating a web browser completely in C#. The application hosts a Microsoft WebBrowser Control and uses the functions it provides for all control. Here is a screenshot:
Image 1

A lot of the functions do not work yet; most require some non-.NET programming to work. I stuck to pure .NET programming for this app, because it is meant to demonstrate features of the .NET Framework and not some APIs.

Building the Web Browser

Before you begin, you must generate some assemblies from the WebBrowser typlibs, so that they can be used in our code. Typlibs must be imported for:

  • The WebBrowser control itself, which is in SHDocVw.dll.
  • mshtml.tlb, if you plan to access the DHTML Object Model of the document.

This step is easy. At a command prompt, in a folder you create for this project, type:

aximp c:\windows\system\shdocvw.dll
tlbimp mshtml.tlb

The aximp command should generate two files: AxSHDocVw.dll and SHDocVw.dll. The tlbimp command should generate MSHTML.dll, which contains definitions for the DHTML DOM interfaces, along with about 3000 other types, so it might take a while to import.

Now you can proceed in several ways: You can do all coding by hand, or you can use Visual Studio.NET. I have done it the 'SDK way'. Basically, you have to create a form with:

  • The WebBrowser control itself.
  • A toolbar. Note that not all buttons on the toolbar work as you might expect them to.
  • A status bar. You can add panels for the status message, a progress bar, offline and secure icons, and a zone indicator. I've added these controls as placeholders only, they don't work (yet).
  • An address bar. This should be a panel with a label, a combo box, and a Go button.
  • A main menu for the application.
  • An image list for the toolbar.

Most of the initialisation code shall be added for you and little work needs to be done here. You must remember to add event handlers for the WebBrowser control, the status bar, the menus, the toolbar, the address combo box, and the Go button. All this code is present in the file WebBrowser.cs. In addition, extra dialogs are included in About.cs, ImportExport.cs, and Open.cs.

In the WebBrowser.cs file, you must put in the following statements in the namespace:

namespace ND.WebBrowser
{
  
  using System;
  using System.Drawing;
  using System.ComponentModel;
  using System.Windows.Forms;
  using Microsoft.Win32;
  using AxSHDocVw;
  using MSHTML;
  
  // etc..

Microsoft.Win32 is required because the application loads the URL MRU list from the registry. you can remove the MSHTML reference if you do not need it.

Notice SHDocVw is not included; this causes conflicts with the definitions in AxSHDocVw.dll. Most of the code is simple and calls functions of the WB control.

Menus and Toolbars

The menu and the toolbar are standard Windows Forms stuff. Menu popup events are handled to update the enabled/disabled and checked state of menu items. For example:

protected void mnuFile_Popup(object sender, EventArgs e)
    {
      MenuItem miFile = MenuMain.MenuItems[0];
      miFile.MenuItems[14].Checked = AxWebBrowser.Offline;
      
      Int32 EnabledTest = Convert.ToInt32(SHDocVw.OLECMDF.OLECMDF_SUPPORTED)
          + Convert.ToInt32(SHDocVw.OLECMDF.OLECMDF_ENABLED);
      
      miFile.MenuItems[2].Enabled = EnabledTest.Equals(AxWebBrowser.QueryStatusWB //Refresh test for Edit
        (SHDocVw.OLECMDID.OLECMDID_REFRESH));
      miFile.MenuItems[3].Enabled = EnabledTest.Equals(AxWebBrowser.QueryStatusWB
        (SHDocVw.OLECMDID.OLECMDID_SAVE));
      miFile.MenuItems[4].Enabled = EnabledTest.Equals(AxWebBrowser.QueryStatusWB
        (SHDocVw.OLECMDID.OLECMDID_SAVEAS));
      miFile.MenuItems[6].Enabled = EnabledTest.Equals(AxWebBrowser.QueryStatusWB
        (SHDocVw.OLECMDID.OLECMDID_PAGESETUP));
      miFile.MenuItems[7].Enabled = EnabledTest.Equals(AxWebBrowser.QueryStatusWB
        (SHDocVw.OLECMDID.OLECMDID_PRINT));
      miFile.MenuItems[8].Enabled = EnabledTest.Equals(AxWebBrowser.QueryStatusWB
        (SHDocVw.OLECMDID.OLECMDID_PRINTPREVIEW));
      miFile.MenuItems[13].Enabled = EnabledTest.Equals(AxWebBrowser.QueryStatusWB
        (SHDocVw.OLECMDID.OLECMDID_PROPERTIES));
    }

First, the File menu object is obtained. Then the WB control is used to check the enabled status of commands in the menu. If you are familiar with COM programming, this should be standard code. Otherwise, read the WebBrowser control documentation at <a href="http: msdn.microsoft.com="" library="" default.asp?url="/workshop/browser/webbrowser/reference/Objects/WebBrowser.asp"">MSDN: WebBrowser. Most commands are also executed in the standard COM IOleCommandTarget way, like this:

protected void mnuFileSave_Click(object sender, EventArgs e)
{
  Object o = null;
  m_axWebBrowser.ExecWB(SHDocVw.OLECMDID.OLECMDID_SAVE,
    SHDocVw.OLECMDEXECOPT.OLECMDEXECOPT_DODEFAULT,
    ref o, ref o);
}

A null object reference is passed for the input and output arguments of the ExecWB method. Simply because we have no arguments to pass. Some menu commands use methods of the WebBrowser control itself, like Home and Search. The other source files have other dialogs, like the Import & Export dialog.

protected void mnuFileOpen_Click(object sender, EventArgs e)
    {
      OpenForm frmOpen = new OpenForm();
      frmOpen.ShowDialog(this);
      if(frmOpen.DialogResult == DialogResult.OK)
      {
        Object o = null;
        AxWebBrowser.Navigate(frmOpen.Address, ref o, ref o, ref o, ref o);
      }
    }

The Import and Export dialog uses the ShellUIHelper object, documented at <a href="http: msdn.microsoft.com="" library="" default.asp?url="/workshop/browser/external/overview/overview.asp"">MSDN: Shell Helper API.

Editing the Document

Instead of calling an external editor, all editing is done by the WebBrowser control itself, using an IE 4 feature which allows documents to make themselves editable. However, our code only invokes the edit mode, and does nothing beyond that.

protected void mnuFileEdit_Click(object sender, EventArgs e)
    {
      IHTMLDocument2 doc;
      object boxDoc = AxWebBrowser.Document;
      doc = (IHTMLDocument2)boxDoc;
      doc.designMode = "On";
    }

The code first gets a reference to the Document object and then unboxes it to get to the IHTMLDocument2 interface. This is necessary because the WebBrowser control returns the document as an object and not an IHTMLDocument2 pointer.

The Finished Code

That just about sums up most of the code. However, a lot of things do not work yet. Here is a short list:

  1. 'Full Screen' and 'View Source' in the application menus.
  2. Enumeration of the user's Favourites and History.
  3. 'Send' submenu of 'File' menu.
  4. Mail button on toolbar.
  5. Edit works to only to a limited extent.
  6. Tools Menu.
  7. Back and Forward drop-downs.
  8. Some pages, especially those with frames, do not load properly. ( ? )
  9. There is no handling for new windows.
  10. Status bar icons (secure, offline, zone) are not displayed.

Most code should be easy to create, and can be done within the .NET Framework. However, some functions, like those for favourites and history, shall involve PInvoke.

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
President NikSci
India India
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
Questionstopping pop-ups Pin
A. Bhandari a.k.a Amit Bhandari18-Feb-06 2:45
A. Bhandari a.k.a Amit Bhandari18-Feb-06 2:45 
GeneralWinWord in AxWebBrowser Pin
pramod.21c12-Jan-06 18:14
pramod.21c12-Jan-06 18:14 
Generali cannot deal with this. Pin
yxy_769724-Mar-06 2:11
yxy_769724-Mar-06 2:11 
GeneralAxWebBrowser vs WebBrowser Pin
jmi09-Jan-06 14:37
jmi09-Jan-06 14:37 
Questionhow 2 work with combo box using axWebBrowser1 ? Pin
vedmack7-Jan-06 22:52
vedmack7-Jan-06 22:52 
AnswerRe: how 2 work with combo box using axWebBrowser1 ? Pin
mitja g1-Feb-07 10:45
mitja g1-Feb-07 10:45 
Question.Net 2.0 Webbrowser Control designMode="On" Pin
phanf2-Dec-05 8:25
phanf2-Dec-05 8:25 
QuestionDoes it need IIS ? Pin
Mohit3-Nov-05 11:53
Mohit3-Nov-05 11:53 
GeneralProblem Loading WEb Browser control Pin
JayaDurai26-Oct-05 2:13
JayaDurai26-Oct-05 2:13 
Questionmultiple sessions Pin
Cihan Selçuk21-Oct-05 15:57
Cihan Selçuk21-Oct-05 15:57 
Generaladvansed web browser Pin
hamid_m16-Sep-05 3:52
hamid_m16-Sep-05 3:52 
GeneralBack Next State Pin
Yaron Sh29-Aug-05 3:03
Yaron Sh29-Aug-05 3:03 
Generalerror &quot;System.Threading.ThreadStateException&quot; Pin
biaco25-Aug-05 13:58
biaco25-Aug-05 13:58 
GeneralRe: error Pin
biaco25-Aug-05 20:12
biaco25-Aug-05 20:12 
QuestionProgress bar? Pin
Lord Kixdemp5-Aug-05 22:44
Lord Kixdemp5-Aug-05 22:44 
AnswerRe: Progress bar? Pin
harshamn31-Aug-05 9:58
harshamn31-Aug-05 9:58 
GeneralRe: Progress bar? Pin
Lord Kixdemp1-Sep-05 11:47
Lord Kixdemp1-Sep-05 11:47 
QuestionHow to click button on Webbrowser. Pin
Member 201242821-Jul-05 18:34
Member 201242821-Jul-05 18:34 
QuestionHow to get workbook object of Excel opened in Web browser Pin
atodmal20-Jul-05 23:02
atodmal20-Jul-05 23:02 
QuestionHow to know when the page is fully loaded? Pin
Lord Kixdemp28-Jun-05 19:45
Lord Kixdemp28-Jun-05 19:45 
AnswerRe: How to know when the page is fully loaded? Pin
Lord Kixdemp29-Jun-05 15:50
Lord Kixdemp29-Jun-05 15:50 
AnswerRe: How to know when the page is fully loaded? Pin
neojjang2-Aug-05 19:28
neojjang2-Aug-05 19:28 
GeneralRe: How to know when the page is fully loaded? Pin
Lord Kixdemp5-Aug-05 22:36
Lord Kixdemp5-Aug-05 22:36 
GeneralRe: How to know when the page is fully loaded? Pin
Lord Kixdemp6-Aug-05 13:36
Lord Kixdemp6-Aug-05 13:36 
GeneralRe: How to know when the page is fully loaded? Pin
Kamran Ansari7-Oct-05 9:30
sussKamran Ansari7-Oct-05 9:30 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.