<ul class="download">
    <li><a href="WebBrowser_and_WF.zip">Download WebBrowser_and_WF.zip - 75.9 KB</a></li>
    <li><a href="Awesomium_in_WF.zip">Download Awesomium_in_WF.zip - 16.7 MB</a></li>
</ul>

<p>Gecko &amp; WebKit samples are under construction now, but already working and may be used as a good start:</p>

<ul class="download">
    <li><a href="GeckoFX_1.9_in_WF.zip">Download GeckoFX_1.9_in_WF.zip - 9.9 MB (very, very arhaic source version without Js, etc., but very, very small</a></li>
</ul>

<p>WebKit: <a href="http://dropmefiles.com/30SVq">http://dropmefiles.com/30SVq</a>&nbsp;(can&#39;t upload to codeproject with &quot;Unexpected error during upload&quot;)</p>

<h2>Who is who?</h2>

<h3><strong>WebBrowser</strong></h3>

<p>Default .NET browser engine.</p>

<p>Based on <code>MSHTML</code> + <code>Active-X</code> control based on COM <code>IWebBrowser2</code>. <code>MSHTML</code>+<code>IWebBrowser2</code> are main components of <strong>Internet Explorer</strong> browser.</p>

<p>Has <strong>different Winforms and WPF</strong>&nbsp;ports.</p>

<h3><strong>Gecko</strong></h3>

<p>Third-party browser engine.</p>

<p>Based on XULRunner used in <strong>Firefox</strong> browser.</p>

<p>Has <strong>Winforms</strong> version only.</p>

<p><strong><font color="red">Warning! This article fully actually only for very, very old Gecko version (1.9). I&#39;ll change it to newer and more powerful version (10.*..29.* probably), a bit later.</font></strong></p>

<h3><strong>Awesomium WebControl</strong></h3>

<p>Third-party browser <em>control with external customizable core</em>.</p>

<p>Based on .NET Awesomium core wrapper based on Awesomium core based on modified <strong>Chromium</strong>&nbsp;(or WebKit) engine.</p>

<p>Has <strong>different Winforms, WPF, Mono&nbsp;</strong>ports.</p>

<h3><strong>OpenWebKitSharp</strong></h3>

<p>Third-party browser engine.</p>

<p>Based on WebKit engine used in <strong>Safari&nbsp;</strong>and&nbsp;<strong>Chromium</strong>&nbsp;browsers.</p>

<p>Has&nbsp;<strong>Winforms</strong>&nbsp;version only.</p>

<h2>Who is better?</h2>

<p>Nobody! Programming language, framework, engine usually&nbsp;may be better <em>only</em> for&nbsp;a particular purpose.</p>

<p>You can define your objectives, weigh the pros and cons of engines listed in the table below, and select the engine, the best for you.</p>

<table border="5" cellpadding="1" cellspacing="6">
    <tbody>
        <tr>
            <td>&nbsp;</td>
            <td><strong>WebBrowser</strong></td>
            <td><strong>Gecko</strong></td>
            <td><strong>Awesomium</strong></td>
            <td><strong>OpenWebKitSharp</strong></td>
        </tr>
        <tr>
            <td><strong>License</strong></td>
            <td>Free. Proprietary</td>
            <td>Free. Open-source:&nbsp;MPL 1.1/GPL 2.0/LGPL 2.1</td>
            <td>Free if your revenue up to $100K (or costs $2900). Proprietary</td>
            <td>Free. Open-source</td>
        </tr>
        <tr>
            <td>
            <p><strong>OS/Platforms</strong></p>
            </td>
            <td>Winforms, WPF</td>
            <td>Winforms</td>
            <td>
            <p>Winforms, WPF</p>

            <p>Cross-platform: Unity, Mono, SDL</p>
            </td>
            <td>
            <p>Winforms.</p>

            <p>Cross-platform: ?</p>
            </td>
        </tr>
        <tr>
            <td>
            <p><strong>Page loading speed</strong></p>
            </td>
            <td>Low</td>
            <td>Medium (?). Control can freezing the form for few seconds on its create</td>
            <td>High</td>
            <td>High</td>
        </tr>
        <tr>
            <td>
            <p><strong>Required dlls size</strong></p>
            </td>
            <td>
            <p>0 MB (included in Win)</p>
            </td>
            <td>22.4 MB</td>
            <td>40.5 MB</td>
            <td>64.6 MB</td>
        </tr>
        <tr>
            <td><strong>Not freezing GUI when page loads</strong></td>
            <td>No</td>
            <td>No</td>
            <td>Yes</td>
            <td>No</td>
        </tr>
        <tr>
            <td><strong>Minimal .NET Version</strong></td>
            <td>.NET 2.0 or more older</td>
            <td>.NET 2.0 or more older</td>
            <td>.NET 4.0</td>
            <td>?</td>
        </tr>
        <tr>
            <td><strong>Object, method, property model</strong></td>
            <td>-</td>
            <td>WebBrowser-identical</td>
            <td>Not WebBrowser-identical</td>
            <td>WebBrowser-identical, but very&nbsp;unfinished, many methods and properties not working!</td>
        </tr>
        <tr>
            <td><strong>DOM manupulate - set HTML</strong></td>
            <td>Yes</td>
            <td>Yes</td>
            <td>Yes</td>
            <td>Via Js only</td>
        </tr>
        <tr>
            <td><strong>DOM manupulate -&nbsp;get HTML</strong></td>
            <td>Yes</td>
            <td>Yes</td>
            <td>Yes, but don&#39;t work with disabled&nbsp;JS! Also, there is a bug, use JS analogue - <span style="color: rgb(153, 0, 0); font-family: Consolas, 'Courier New', Courier, mono; font-size: 15px;">document.documentElement.outerHTML</span></td>
            <td>Via Js&nbsp;only</td>
        </tr>
        <tr>
            <td>
            <p><strong>DOM -&nbsp;GetElementById</strong></p>
            </td>
            <td>Yes</td>
            <td>Yes</td>
            <td>Via Js&nbsp;only</td>
            <td>?</td>
        </tr>
        <tr>
            <td>
            <p><strong>DOM -&nbsp;GetElementsByClassName</strong></p>
            </td>
            <td>Via Js&nbsp;only</td>
            <td>Yes</td>
            <td>Via Js&nbsp;only</td>
            <td>?</td>
        </tr>
        <tr>
            <td>
            <p><strong>DOM -&nbsp;GetElementsByTagName</strong></p>
            </td>
            <td>Yes</td>
            <td>Yes</td>
            <td>Via Js&nbsp;only</td>
            <td>?</td>
        </tr>
        <tr>
            <td><strong>Inject + exec / exec Js</strong></td>
            <td>Inject + exec</td>
            <td>Yes, in newer versions</td>
            <td>Exec</td>
            <td>Exec</td>
        </tr>
        <tr>
            <td><strong>Disable Js</strong></td>
            <td>No, only on all-IE level</td>
            <td>Yes</td>
            <td>Yes</td>
            <td>?</td>
        </tr>
        <tr>
            <td><strong>Set proxy</strong></td>
            <td>No, only on all-IE level</td>
            <td>Yes</td>
            <td>Yes</td>
            <td>?</td>
        </tr>
        <tr>
            <td>
            <p><strong>Dev - Built-in Visual HTML Builder</strong></p>
            </td>
            <td>Yes</td>
            <td>?</td>
            <td>No</td>
            <td>No</td>
        </tr>
        <tr>
            <td><strong>Dev - HTML code syntax-hl viewer</strong></td>
            <td>No</td>
            <td>?</td>
            <td>Yes</td>
            <td>Yes</td>
        </tr>
        <tr>
            <td><strong>Dev - HTML code&nbsp;Visual Inspector &amp; Editor</strong></td>
            <td>No</td>
            <td>?</td>
            <td>No</td>
            <td>Yes</td>
        </tr>
        <tr>
            <td><strong>Built-in download manager</strong></td>
            <td>?</td>
            <td>?</td>
            <td>?</td>
            <td>Yes</td>
        </tr>
    </tbody>
</table>

<h2>WebBrowser usage and tricks</h2>

<h4>Built-in Visual HTML Editor</h4>

<p>How to enable it:</p>

<pre lang="cs">
webBrowser1.Document.DomDocument.GetType().GetProperty(&quot;designMode&quot;).SetValue(webBrowser1.Document.DomDocument, &quot;On&quot;, null);</pre>

<p>How to paste HTML element programmatically:</p>

<pre lang="cs">
// appends:
// &lt;a id=&quot;mylink&quot; href=&quot;http://codeproject.com/&quot;&gt;
//   &lt;img id=&quot;myimg&quot; src=&quot;http://dj9okeyxktdvd.cloudfront.net/App_Themes/CodeProject/Img/logo250x135.gif&quot; /&gt;
// &lt;/a&gt;

var mylink = webBrowser1.Document.CreateElement(&quot;a&quot;);
mylink.Id = &quot;mylink&quot;;
mylink.SetAttribute(&quot;href&quot;, &quot;http://codeproject.com/&quot;);

var myimg = webBrowser1.Document.CreateElement(&quot;img&quot;);
myimg.Id = &quot;myimg&quot;;
myimg.SetAttribute(&quot;src&quot;, &quot;http://dj9okeyxktdvd.cloudfront.net/App_Themes/CodeProject/Img/logo250x135.gif&quot;);
mylink.AppendChild(myimg);
webBrowser1.Document.Body.AppendChild(mylink);</pre>

<h4>DOM element selection -&nbsp;GetElementById</h4>

<pre lang="cs">
var id = &quot;mylink&quot;;

var el = webBrowser1.Document.GetElementById(id);
if (el != null)
{
    MessageBox.Show(&quot;Element with id=\&quot;&quot; + id + &quot;\&quot; has innerHTML: &quot; + el.InnerHtml);
}
else
{
    MessageBox.Show(&quot;Element with id=\&quot;&quot; + id + &quot;\&quot; not found.&quot;);
}</pre>

<h4>DOM element selection -&nbsp;GetElementsByTagName</h4>

<pre lang="cs">
var tag = &quot;img&quot;;

var elz = webBrowser1.Document.GetElementsByTagName(tag);
if (elz.Count &gt; 0)
{
    MessageBox.Show(elz.Count + &quot; elements with tag &lt;&quot; + tag + &quot;&gt; found.&quot;);
}
else
{
    MessageBox.Show(&quot;No elements with tag &lt;&quot; + tag + &quot;&gt; found.&quot;);
}</pre>

<h4>DOM content manipulate - set HTML</h4>

<pre lang="cs">
webBrowser1.DocumentText = &quot;&lt;html&gt;&lt;head&gt;&lt;script&gt;alert(&#39;check!&#39;);&lt;/script&gt;&lt;/head&gt;&lt;body&gt;lorem&lt;/body&gt;&lt;/html&gt;&quot;;</pre>

<h4>Inject + exec Js</h4>

<pre lang="cs">
var head = webBrowser1.Document.GetElementsByTagName(&quot;head&quot;)[0];

var scriptEl = webBrowser1.Document.CreateElement(&quot;script&quot;);
scriptEl.SetAttribute(&quot;text&quot;, &quot;function sayHello() { alert(&#39;hello&#39;) }&quot;);
head.AppendChild(scriptEl);

webBrowser1.Document.InvokeScript(&quot;sayHello&quot;);</pre>

<h2>Gecko usage and tricks</h2>

<h4>DOM content manipulate -&nbsp;set HTML</h4>

<pre lang="cs">
geckoWebBrowser1.Document.DocumentElement.InnerHtml = &quot;&lt;html&gt;&lt;head&gt;&lt;/head&gt;&lt;body&gt;&lt;a class=\&quot;link\&quot;&gt;f&lt;/a&gt;&lt;/body&gt;&lt;/html&gt;&quot;;</pre>

<h4>DOM element selection -&nbsp;GetElementsByClassName</h4>

<pre lang="cs">
(geckoWebBrowser1.Document.GetElementsByClassName(&quot;link&quot;)[0] as Skybound.Gecko.GeckoElement).InnerHtml = &quot;tt&quot;;</pre>

<h2><span style="color: rgb(51, 51, 51); font-size: 30px;">Awesomium WebControl</span>&nbsp;usage and tricks</h2>

<h4>DOM content manipulate -&nbsp;set HTML</h4>

<pre lang="cs">
webControl1.HTML <span style="font-size: 9pt;">= &quot;&lt;html&gt;&lt;head&gt;&lt;script&gt;alert(&#39;check!&#39;);&lt;/script&gt;&lt;/head&gt;&lt;body&gt;lorem&lt;/body&gt;&lt;/html&gt;&quot;</span><span style="font-size: 9pt;">;</span></pre>

<h4>DOM content manipulate -&nbsp;get HTML</h4>

<pre lang="cs">
var allhtml = webControl1.ExecuteJavascriptWithResult(&quot;document.documentElement.outerHTML&quot;);</pre>

<h4>Exec Js</h4>

<pre lang="cs">
webControl1.ExecuteJavascript(&quot;document.body.innerHTML += &#39;&lt;i&gt;Hello, World!&lt;/i&gt;&#39;;&quot;);</pre>

<h4>Disable&nbsp;Js</h4>

<pre lang="cs">
var ws = WebCore.CreateWebSession(new WebPreferences() { Javascript = true });
webControl1 = new Awesomium.Windows.Forms.WebControl() { WebSession = ws };
this.Controls.Add(webControl1);</pre>

<h4>Set proxy</h4>

<pre lang="cs">
var ws = WebCore.CreateWebSession(new WebPreferences() { ProxyConfig = &quot;255.255.255:8080&quot; });
webControl1 = new Awesomium.Windows.Forms.WebControl() { WebSession = ws };
this.Controls.Add(webControl1);</pre>

<h2>OpenWebKitSharp&nbsp;usage and tricks</h2>

<h4>DOM content manipulate -&nbsp;set HTML</h4>

<pre lang="cs">
webKitBrowser1.GetScriptManager.EvaluateScript(&quot;document.body.innerHTML=&#39;&#39;;&quot;);</pre>