WebBrowser页与WinForm交互技巧

    最近看到博客园入门教学文章比较流行，自己最近又偷懒比较多，没啥心得，不妨写一篇没啥深度的入门文章吧。

    话说有了WebBrowser类，终于不用自己手动封装SHDocVw的AxWebBrowser这个ActiveX控件了。这个类如果仅仅作为一个和IE一模一样浏览器，那就太没意思了（还不如直接用IE呢）。那么，无论我们是想做一个“定制版IE”，还是希望利用HTML来做用户界面（指WinApp而非WebApp.许多单机软件，包括Windows的帮助支持中心，都是HTML做的），都少不了Windows Form和包含在WebBrowser中的Web页面的交互。本文将通过几个实际的例子，初步介绍一下WinForm和WebBrowser所包含的Web页面之间的交互。

    下面的代码假设你已经建立了一个Windows Form，上面有一个WebBrowser名为“webBrowser”。

    Study Case 1：用WinForm的Event Handler响应Web页面的事件

    现在有这样一个Windows Application，它的界面上只有一个WebBrowser，显示一个本地的HTML文件作为界面。现在的问题是，所有逻辑都可以放在HTML文件里，唯独“关闭”按钮遇到了困难——通常，Web页面是没有办法直接控制浏览器的，更不用说结束这个WinForm程序了。

    但是，在。Net 2.0当中，“由Windows Form响应Web页面的事件”已经成为了现实。

    在。Net 2.0中，整个HTML文档以及其包含的各个HTML元素，都和一个个HtmlDocument、HtmlElement之类的。Net对象对应。因此只要找到这个“关闭”按钮对应的HtmlElement对象，为其click事件添加Event Handler即可。

    假设HTML源代码如下：

< html >
< body >
< input  type ="button"  id ="btnClose"  value ="关闭"   />
SPAN style="COLOR: #800000" twffan="done">body >
SPAN style="COLOR: #800000" twffan="done">html >

    那么找出该按钮并为之添加Event Handler的代码如下：

HtmlDocument htmlDoc  =  webBrowser.Document;
HtmlElement btnElement  =  htmlDoc.All[ " btnClose " ];
if  (btnElement  !=   null )
{
    btnElement.click  +=   new  HtmlElementEventHandler(HtmlBtnClose_Click);
}

    其中HtmlBtnClose_Click是按下Web按钮时的Event Handler。

    很简单吧？那么稍稍高级一点的——我们都知道一个HTML元素可能有很多各种各样的事件，而HtmlElement这个类只给出最常用、共通的几个。那么，如何响应其他事件呢？这也很简单，只需要调用HtmlElement的AttachEventHandler就可以了：

btnElement.AttachEventHandler( " onclick " ,  new  EventHandler(HtmlBtnClose_Click)); 
// 这一句等价于上面的btnElement.click += new HtmlElementEventHandler(HtmlBtnClose_Click); 

    把"onclick"换成其他事件的名字就可以了。例如：

formElement.AttachEventHandler( " onsubmit " ,  new  EventHandler(HtmlForm_Submit)); 

    Study Case 2：表单（form）的自动填写和提交 

    要使我们的WebBrowser具有自动填表、甚至自动提交的功能，并不困难。

    假设有一个最简单的登录页面，输入用户名密码，点“登录”按钮即可登录。已知用户名输入框的id（或Name，下同）是username，密码输入框的id是password，“登录”按钮的id是submitbutton，那么我们只需要在webBrowser的DocumentCompleted事件中使用下面的代码即可：

HtmlElement btnSubmit  =  webBrowser.Document.All[ " submitbutton " ];
HtmlElement tbUserid  =  webBrowser.Document.All[ " username " ];
HtmlElement tbPasswd  =  webBrowser.Document.All[ " password " ];

if  (tbUserid  ==   null   ||  tbPasswd  ==   null   ||  btnSubmit  ==   null )
     return ;

tbUserid.SetAttribute( " value " ,  " smalldust " );
tbPasswd.SetAttribute( " value " ,  " 12345678 " );

btnSubmit.InvokeMember( " click " );

    这里我们用SetAttribute来设置文本框的“value”属性，用InvokeMember来调用了按钮的“click”方法。因为不同的Html元素，其拥有的属性和方法也不尽相同，所以.Net 2.0提供了统一的HtmlElement来概括各种Html元素的同时，提供了这两个方法以调用元素特有的功能。关于各种Html元素的属性和方法一览，可以查阅MSDN的DHTML Reference。

    ※关于表单的提交，的确还有另一种方法就是获取form元素而不是button，并用form元素的submit方法：

HtmlElement formLogin  =  webBrowser.Document.Forms[ " loginForm " ]; 
// …… 
formLogin.InvokeMember( " submit " ); 

    本文之所以没有推荐这种方法，是因为现在的网页，很多都在submit按钮上添加onclick事件，以对提交的内容做最基本的验证。如果直接使用form的submit方法，这些验证代码就得不到执行，有可能会引起错误。

    Study Case 3：查找并选择文本

    这次我们希望实现一个和IE一模一样的查找功能，以对Web页面内的文字进行查找。

    文本查找要借助于TextRange对象的findText方法。但是，。Net里并没有这个对象。这是因为，。Net 2.0提供的HtmlDocument，HtmlWindow，HtmlElement等类，只不过是对原有mshtml这个COM组件的不完整封装，只提供了mshtml的部分功能。所以许多时候，我们仍旧要借助mshtml来实现我们需要的功能。好在这些。Net类都提供了DomDocument这个属性，使得我们很容易把。Net对象转换为COM对象使用。下面的代码演示了如何查找Web页面的文本。

    （需要添加mshtml的引用，并加上using mshtml；）

     public  partial  class  SearchDemo : Form
    {
         //  建立一个查找用的TextRange（IHTMLTxtRange接口） 
         private  IHTMLTxtRange searchRange  =   null ;
         public  SearchDemo()
        {
            InitializeComponent();
        }

         private   void  btnSearch_Click( object  sender, EventArgs e)
        {
             //  Document的DomDocument属性，就是该对象内部的COM对象。 
            IHTMLDocument2 document  =  (IHTMLDocument2)webBrowser.Document.DomDocument;
             string  keyword  =  txtKeyword.Text.Trim();
             if  (keyword  ==   "" )
                 return ;

             //  IE的查找逻辑就是，如果有选区，就从当前选区开头+1字符处开始查找；没有的话就从页面最初开始查找。 
             //  这个逻辑其实是有点不大恰当的，我们这里不用管，和IE一致即可。 
             if  (document.selection.type.ToLower()  !=   " none " )
            {
                searchRange  =  (IHTMLTxtRange)document.selection.createRange();
                searchRange.collapse( true );
                searchRange.moveStart( " character " ,  1 );
            }
             else
            {
                IHTMLBodyElement body  =  (IHTMLBodyElement)document.body;
                searchRange  =  (IHTMLTxtRange)body.createTextRange();
            }

             //  如果找到了，就选取（高亮显示）该关键字；否则弹出消息。 
             if  (searchRange.findText(keyword,  1 ,  0 ))
            {
                searchRange.select();
            }
             else
            {
                MessageBox.Show( " 已搜索到文档结尾。 " );
            }
        }
    }