browser_browserify - CSDN
browser 订阅
Browser
信息
操作系统
未知
开发语言
开源协议
未知
Browser
jQuery Browser Plugin lets you extend browser detection capabilities and implements CSS browser selectors in jQuery. jQuery is a lightweight JavaScript library that emphasizes interaction between JavaScript and HTML, allowing you to easily include many components that enrich and benefit the developer's coding experience.
收起全文
精华内容
参与话题
  • Browser 架构

    2015-03-18 17:40:56
    公司产品的一个架构,这个架构是外国总部那边就设计好的,在这边唯一的一次比较大改动是一个牛人引入了HistoryPart结合ViewPager实现了滑动的前进后退。 ProxyBrowserView 在被构造的时候会被传入BrowserManager, ...
    公司产品的一个架构,这个架构是外国总部那边就设计好的,在这边唯一的一次比较大改动是一个牛人引入了HistoryPart结合ViewPager实现了滑动的前进后退。
    <1> ProxyBrowserView 在被构造的时候会被传入BrowserManager<既是C 也是 一个 ViewPager>, 一个 ProxiedBrowserView,以及一个
    HistoryPart, 如果没有给HistoryPart,那么会new 一个 HistoryPart并且 将此HistoryPart hold的 BrowserView设为此proxiedBrowserView, ProxyBrowserView会维护一个HistoryPart List,在构造时就将传入的HistoryPart加入到维护的HistoryPartList中,有一个commitHistoryPart 会添加输入的HistoryPart到List中, 在animatingToHistoryPart()或者 BrowserManager这个ViewPager的
    某个Page被select时,会调用。
    ProxyBrowserView某种意义上是BrowserView最外层的接口,
    在一个ProxyBrowserView中,因为有一个HistoryPart的list,而每个HistoryPart都对应一个ProxiedBrowserView,那么可以认为
    ProxyBrowserView代表了一群ProxiedBrowserView,但是作为一个浏览器,当然任何时候只能有一个proxiedBrowserView可以被显示或者说
    作为当前的BrowserView,那么这个ProxiedBrowserView选哪个,以及外界有操作引起ProxiedBrowserView变化,这些逻辑都在ProxyBrowser
    View中,ProxyBrowserView为里面的一群ProxiedBrowserView提供了对外被操作和操作的接口,类似于一个中间层, 而因为代表 V 的
    BrowserManager也被传入到了此ProxyBrowserView中,因此 ProxyBrowserView可以监视V的变化<ViewPager的PagerAdapter> 和 对 V 进行
    操作<ViewPager显示某个ProxiedBrowserView>。
    这种模式其实说白了就是封装 + 代理模式, 外边的实体 要交互的 对象 只是一个 BrowserView, 至于这个BrowserView当前倒是哪个是什么,不care,因此就有了ProxyBrowserView 代理了 一群被代理 的 ProxiedBrowserView 的 交互。

    <2>TabImpl里面也包含了一堆的proxiedBrowserView<纯粹从UI概念上说,因为用户从一个Tab切换到另外一个Tab,当前Tab的所有Webview都会被从ViewPager中remove,重新add 新的Tab的所有HistoryPart里的ProxiedBrowserView>, TabImpl直接和ProxyBrowserView有关联, 在TabImpl内部有一个BrowserViewProxy,里面就有一个ProxyBrowserView的引用,并且还有一个get方法返回里面的ProxyBrowserView引用,如果一个TabImpl里的引用指向的是null,那么会调用browserFragment<TabManager>的createBrowserView()<最后会以BrowserManager作为参数构造一个实例返回>。
    TabImpl是为了做Tab切换而专门加的一个类,而TabImpl还对外开放了一个接口来返回其代表的ProxyBrowserView,这样等于像Tab又封装了一下ProxyBrowerView。 因为BroserFragment本身就是一个TabManager,那么操作的直接实体应该是Tab<内部会维护一个Tab的List>。

    <3>HistoryPart顾名思义是为了使ProxiedBrowserView能够被以Nav History形式组织起来而对ProxiedBrowserView进行的再封装,
    为此,HistoryPart implements了ProxiedBrowserView内部的Delegate接口,意思就是ProxiedBrowserView的一部分逻辑功能被放在History中实现了,所以才是ProxiedBrowserView的Delegate。而HistoryPart中也保存一个指向ProxyBrowserView的引用,已得知当前proxy。
    当然的也会维护一个指向ProxiedBrowserView的引用,并且会把自己作为Delegate设置给ProxiedBrowserView

    <4>HistoryPart之间的切换也是在ProxyBrowserView中提供的,如果当前ProxyBrowserView所属的Tab是active的,就是当前展示给用户的,
    那么会显式的进行ViewPager的setCurrentItem来实现视觉上的从一个HistoryPart的View到另外一个HistoryPart的View的变化,
    而如果当前Tab不是active的,那么就不需要在视觉上进行切换<因为当前该Tab的所有HistoryPart的view都不在该Viewpager中>,之需要将该Tab对应的内存中的信息修改一下,会将此HistoryPart加入到ProxyBrowserView所维护的HistoryPartList中,并且会将其currentHistoryPart设为当前切换到的HistoryPart去, 一个是视觉上的切换,一个是后台数据上的切换。
    展开全文
  • c#winform使用WebBrowser 大全

    万次阅读 2016-01-16 22:32:07
     C# WinForm WebBrowser (一) MSDN资料  1、主要用途:使用户可以在窗体中导航网页。 2、注意:WebBrowser 控件会占用大量资源。使用完该控件后一定要调用 Dispose 方法,以便确保及时释放所有资源。...
    

    C# WinForm WebBrowser () MSDN资料 

    1主要用途:使用户可以在窗体中导航网页。

    2注意WebBrowser 控件会占用大量资源。使用完该控件后一定要调用 Dispose 方法,以便确保及时释放所有资源。必须在附加事件的同一线程上调用 Dispose 方法,该线程应始终是消息或用户界面 (UI) 线程。

    3WebBrowser 使用下面的成员可以将控件导航到特定 URL、在导航历史记录列表中向后和向前移动,还可以加载当前用户的主页和搜索页:

    1.URL属性:可读、可写,用于获取或设置当前文档的 URL。 

    WebBrowser 控件维护浏览会话期间访问的所有网页的历史记录列表。设置Url属性时,WebBrowser 控件导航到指定的 URL 并将该 URL 添加到历史记录列表的末尾。

    WebBrowser 控件在本地硬盘的缓存中存储最近访问过的站点的网页。每个页面都可以指定一个到期日期,指示页面在缓存中保留的时间。当控件定位到某页时,如果该页具有缓存的版本,则直接显示缓存中的内容而不必重新下载该页,从而节省了时间。使用 Refresh 方法强制 WebBrowser控件通过下载来重新加载当前页,从而确保控件显示最新版本。

    注意:即使已请求了另一个文档,该属性也包含当前文档的 URL。如果设置该属性的值,然后立即再次检索该值,要是 WebBrowser 控件尚未来得及加载新文档,则检索到的值可能与设置的值不同。

    2.Navigate方法将指定位置的文档加载到 WebBrowser 控件中。

    3.GoBack方法:如果导航历史记录中的上一页可用,则将 WebBrowser 控件导航到该页。

    如果导航成功,则返回true;如果导航历史记录中的上一页不可用,则返回false

     WebBrowser 控件维护浏览会话期间访问的所有网页的历史记录列表。可以使用GoForward方法实现一个后退按钮。

    使用 CanGoBack 属性确定导航历史记录是否可用以及是否包含上一页。处理 CanGoBackChanged 事件,在 CanGoBack 属性值更改时接收通知。

    4.GoForward方法:如果导航历史记录中的下一页可用,则将 WebBrowser 控件导航到该页。

    如果导航成功,则返回true;如果导航历史记录中的下一页不可用,则返回false

    WebBrowser 控件维护浏览会话期间访问的所有网页的历史记录列表。可以使用 GoForward 方法实现一个前进按钮.

    使用 CanGoForward 属性确定导航历史记录是否可用以及是否包含当前页之后的页。处理 CanGoForwardChanged 事件,在 CanGoForward 属性值更改时接收通知 

      5.GoHome方法:将 WebBrowser 控件导航到当前用户的主页。

      6.GoSearch方法:将 WebBrowser 控件导航到当前用户的默认搜索页。 

        默认搜索页存储在注册表的 HKEY_CURRENT_USER\Software\Microsoft\Internet Explorer\Main\Search Page 注册表项下。

        若要使用其他搜索页而不是默认搜索页,请调用 Navigate 方法或指定 Url 属性。

      7.Refresh方法:重新加载当前显示在 WebBrowser 控件中的文档。

      8.Stop方法:取消所有挂起的导航并停止所有动态页元素(如背景声音和动画)。

    如果导航不成功,则显示一页指示出现的问题。使用这些成员中的任何一个进行导航都会导致在导航的不同阶段发生 NavigatingNavigated DocumentCompleted 事件。


    4ObjectForScripting 属性:获取或设置一个对象,该对象可由显示在 WebBrowser 控件中的网页所包含的脚本代码访问。

    使用该属性启用 WebBrowser 控件承载的网页与包含 WebBrowser 控件的应用程序之间的通信。使用该属性可以将动态 HTML (DHTML) 代码与客户端应用程序代码集成在一起。为该属性指定的对象可作为 window.external 对象(用于主机访问的内置 DOM 对象)用于网页脚本。

    可以将此属性设置为希望其公共属性和方法可用于脚本代码的任何 COM 可见的对象。可以通过使用 ComVisibleAttribute 对类进行标记使其成为 COM 可见的类。

    若要从客户端应用程序代码调用网页中定义的函数,请使用可从 Document 属性检索的 HtmlDocument 对象的 HtmlDocument.InvokeScript 方法

    5AllowNavigation属性:获取或设置一个值,该值指示控件在加载其初始页之后是否可以导航到其他页。

    6AllowWebBrowserDrop属性:获取或设置一个值,该值指示 WebBrowser 控件是否导航到拖放到它上面的文档。

    7WebBrowserShortcutsEnabled属性:是否启用WebBrowser自带的快捷键。

    8ScriptErrorsSuppressed 属性:获取或设置一个值,该值指示出现脚本错误时,WebBrowser 控件是否显示错误对话框。

    9IsWebBrowserContextMenuEnabled属性:是否启用右键菜单。


    源:MSDN http://msdn.microsoft.com/zh-cn/library/system.windows.forms.webbrowser(v=vs.80).aspx

    C#WinForm WebBrowser (实用方法总结 

    实用方法1:获取状态栏信息

    void webBrowser1_StatusTextChanged(object sender, EventArgs e)
    {
        label1.Text = webBrowser1.StatusText;
    }

    实用方法2:页面跳转后改变地址栏地址

    //Navigated事件处理函数中改变地址栏地址是最恰当的:
    private void webBrowser1_Navigated(object sender, WebBrowserNavigatedEventArgs e)
    {
        textBox1.Text = webBrowser1.Url.ToString();
    }

    实用方法3:设置单选框

    //建议使用执行单击事件的方式来设置单选框,而不是修改属性:
    webBrowser1.Document.GetElementById("RBT_A").InvokeMember("click");

    实用方法4:设置联动型下拉列表

    //比较常见的联动型多级下拉列表就是省/市县选择了,这种情况下直接设置选择项的属性不会触发联动,需要在最后执行触发事件函数才能正常工作:

    foreach (HtmlElement f in s.GetElementsByTagName("option"))
    {
        if (f.InnerText == "北京")
        {
            f.SetAttribute("selected""selected");
        }
        else
        {
            f.SetAttribute("selected""");
        }
    }
    s.RaiseEvent("onchange");

    以上四种方法转于:http://www.cnblogs.com/SkyD/archive/2009/04/23/1441696.html

    实用方法一:在WinForm中相应Web事件
    假设HTML源代码如下:

    <html> 
    <body> 
    <input type="button" id="btnClose" value="关闭" /> 
    </body> 
    </html>

      

    HtmlDocument htmlDoc = webBrowser.Document; 
    HtmlElement btnElement = htmlDoc.All["btnClose"]; 
    if (btnElement != null

        btnElement.click += new HtmlElementEventHandler(HtmlBtnClose_Click); 
    }


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

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

    对于其他事件,把"onclick"换成该事件的名字就可以了。例如:

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

      

    实用方法二:模拟表单自动填写和提交

    假设有一个最简单的登录页面,输入用户名密码,点登录按钮即可登录。已知用户名输入框的id(或Name,下同)是username,密码输入框的idpassword登录按钮的idsubmitbutton,那么我们只需要在webBrowserDocumentCompleted事件中使用下面的代码即可:

    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");

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

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

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

    实用方法三:调用脚本

    首先是调用Web页面的脚本中已经定义好的函数。假设HTML中有如下Javascript

    function DoAdd(a, b) {
        return a + b;
    }

    那么,我们要在WinForm调用它,只需如下代码即可:

    object oSum = webBrowser.Document.InvokeScript("DoAdd"new object[] { 12 });
    int sum = Convert.ToInt32(oSum);

     

    其次,如果我们想执行一段Web页面中原本没有的脚本,该怎么做呢?这次.Net的类没有提供,看来还要依靠COM了。IHTMLWindow2可以将任意的字符串作为脚本代码来执行。

    string scriptline01 = @"function ShowPageInfo() {";
    string scriptline02 = @"     var numLinks = document.links.length; ";
    string scriptline03 = @"     var numForms = document.forms.length; ";
    string scriptline04 = @"     var numImages = document.images.length; ";
    string scriptline05 = @"     var numScripts = document.scripts.length; ";
    string scriptline06 = @"     alert('网页的统计结果:\r\n链接数:' + numLinks + ";
    string scriptline07 = @"        '\r\n表单数:' + numForms + ";
    string scriptline08 = @"        '\r\n图像数:' + numImages + ";
    string scriptline09 = @"        '\r\n脚本数:' + numScripts);}";
    string scriptline10 = @"ShowPageInfo();";

    string strScript = scriptline01 + scriptline02 + scriptline03 + scriptline04 + scriptline05 +
                       scriptline06 + scriptline07 + scriptline08 + scriptline09 + scriptline10;

    IHTMLWindow2 win = (IHTMLWindow2)webBrowser.Document.Window.DomWindow;
    win.execScript(strScript, "Javascript");
     

    以上三种实用方法转于:http://www.cnblogs.com/smalldust/archive/2006/03/08/345561.html

    最后:在脚本中调用WinForm里的代码,这个可能吗? 呵呵,当然是可能的。
    下面的代码示例演示如何使用 ObjectForScripting 属性。在该示例中,ObjectForScripting 属性被设置为当前窗体。

    view sourceprint?

    using System; 

    using System.Windows.Forms; 

    using System.Security.Permissions; 

      

    [PermissionSet(SecurityAction.Demand, Name="FullTrust")] 

    [System.Runtime.InteropServices.ComVisibleAttribute(true)] 

    public class Form1 : Form 

        private WebBrowser webBrowser1 = new WebBrowser(); 

        private Button button1 = new Button(); 

      

        [STAThread] 

        public static void Main() 

        { 

            Application.EnableVisualStyles(); 

            Application.Run(new Form1()); 

        } 

      

        public Form1() 

        { 

            button1.Text = "call script code from client code"; 

            button1.Dock = DockStyle.Top; 

            button1.Click += new EventHandler(button1_Click); 

            webBrowser1.Dock = DockStyle.Fill; 

            Controls.Add(webBrowser1); 

            Controls.Add(button1); 

            Load += new EventHandler(Form1_Load); 

        } 

      

        private void Form1_Load(object sender, EventArgs e) 

        { 

            webBrowser1.AllowWebBrowserDrop = false; 

            webBrowser1.IsWebBrowserContextMenuEnabled = false; 

            webBrowser1.WebBrowserShortcutsEnabled = false; 

            webBrowser1.ObjectForScripting = this; 

            // Uncomment the following line when you are finished debugging. 

            //webBrowser1.ScriptErrorsSuppressed = true; 

      

            webBrowser1.DocumentText = 

                "<html><head><script>" 

    C# WinForm WebBrowser (编辑模式 

    一、启用编辑模式、 浏览模式 及 自动换行

     
            /// <summary>
            /// 编辑模式
            /// </summary>
            public void EditMode()
            {
                if (this.webBrowser.Document != null)
                {
                    mshtml.IHTMLDocument2 doc = this.webBrowser.Document.DomDocument as mshtml.IHTMLDocument2;
                    if (doc != null)
                    {
                        doc.designMode = "on";
                    }
                }
            }

            /// <summary>
            /// 启用浏览模式
            /// </summary>
            public void BrowseMode()
            {
                if (this.webBrowser.Document != null)
                {
                    mshtml.IHTMLDocument2 doc = this.webBrowser.Document.DomDocument as mshtml.IHTMLDocument2;
                    if (doc != null)
                    {
                        doc.designMode = "off";
                    }
                }
            }

            /// <summary>
            /// 设置自动换行
            /// </summary>
            /// <param name="value"></param>
            public void SetAutoWrap(bool value)
            {
                mshtml.HTMLDocument doc = this.webBrowser.Document.DomDocument as mshtml.HTMLDocument;
                if (doc != null)
                {
                    mshtml.HTMLBody body = doc.body as mshtml.HTMLBody;
                    if (body != null)
                    {
                        body.noWrap = !value;
                    }
                }
            }

    在编辑模式下,可以使用:

      this.webBrowser.Document.ExecCommand([string],[bool],[object]);

    方法来操作WebBrowser中的HTML
    其中第一个字符串类型的参数为:要执行的命令的名称 
    第二个布尔类型的参数为: 是否向用户显示命令特定的对话框或消息框

    第三个Object类型的参数为:要使用该命令分配的值。并非适用于所有命令

    常见的命令有:

            private const string HTML_COMMAND_BOLD = "Bold";                       //加粗
            private const string HTML_COMMAND_UNDERLINE = "Underline";             //下划线
            private const string HTML_COMMAND_ITALIC = "Italic";                   //斜体
            private const string HTML_COMMAND_SUBSCRIPT = "Subscript";             //下标
            private const string HTML_COMMAND_SUPERSCRIPT = "Superscript";         //上标
            private const string HTML_COMMAND_STRIKE_THROUGH = "StrikeThrough";    //删除线
            private const string HTML_COMMAND_FONT_NAME = "FontName";              //字体
            private const string HTML_COMMAND_FONT_SIZE = "FontSize";              //字号
            private const string HTML_COMMAND_FORE_COLOR = "ForeColor";            //字体前景色
            private const string HTML_COMMAND_BACK_COLOR = "BackColor";            //字体背景色
            private const string HTML_COMMAND_INSERT_FORMAT_BLOCK = "FormatBlock"//加粗
            private const string HTML_COMMAND_REMOVE_FORMAT = "RemoveFormat";      //清楚样式
            private const string HTML_COMMAND_JUSTIFY_LEFT = "JustifyLeft";        //文本左对齐
            private const string HTML_COMMAND_JUSTIFY_CENTER = "JustifyCenter";    //文本中间对齐
            private const string HTML_COMMAND_JUSTIFY_RIGHT = "JustifyRight";      //文本右对齐
            private const string HTML_COMMAND_JUSTIFY_FULL = "JustifyFull";        //文本两端对齐
            private const string HTML_COMMAND_INDENT = "Indent";                   //增大缩进量
            private const string HTML_COMMAND_OUTDENT = "Outdent";                 //减小缩进量
            private const string HTML_COMMAND_INSERT_LINE = "InsertHorizontalRule";//插入分割符
            private const string HTML_COMMAND_INSERT_LIST = "Insert{0}List"// replace with (Un)Ordered 插入项目符号或项目编号
            private const string HTML_COMMAND_INSERT_IMAGE = "InsertImage";         //插入图像
            private const string HTML_COMMAND_INSERT_LINK = "CreateLink";           //插入链接
            private const string HTML_COMMAND_REMOVE_LINK = "Unlink";               //移除链接
            private const string HTML_COMMAND_TEXT_CUT = "Cut";                     //剪切
            private const string HTML_COMMAND_TEXT_COPY = "Copy";                   //复制
            private const string HTML_COMMAND_TEXT_PASTE = "Paste";                 //粘贴
            private const string HTML_COMMAND_TEXT_DELETE = "Delete";               //删除
            private const string HTML_COMMAND_TEXT_UNDO = "Undo";                   //撤销
            private const string HTML_COMMAND_TEXT_REDO = "Redo";                   //恢复
            private const string HTML_COMMAND_TEXT_SELECT_ALL = "SelectAll";        //全选
            private const string HTML_COMMAND_TEXT_UNSELECT = "Unselect";           //取消选择
            private const string HTML_COMMAND_TEXT_PRINT = "Print";                 // 打印
            private const string HTML_COMMAND_EDITMODE = "EditMode";                // 编辑模式
            private const string HTML_COMMAND_BROWSEMODE = "BrowseMode";            // 浏览模式
            private const string HTML_COMMAND_OVERWRITE = "OverWrite";             //转换插入、覆写模式

    // 更多的命令请参见:

    http://msdn.microsoft.com/en-us/library/ms533049.aspx

    C# WinForm WebBrowser (自定义操作【转】 

    ————————————————————————————————————————————————————————————————
      由于本人在开发中经常要在程序中嵌入浏览器,为了符合自己的需求经常要对浏览器进行扩展和定制, 解决这些问题需在网上找资料和学习的过程,我想可能很多开发者或许会遇到同样的问题,特写此文,以供大家参考。 


    MFC中使用浏览器

      在MFC中微软为我们提供了CHtmlViewCDHtmlDialog类让我们的程序很方便的嵌入浏览器和进行浏览器的二次开发,这比直 接使用WebBrowser控件要方便很多,所以本文中讨论的浏览器的问题都是针对CHtmlView来讨论的。文中将提到一个类CLhpHtmlView, 它是CHtmlView的派生类,文中提及的扩展或定制都将在CLhpHtmlView(或派生类)上实现。


    怎样扩展或定制浏览器

      浏览器定义了一些扩展接口(如IDocHostUIHandler可以定制浏览器界面有关的行为),以便开发者进行定制和扩展。浏览 器会在需要的时候向他的控制站点查询这些接口,在控制站点里实现相应的接口就可以进行相应的扩展。在MFC7.01类 库中,CHtmlView使用的控制站点是CHtmlControlSite的,在CHtmlControlSite类中 只实现了接口IDocHostUIHandler, 而要实现更多的扩展接口,必须用自定义的控制站类来取代CHtmlControlSite,在下文中提及的类CDocHostSite即为自定义 的控制站类。 

    关于接口的介绍请参考: 

    http://dev.csdn.net/develop/article/48/48483.shtm 

    如何使自定义的控制站点来替换默认的控制站点呢?在MFC7.0中只需重载CHtmlView的虚函数CreateControlSite即可: 

    BOOL CLhpHtmlView::CreateControlSite(COleControlContainer * pContainer, 

    COleControlSite ** ppSite, UINT /*nID*/, REFCLSID /*clsid*/)

    {

    *ppSite = new CDocHostSite(pContainer, this);// 创建自己的控制站点实例

    return (*ppSite) ? TRUE : FALSE;

    }

    VC6.0要替换控制站要复杂的多,这里就不讨论了,如需要6.0版本的请给我发邮件到yourshine@21cn.com


    定制鼠标右键弹出出菜单

      要定制浏览器的鼠标右键弹出菜单,必须在自定义的控制站点类中实现IDocHostUIHandler2接口,并且IE的 版本是5.5或以上。在接口IDocHostUIHandler2ShowContextMenu方法中调用浏览器类的OnShowContextMenu虚函数,我们 在浏览器类的派生类重载此虚函数即可实现右键菜单的定制,参见代码 

    HRESULT CDocHostSite::XDocHostUIHandler::ShowContextMenu(DWORD dwID,

                                                             POINT * ppt,

                                                             IUnknown * pcmdtReserved,

                                                             IDispatch * pdispReserved)

    {

    METHOD_PROLOGUE(CDocHostSite, DocHostUIHandler);

    return pThis->m_pView->OnShowContextMenu( dwID, ppt, pcmdtReserved,pdispReserved );

    }

    HRESULT CLhpHtmlView::OnShowContextMenu(DWORD dwID, 

                                            LPPOINT ppt,

                                            LPUNKNOWN pcmdtReserved, 

                                            LPDISPATCH pdispReserved)

    {

    HRESULT result = S_FALSE;

    switch(m_ContextMenuMode)

    {

    case NoContextMenu:// 无菜单

    result=S_OK;

    break;

    case DefaultMenu:// 默认菜单

    break;

    case TextSelectionOnly:// 仅文本选择菜单

    if(!(dwID == CONTEXT_MENU_TEXTSELECT || dwID == CONTEXT_MENU_CONTROL))

    result=S_OK;

    break;

    case CustomMenu:// 自定义菜单

    if(dwID!=CONTEXT_MENU_TEXTSELECT)

    result=OnShowCustomContextMenu(ppt,pcmdtReserved,pdispReserved);

    break;

    }

    return result;

    }

    CLhpHtmlView中定义的枚举类型CONTEXT_MENU_MODE举出了定制右键弹出菜单的四种类型 

    enum CONTEXT_MENU_MODE// 上下文菜单

    {

    NoContextMenu,// 无菜单

    DefaultMenu,// 默认菜单

    TextSelectionOnly,// 仅文本选择菜单

    CustomMenu// 自定义菜单

    };

    通过CLhpHtmlView的函数SetContextMenuMode来设置右键菜单的类型。如果设定的右键弹出菜单是自定义菜单类型, 我们只要在CLhpHtmlView的派生类中重载OnShowCustomContextMenu虚函数即可,如下代码 CDemoViewCLhpHtmlView的派生类 

    HRESULT CDemoView::OnShowCustomContextMenu(LPPOINT ppt, LPUNKNOWN pcmdtReserved,LPDISPATCH pdispReserved)

    {

    if ((ppt==NULL)||(pcmdtReserved==NULL)||(pcmdtReserved==NULL))

    return S_OK;

    HRESULT hr=0;

    IOleWindow *oleWnd=NULL;

        hr=pcmdtReserved->QueryInterface(IID_IOleWindow, (void**)&oleWnd);

    if((hr != S_OK)||(oleWnd == NULL))

    return S_OK;

    HWND hwnd=NULL;

    hr=oleWnd->GetWindow(&hwnd);

    if((hr!=S_OK)||(hwnd==NULL))

    {

    oleWnd->Release();

    return S_OK;

    }

    IHTMLElementPtrpElem=NULL;

    hr = pdispReserved->QueryInterface(IID_IHTMLElement, (void**)&pElem);

    if(hr != S_OK)

    {

    oleWnd->Release();

    return S_OK;

    }

    IHTMLElementPtrpParentElem=NULL;

    _bstr_ttagID;

    BOOL go=TRUE;

    pElem->get_id(&tagID.GetBSTR());

    while(go && tagID.length()==0)

    {

    hr=pElem->get_parentElement(&pParentElem);

    if(hr==S_OK && pParentElem!=NULL)

    {

    pElem->Release();

    pElem=pParentElem;

    pElem->get_id(&tagID.GetBSTR());

    }

    else

    go=FALSE;

    };

    if(tagID.length()==0)

    tagID="no id";

    CMenu Menu,SubMenu;

    Menu.CreatePopupMenu();

    CString strTagID = ToStr(tagID);

    if(strTagID == "red")

    Menu.AppendMenu(MF_BYPOSITION, ID_RED, "您点击的是红色");

    else if(strTagID == "green")

    Menu.AppendMenu(MF_BYPOSITION, ID_GREEN, "您点击的是绿色");

    else if(strTagID == "blue")

    Menu.AppendMenu(MF_BYPOSITION, ID_BLUE, "您点击的是蓝色");

    else

    Menu.AppendMenu(MF_BYPOSITION, ID_NONE, "你点了也白点,请在指定的地方点击");

    int MenuID=Menu.TrackPopupMenu(TPM_RETURNCMD|TPM_LEFTALIGN|TPM_RIGHTBUTTON,ppt->x, ppt->y, this);

    switch(MenuID)

    {

    case ID_RED:

    MessageBox("红色");

    break;

    case ID_GREEN:

    MessageBox("红色");

    break;

    case ID_BLUE:

    MessageBox("红色");

    break;

    case ID_NONE:

    MessageBox("haha");

    break;

    }

    oleWnd->Release();

    pElem->Release();

    return S_OK;

    }


    实现脚本扩展(很重要的external接口)

      在你嵌入了浏览器的工程中,如果网页的脚本中能调用C++代码,那将是一件很惬意的事情,要实现这种交互,就必须实现脚本扩展。实现脚本扩展就是在程序中实现一个IDispatch接口,通过CHtmlView类的OnGetExternal虚函数返回此接口指针,这样就可以在脚本中通过window.external.XXX(关键字window可以省略)来 引用接口暴露的方法或属性(XXX为方法或属性名)。在MFC中从CCmdTarget派生的类都可以实现自动化,而不必在MFC工程中引入繁杂的ATL。从CCmdTarget派生的类实现自动化接口的时候不要忘了在构造函数中调用EnableAutomation函数。
      要使虚函数OnGetExternal发挥作用必须在 自定义的控制站点类中实现IDocHostUIHandler,在接口IDocHostUIHandlerGetExternal方法中调用浏览器类的OnGetExternal虚函数,我们在浏览器类的派生类重载OnGetExternal虚函数, 通过参数lppDispatch返回一个IDispatch指针,这样脚本中引用window.external时就是引用的返回的接口,参见代码 

    HRESULT CDocHostSite::XDocHostUIHandler::GetExternal(IDispatch ** ppDispatch)

    {

    METHOD_PROLOGUE(CDocHostSite, DocHostUIHandler);

    return pThis->m_pView->OnGetExternal( ppDispatch );

    }

    CLhpHtmlView::CLhpHtmlView(BOOL isview)

    {

    ......

    EnableAutomation();// 允许自动化

    }

    HRESULT CLhpHtmlView::OnGetExternal(LPDISPATCH *lppDispatch)

    {

    *lppDispatch = GetIDispatch(TRUE);// 返回自身的IDispatch接口

    return S_OK;

    }      

    请注意上面代码中,在OnGetExternal返回的是自身IDispatch接口, 这样就不比为脚本扩展而另外写一个从CCmdTarget派生的新类, CLhpHtmlView本身就是从CCmdTarget派生,直接在上面实现接口就是。 

    下用具体示例来说明怎样实现脚本扩展 

    示例会在网页上点击一个按钮而使整个窗口发生抖动

    CLhpHtmlView派生一个类CDemoView,在类中实现IDispatch, 并通过IDispatch暴露方法WobbleWnd 

    ---------------------------------------------------------------------------

    文件 DemoView.h

    ---------------------------------------------------------------------------

    .......

    class CDemoView : public CLhpHtmlView

    {

    ......

    DECLARE_DISPATCH_MAP() // 构建dispatch映射表以暴露方法或属性

    ......

    void WobbleWnd();// 抖动窗口

    };

    ---------------------------------------------------------------------------

    文件 DemoView.cpp

    ---------------------------------------------------------------------------

    ......

    // 把成员函数映射到Dispatch映射表中,暴露方法给脚本

    BEGIN_DISPATCH_MAP(CDemoView, CLhpHtmlView)

    DISP_FUNCTION(CDemoView, "WobbleWnd", WobbleWnd, VT_EMPTY, VTS_NONE)

    END_DISPATCH_MAP()

    ......

    void CDemoView::WobbleWnd()

    {

    // 在这里实现抖动窗口

    ......

    }

    ---------------------------------------------------------------------------

    文件 Demo.htm

    ---------------------------------------------------------------------------

    ...... οnclick="external.WobbleWnd()" ......

    这里我要介绍一下DISP_FUNCTION宏,它的作用是将一个函数映射到Dispatch映射表中,我们看 

    DISP_FUNCTION(CDemoView, "WobbleWnd", WobbleWnd, VT_EMPTY, VTS_NONE)

    CDemoView是宿主类名, "WobbleWnd"是暴露给外面的名字(脚本调用时使用的名字), VT_EMPTY是返回值得类型为空,VTS_NONE说明此方法没有参数,如果要映射的函数有返回值和参数该 如何映射,通过下面举例来说明 

    DISP_FUNCTION(CCalendarView,"TestFunc",TestFunc,VT_BOOL,VTS_BSTR VTS_I4 VTS_I4)

    BOOL TestFunc(LPCSTR param1, int param2, int param3)

    {

    .....

    }

    参数表VTS_BSTR VTS_I4 VTS_I4是用空格分隔,他们的类型映射请参考MSDN,这要提醒的是不要把VTS_BSTRCString对应,而应与LPCSTR对应。


    C++代码中如何调用网页脚本中的函数

      IHTMLDocument2::scripts属性表示HTML文档中所有脚本对象。使用脚本对象的IDispatch接口的GetIDsOfNames方法可以得到脚本函数的 DispID,得到DispID后,使用IDispatchInvoke函数可以调用对应的脚本函数。CLhpHtmlView提供了方便的调用JavaScript的函数,请参考CLhpHtmlView中有关键字“JScript”的代码。


    定制消息框的标题

      我们在脚本中调用alert弹出消息框时,消息框的标题是微软预定义的“Microsoft Internet Explorer”,如下图:



      在自定义的控制站点类中实现IDocHostShowUI接口,在接口的ShowMessage方法中调用浏览器的OnShowMessage,我们重载 OnShowMessage虚函数即可定制消息框的标题,实现代码如下: 

    // 窗口标题"Microsoft Internet Explorer"的资源标识

    #define IDS_MESSAGE_BOX_TITLE 2213

    HRESULT CLhpHtmlView::OnShowMessage(HWND hwnd,

                                        LPOLESTR lpstrText,

                                        LPOLESTR lpstrCaption,

                                        DWORD dwType,

                                        LPOLESTR lpstrHelpFile,

                                        DWORD dwHelpContext,

                                        LRESULT * plResult)

    {

        //载入Shdoclc.dll 和IE消息框标题字符串

        HINSTANCE hinstSHDOCLC = LoadLibrary(TEXT("SHDOCLC.DLL"));

        if (hinstSHDOCLC == NULL)

            return S_FALSE;

    CString strBuf,strCaption(lpstrCaption);

    strBuf.LoadString(hinstSHDOCLC, IDS_MESSAGE_BOX_TITLE);

        // 比较IE消息框标题字符串和lpstrCaption

        // 如果相同,用自定义标题替换

    if(strBuf==lpstrCaption)

            strCaption = m_DefaultMsgBoxTitle;

        // 创建自己的消息框并且显示

        *plResult = MessageBox(CString(lpstrText), strCaption, dwType);

        //卸载Shdoclc.dll并且返回

        FreeLibrary(hinstSHDOCLC);

        return S_OK;

    }

    从代码中可以看到通过设定m_DefaultMsgBoxTitle的值来改变消息宽的标题,修改此值是同过SetDefaultMsgBoxTitle来实现 

    void CLhpHtmlView::SetDefaultMsgBoxTitle(CString strTitle)

    {

    m_DefaultMsgBoxTitle=strTitle;

    }


    怎样定制、修改浏览器向Web服务器发送的HTTP请求头

      在集成了WebBrowser控件的应用中,Web服务器有时可能希望客户端(浏览器)发送的HTTP请求中附带一些额外的信息或自定义的 HTTP头字段,这样就必须在浏览器中控制向Web服务器发送的HTTP请求。 下面是捕获的一个普通的用浏览器发送的HTTP请求头: 

    GET /text7.htm HTTP/1.0

    Accept: image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/x-shockwave-flash, \

    application/vnd.ms-excel, application/vnd.ms-powerpoint, application/msword, */*

    Referer: http://localhost

    Accept-Language: en-us

    User-Agent: Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1; Poco 0.31; LHP Browser 1.01; \

    .NET CLR 1.1.4322)

    Host: localhost

    Connection: Keep-Alive

    CHtmlView的 

    void Navigate2(

       LPCTSTR lpszURL,

       DWORD dwFlags = 0,

       LPCTSTR lpszTargetFrameName = NULL,

       LPCTSTR lpszHeaders = NULL,

       LPVOID lpvPostData = NULL,

       DWORD dwPostDataLen = 0 

    );

    函数参数lpszHeaders可以指定HTTP请求头,示例如下

    Navigate2(_T("http://localhost"),NULL,NULL, "MyDefineField: TestValue");

    我们捕获的HTTP头如下: 





    怎样修改浏览器标识

      在HTTP请求头中User-Agent字段表明了浏览器的版本以及操作系统的版本等信息。WEB服务器经常需要知道用户请求页面时是来自IE还是来自自己的客户端中的WebBrowser控件, 以便分开处理,而WebBrowser控件向WEB服务器发送的浏览器标识(User-Agent字段)跟用IE发送的是一样的,怎样区分自己的浏览器和IE呢? 微软没有提供现成的方法,要自己想法解决。 前面讨论的定制HTTP请求头就是为这一节准备的。 思路是这样的: 在自己的浏览器里处理每一个U页面请求,把请求头User-Agent改成自己想要的。 在CHtmlViewOnBeforeNavigate2虚函数里来修改HTTP请求是再好不过了, 

    #define WM_NVTO(WM_USER+1000)

    class NvToParam

    {

    public:

    CString URL;

    DWORD Flags;

    CString TargetFrameName;

    CByteArray PostedData;

    CString Headers;

    };

    void CDemoView::OnBeforeNavigate2(LPCTSTR lpszURL, 

                                      DWORD nFlags, 

                                      LPCTSTR lpszTargetFrameName, 

                                      CByteArray& baPostedData, 

                                      LPCTSTR lpszHeaders, 

                                      BOOL* pbCancel)

    {

    CString strHeaders(lpszHeaders);

    if(strHeaders.Find("User-Agent:LHPBrowser 1.0") < 0)// 检查头里有没有自定义的User-Agent串

    {

    *pbCancel = TRUE;// 没有,取消这次导航

    if(!strHeaders.IsEmpty())

    strHeaders += "\r\n";

    strHeaders += "User-Agent:LHPBrowser 1.0";// 加上自定义的User-Agent串

    NvToParam* pNvTo = new NvToParam;

    pNvTo->URL = lpszURL;

    pNvTo->Flags = nFlags;

    pNvTo->TargetFrameName = lpszTargetFrameName;

    baPostedData.Copy(pNvTo->PostedData);

    pNvTo->Headers = strHeaders;

    // 发送一个自定义的导航消息,并把参数发过去

    PostMessage(WM_NVTO,(WPARAM)pNvTo);

    return;

    }

    CHtmlView::OnBeforeNavigate2(lpszURL, 

                                 nFlags, 

                                 lpszTargetFrameName, 

                                 baPostedData, 

                                 lpszHeaders, 

                                 pbCancel);

    }

    LRESULT CDemoView::OnNvTo(WPARAM wParam, LPARAM lParam)

    {

    NvToParam* pNvTo = (NvToParam*)wParam;

    Navigate2((LPCTSTR)pNvTo->URL, 

               pNvTo->Flags, 

               pNvTo->PostedData, 

               (LPCTSTR)pNvTo->TargetFrameName, 

               (LPCTSTR)pNvTo->Headers);

    delete pNvTo;

    return 1;

    }

    OnBeforeNavigate2中如果发现没有自定义的User-Agent串,就加上这个串,并取消本次导航,再Post一个消息(一定要POST,让OnBeforeNavigate2跳出以后再进行导航 ),在消息中再次导航,再次导航时请求头已经有了自己的标识,所以能正常的导航。 


    去掉讨厌的异常警告 

      在程序中使用了CHtmlView以后,我们在调整窗口大小的时候经常会看到输出窗口输出的异常警告: ReusingBrowser.exe 中的 0x77e53887 处最可能的异常: Microsoft C++ exception: COleException @ 0x0012e348 。 

    Warning: constructing COleException, scode = DISP_E_MEMBERNOTFOUND($80020003).

    这是由于CHtmlView在处理WM_SIZE消息时的一点小问题引起的,采用如下代码处理WM_SIZE消息就不会有此警告了 

    void CLhpHtmlView::OnSize(UINT nType, int cx, int cy)

    {

    CFormView::OnSize(nType, cx, cy);

    if (::IsWindow(m_wndBrowser.m_hWnd)) 

    CRect rect; 

    GetClientRect(rect); 

    // 就这一句与CHtmlView的不同

    ::AdjustWindowRectEx(rect, GetStyle(), FALSE, WS_EX_CLIENTEDGE);

    m_wndBrowser.SetWindowPos(NULL, 

                              rect.left, 

                              rect.top, 

                              rect.Width(), 

                              rect.Height(), 

                              SWP_NOACTIVATE | SWP_NOZORDER); 

    }


    怎样处理浏览器内的拖放 

      有时可能有这样的需求,我们希望在资源管理器里托一个文件到浏览器而做出相应的处理,甚至是将文件拖到某一个网页元素上来做出相应的处理,而浏览器默认的处理拖放文件操作是将文件打开,但WebBrowser控件给了我们一个自己处理拖放的机会。 那就是在自定义的控制站点类中实现IDocHostUIHandler,在接口IDocHostUIHandlerGetDropTarget方法中调用 浏览器类的OnGetDropTarget虚函数。要处理网页内的拖放,必需在OnGetDropTarget函数中返回一个自己定义的IDropTarget接口指针, 所以我们自己写一个类CMyOleDropTargetCOleDropTarget类派生,并且在实现IDropTarget接口,此类的代码在这就不列出了,请下载演示 程序,参考文件MyOleDropTarget.hMyOleDropTarget.cpp。我们看CLhpHtmlViewOnGetDropTarget的代码 

    HRESULT CLhpHtmlView::OnGetDropTarget(LPDROPTARGET pDropTarget, LPDROPTARGET* ppDropTarget )

    {

    m_DropTarget.SetIEDropTarget(pDropTarget);

    LPDROPTARGET pMyDropTarget;

    pMyDropTarget = (LPDROPTARGET)m_DropTarget.GetInterface(&IID_IDropTarget);

    if(pMyDropTarget)

    {

    *ppDropTarget = pMyDropTarget;

    pMyDropTarget->AddRef();

    return S_OK;

    }

    return S_FALSE;

    }

    m_DropTarget即为自定义的处理拖放的对象。这样就能通过在从CLhpHtmlView派生的类中重载OnDragEnterOnDragOver、 OnDropOnDragLeave虚函数来处理拖放了。在这里顺带讲一下视图是怎样处理拖放的。 要使视图处理拖放,首先在视图里添加一个COleDropTarget(或派生类)成员变量,如CLhpHtmlView中的“CMyOleDropTarget m_DropTarget;”,再在 视图创建时调用COleDropTarget对象的Register,即把视图与COleDropTarget对象关联起来,如CLhpHtmlView中的“m_DropTarget.Register(this);”,再对拖放 触发的事件进行相应的处理, OnDragEnter 把某对象拖入到视图时触发,在此检测拖入的对象是不是视图想接受的对象,如是返回“DROPEFFECT_MOVE”表示接受此对象,如 

    if(pDataObject->IsDataAvailable(CF_HDROP))// 被拖对象是文件吗?

    return DROPEFFECT_MOVE;

    OnDragOver 被拖对象在视图上移动,同OnDragEnter一样检测拖入对象,如果要接受此对象返回“DROPEFFECT_MOVE”。 OnDrop 拖着被拖对象在视图上放开鼠标,在这里对拖入对象做出处理; OnDragLeave 拖着被拖对象离开视图。 C++的代码写好了,但事情还没完,还必须在网页里用脚本对拖放事件进行处理, 即页面里哪个元素要接受拖放对象哪个元素就要处理ondragenterondragoverondrop,代码其实很简单,让事件的返回值为false即可,这样 C++的代码才有机会处理拖放事件,代码如下: 

    ......

    <td οndragenter="event.returnValue = false" οndragοver="event.returnValue = false" \

    οndrοp="event.returnValue = false">

    ......

    如果要使整个视图都接受拖放,则在Body元素中处理此三个事件。 注意:别忘了让工程对OLE的支持即在初始化应用程序时调用AfxOleInit()


    怎样禁止网页元素的选取

      用网页做界面时多数情况下是不希望网页上的元素是能够被鼠标选中的, 要使网页元素不能被选中做法是:给浏览器的宿主信息标记加上DOCHOSTUIFLAG_DIALOG标记。

    宿主信息标记N个标记位来控制浏览器的许多性质,如: 

    · 禁用浏览器的3D的边缘; 

    · 禁止滚动条; 

    · 禁用脚本; 

    · 定义双击处理的方式; 

    · 禁用浏览器的自动完成功能; 

    ...... 更多详情请参考MSDNDOCHOSTUIFLAG帮助。

    怎样修改宿主信息标记

    CDocHostSite中实现IDocHostUIHandler, 在GetHostInfo方法中调用浏览器的OnGetHostInfo虚函数,在虚函数OnGetHostInfo中便可指定宿主信息标记,如:

    HRESULT CLhpHtmlView::OnGetHostInfo(DOCHOSTUIINFO * pInfo)

    {

    pInfo->cbSize = sizeof(DOCHOSTUIINFO);

    pInfo->dwFlags = DOCHOSTUIFLAG_DIALOG | 

                        DOCHOSTUIFLAG_THEME  | 

                        DOCHOSTUIFLAG_NO3DBORDER | 

                        DOCHOSTUIFLAG_SCROLL_NO;

    pInfo->dwDoubleClick = DOCHOSTUIDBLCLK_DEFAULT;

    return S_OK;

    }

    用脚本也可实现: 在Head中加入脚本

    document.onselectstart=new Function(''return false'');

    或者 

    <body onselectstart="return false">。


    其它 

    CLhpHtmlView中还提供了几个函数, 修改网页元素的内容: 

    BOOL PutElementHtml(CString ElemID,CString Html);

    取表单元素的值: 

    BOOL GetElementValue(CString ElemID,CString& Value);

    设置表单元素的值: 

    BOOL PutElementValue(CString ElemID,CString Value);

    给表单元素设置焦点: 

    void ElementSetFocus(CString EleName);

    转载:http://www.vckbase.com/document/viewdoc/?id=1486

    ————————————————————————————————————————————————————————————————

    自定义浏览器

    本教程提供了自定义浏览器控件的行为和外观的一些方法。你将看到高级的宿主接口,IDocHostUIHandler, IDocHostUIHandler2, IDocHostShowUI, 和ICustomDoc。本文也讨论其他自定义方法,例如在宿主的IDispatch实现中处理DISPID_AMBIENT_DLCONTROL来进行下载控制;以及使用IHostDialogHelper。

    本文分为如下章节

    · 前提和需求

    · 介绍

    · 浏览器自定义架构

    · IDocHostUIHandler

    · IDocHostUIHandler2

    · GetOptionKeyPath 和 GetOverrideKeyPath比较

    · 控制导航

    · IDocHostShowUI

    · 控制下载和执行

    · IHostDialogHelper

    · 控制新的窗口

    · 显示证书对话框(New!) 

    · 信息栏(New!)

    · 结论

    前提和需求

    为了理解和使用本教程,你需要

    · 对C++和COM的深入了解

    · 

    · 熟悉活动模板库 (ATL)

    · 

    · 安装了Microsoft(R) Internet Explorer (IE)6 或更高版本

    · 

    · 开发环境具有用于IE6或更高版本的头文件和库文件;特别是Mshtmhst.h.译者注:可以在http://www.microsoft.com/msdownload/platformsdk/sdkupdate/ 这里下载最新的Internet Development SDK

    许多自定义特性是在IE5或者5.5版本就可以使用的,但是有几个特性需要IE6。一些特性需要IE6的Windows XP SP2版本。使用某个特性之前,应该检查参考文档以获得版本信息。

    介绍

    集成浏览器控件是快速软件开发的强有力的工具。通过成为浏览器的宿主,你可以利用便于使用的Dynamic HTML (DHTML), HTML, 和Extensible Markup Language (XML)来显示信息和开发一个用户界面。但是,浏览器控件的行为可能不确切符合你的需求。例如,默认的状态允许用户通过快捷菜单的查看源代码选项查看一个显示的页面的源代码,你可能需要禁用或者干脆去掉这个选项。你可能更进一步,需要用你自己的快捷菜单替换默认的快捷菜单。

    在刚刚提到的自定义特性之外,高级宿主特性允许

    · 在显示的页面上的按钮和其他控件可以调用你的应用程序的内建方法,有效地扩展DHTML对象模型(DOM)。

    · 改变拖放的行为

    · 限制浏览器的导航,例如,限制于指定的页面/域,或者站点

    · 捕获用户键入,并且在需要的时候处理。比如说,你可能需要捕获CTRL+O来阻止用户在新的IE中打开网页而不是使用你的程序打开,

    · 改变默认字体和显示设置

    · 控制下载内容,以及当下载完成之后浏览器的处理。例如,你可能禁用视频的播放,脚本的执行,点击链接时打开新的窗口,或者Microsoft(R) ActiveX 控件的下载和执行。

    · 限制查看源代码

    · 捕获搜索

    · 捕获导航错误

    · 替代/修改快捷菜单或者禁用,替代,自定义,或者添加快捷菜单项

    · 为你的应用程序改变注册表设定

    · 控制和修改浏览器控件显示的消息框

    · 控制新窗口的创建方式

    在下列中,我们将会看到多数,但是不是全部的这些可能性而且讨论该如何实现他们。

    浏览器自定义架构

    介绍 IDocHostUIHandler , IDocHostUIHander2 , IDocHostShowUI 和 ICustomDoc

    下面三个接口是浏览器控件用户界面的自定义核心:IDocHostUIHandler ,IDocHostUIHandler2 和 IDocHostShowUI。当你修改浏览器控件的时候 , 这些是你在你的应用程序中实现的接口。也有一些服务接口。 ICustomDoc 被MSHTML实现并且提供一个方法在某些情况下能够自定义浏览器控件。IHostDialogHelper提供一个方法打开可信对话框,没有像IE对话框那样为他们(译者注:在标题栏上)作标记。

    除了使用这些接口,你还可以做其他件事。一,你能通过在IDispatch实现中拦截环境特性的变化来控制下载其次,你能通过在IDispatch实现中拦截DISPID_NEWWINDOW2控制窗口的创建方式

    译者注:MFC7中的DHTML类,例如CHtmlView和CDHtmlDialog实现了这些接口,但是对于使用其他的类库的程序员,可能需要自己实现这些接口。

    如何工作

    当一个容器提供对ActiveX 控件支持时候 , 浏览器控件自定义机制被设计为被自动化。当浏览器控件被实例化的时候,如果可能的话,它尝试找来自宿主的 IDocHostUIHandler , IDocHostUIHandler2 和 IDocHostShowUI 实现浏览器控件通过调用宿主的IOleClientSite接口的一个QueryInterface方法来查找。

    译者注:IE5.5有个Bug,没有查询IDocHostUIHandler2 接口的实现,这使得宿主程序不能覆盖默认的参数。需要更多信息的话,参考微软知识库文章 Q272968 BUG:IDocHostUIHandler2 没有在浏览器控件中调用。

    这一个结构为一个实现一个IOleClientSite接口的应用程序自动地工作,通过调用浏览器的IOleObject::SetClientSite方法传递给浏览器控件一个IOleClientSite接口。浏览器控件的一个典型的实例化可能看起来像这样:

    例子

    //为了明确起见,省略错误检查

    CComPtr<IOleObject> spOleObj;

    //创建 WebBrowser--类成员变量 m_spWebBrowser中保存指针

    CoCreateInstance(CLSID_WebBrowser, NULLCLSCTX_INPROCIID_IWebBrowser2, (void**)&m_spWebBrowser);

    // 查询WebBrowserIOleObject接口

    m_spWebBrowser->QueryInterface(IID_IOleObject, (void**)&spOleObj);

    //设置用户站点

    spOleObj->SetClientSite(this);

    //本地激活浏览器控件

    RECT rcClient

    GetClientRect(&rcClient);

    spOleObj->DoVerb(OLEIVERB_INPLACEACTIVATENULLthis, 0, GetTopLevelWindow(), &rcClient);

    //容器拦截浏览器事件的注册

    AtlAdvise(m_spWebBrowser,GetUnknown(), DIID_DWebBrowserEvents2,&m_dwCookie);

    //导航到启动页

    m_spWebBrowser->Navigate(L"res://webhost.exe/startpage.htm", NULLNULLNULLNULL);

    然而,如果你的应用程序没有一个IOleClientSite接口,你并没失去全部希望。IE提供ICustomDoc接口,这样你能自己传递你的IDocHostUIHandler接口给浏览器。你不能使用IDocHostUIHandler2和 IDocHostShowUI接口而不提供一个浏览器控件宿主的IOleClientSite接口。

    译者注:

    MFC7中引入的类COleControlContainer和一大堆DHTML类曾经搞得我晕头转向,最后我不得不放弃了自己对IOleClientSite的实现,而通过ICustomDoc来显式地设置IDocHostUIHandler接口。这样必须在第一个页面下载完成之后才能够开始自定义浏览器,因为暴露ICustomDoc接口的对象只有在第一个页面下载完成之后才可用。一个ICustomDoc的示例可以在CSDN文档中心找到,网址是http://www.csdn.net/develop/Read_Article.asp?Id=8813

    当浏览器控件获得了对这些接口之中的任何一个的一个指针的时候,接口的方法在适当的时候在浏览器控件的生命期中被调用。举例来说, 当用户右击在浏览器控件的客户区的任何地点时,在IE显示它的默认快捷菜单之前,你的IDocHostUIHandler::ShowContextMenu的实现将会被调用。这给你一个机会显示你自己的快捷菜单而且取消IE的快捷菜单显示。

    译者注:一些屏蔽快捷菜单的示例可以在CSDN文档中心找到,网址是http://www.csdn.net/develop/article/18/18541.shtm

    当初始化浏览器控件的时候 ,记住几个重点。你的应用程序应该使用 OleInitialize而不是CoInitialize启动COM。OleInitialize启用剪贴簿支持,拖放,对象连接与嵌入(OLE)和本地激活。当你的应用程序结束的时候使用OleUninitialize关闭COM库。

    ATL COM 向导使用 CoInitialize而不是OleInitialize打开COM库。 如果你使用这一个向导建立一个可运行的程序,你需要将 CoInitialize 和 CoUninitialize 调用换成 OleInitialize 和 OleUninitialize。对于一个微软基础类 (MFC) 应用程序, 确定你的应用程序调用 AfxOleInit, 它在它的初始化程序中调用OleInitialize。

    如果你不需要在你的应用程序中支持拖放,你可以调用IWebBrowser2::RegisterAsDropTarget,传递VARIANT_TRUE(译者注:原文如此,按照接口文档,似乎应该传递VARIANT_FALSE), 避免任何在你的浏览器控件实例上的拖放操作。

    一个浏览器控件宿主应用程序也需要IOleInPlaceSite的一个实现, 由于 IOleInPlaceSite派生自IOleWindow,应用程序将需要IOleWindow的一个实现。你需要这些实现使得你的应用程序具有一个窗口,显示浏览器控件,以及处理它的显示设置。

    这些接口和IOleClientSite的实现在许多情况可能是最小的或不存在的。IOleClientSite的所有方法都可以返回E_NOTIMPL。 一些IOleInPlaceSite和IOleWindow的方法需要一个实现来覆盖返回值。可以在示例代码中查看IOleInPlaceSite和IOleWindow的最小实现的样例代码。

    既然我们已经完成了初始化的准备,让我们看一看浏览器控件自定义的每一个接口。

    IDocHostUIHandler

    IDocHostUIHandler自IE5以后已经是可用的。它提供15个方法。大体上,一些较重要的方法是IDocHostUIHandler::GetExternal, IDocHostUIHandler::GetHostInfo, IDocHostUIHandler::GetOptionKeyPath, IDocHostUIHandler::ShowContextMenu, 和 IDocHostUIHandler::TranslateAccelerator。当然,方法对你的重要性将会依赖于你的应用程序。

    IDocHostUIHandler::GetHostInfo

    你使用IDocHostUIHandler::GetHostInfo告诉MSHTML有关你的应用程序的能力和需求。通过它你能控制很多东西, 举例来说。

    · 你能禁用浏览器的3D的边缘。

    · 你能避免滚动条或改变他们的外观

    · 你能禁用脚本

    · 你能定义双击处理的方式

    · 你能禁用浏览器的自动完成功能。

    IDocHostUIHandler::GetHostInfo有一个参数,被 MSHTML分配的DOCHOSTUIINFO 结构的一个指针。你的工作要将结构中填充你传给MSHTML的信息。

    DOCHOSTUIINFO结构有四个成员。第一个成员是 cbSize,是结构的大小。你应该自己像下面的示例代码那样设置。第二个成员是dwFlags,由来自DOCHOSTUIFLAG枚举的数值位与组成。第三成员是dwDoubleClick,来自DOCHOSTUIDBLCLK枚举的一个数值。第四个成员是pchHostCss。你可以将pchHostCss设定为浏览器控件显示的页面中应用的全局样式表(CSS)规则的一个字符串的指针。DOCHOSTUIINFO 的最后一个成员是pchHostNs。你可以设置为你提供的分号分隔的命名空间列表字符串。在你正在浏览器控件中显示的页上使用自定义标签的时候使用这一个成员。这样你能声明一个全局的命名空间列表,而不需要在每个显示声明他们。

    确定使用CoTaskMemAlloc为pchHostCss或pchHostNS分配字符串译者注:看起来调用者用CoTaskMemFree释放这些字符串)。

    例子

    HRESULT GetHostInfo( DOCHOSTUIINFO* pInfo)

    {

        WCHAR* szCSS = L"BODY {background-color:#ffcccc}";

        WCHAR* szNS = L"IE;MyTags;MyTags2='www.microsoft.com'";

        #define CCHMAX 256

        size_t cchLengthCSS,cchLengthszNS;

        HRESULT hr=StringCchLengthW(szCSS, CCHMAX,&cchLengthCSS)

        //TODO: 在这里处理错误。

        OLECHAR* pCSSBuffer=(OLECHAR*) CoTaskMemAlloc((cchLengthCSS+1)*sizeof(OLECHAR));

        //TODO: 在这里处理错误确定内存成功地被分配

        hr=StringCchLengthW(szNS, CCHMAX,&cchLengthszNS)

        //TODO: 在这里处理错误。

        OLECHAR* pNSBuffer=(OLECHAR*) CoTaskMemAlloc((cchLengthszNS+1)*sizeof(OLECHAR));

        //TODO: 在这里处理错误确定内存成功地被分配

        hr=StringCchCopyW(pCSSBuffer , cchLengthCSS+1,szCSS)

        //TODO: 在这里处理错误。

        hr=StringCchCopyW(pNSBuffer , cchLengthszNS+1,szNS)

        //TODO: 在这里处理错误。

        pInfo-> cbSize= sizeof(DOCHOSTUIINFO)

        pInfo-> dwFlags=DOCHOSTUIFLAG_NO3DBORDER|DOCHOSTUIFLAG_SCROLL_NO|DOCHOSTUIFLAG_ENABLE_FORMS_AUTOCOMPLETE;

        pInfo-> dwDoubleClick= DOCHOSTUIDBLCLK_DEFAULT;

        pInfo-> pchHostCss= pCSSBuffer;

        pInfo-> pchHostNS= pNSBuffer;

        return S_OK;

    }

    如果你没有什么需要告诉MSHTML,你可以在这个方法中返回E_NOTIMPL 。

    IDocHostUIHandler::ShowContextMenu

    通过实现这一个方法, 你获得一个用户右击被浏览器控件显示的快捷菜单的控制。你能通过这个方法返回S_OK 阻止IE显示它的默认快捷菜单。返回一些其他的数值 , 像S_FALSE或E_NOTIMPL,允许IE继续执行它的默认快捷菜单行为。

    如果你仅仅在这个方法中返回S_OK, 你能避免任何浏览器控件的右击行为。 这可能是你在许多场合中的全部需求,但是你能做更多。通常,你使用这一个方法在返回 S_OK 之前产生并且显示你自己的快捷菜单。如果你知道浏览器控件显示的菜单的资源,而且它如何选择他们,你能也有效地自定义默认的浏览器控件快捷菜单。让我们看看它如何工作

    浏览器控件由Shdoclc.dll获得它的快捷菜单资源。这个知识和一些 #define给予你一个机会操纵浏览器的菜单。让我们举例来说,假定你对默认菜单感到满意,除了你想要除去查看代码之外。下列代码载入来自Shdoclc.dll的浏览器控件快捷菜单资源,根据环境选择正确的菜单,移除IDM_VIEWSOURCE命令应的菜单项,然后显示菜单

    例子

    HRESULT CBrowserHost::ShowContextMenu(DWORD dwID,

        POINT *ppt,

        IUnknown *pcmdTarget,

        IDispatch *pdispObject)

    {

        #define IDR_BROWSE_CONTEXT_MENU 24641

        #define IDR_FORM_CONTEXT_MENU 24640

        #define SHDVID_GETMIMECSETMENU 27

        #define SHDVID_ADDMENUEXTENSIONS 53

        HRESULT hr;

        HINSTANCE hinstSHDOCLC;

        HWND hwnd;

        HMENU hMenu;

        CComPtr<IOleCommandTarget> spCT;

        CComPtr<IOleWindow> spWnd;

        MENUITEMINFO mii={0};

        CComVariant var, var1, var2;

        hr = pcmdTarget->QueryInterface(IID_IOleCommandTarget, (void**)&spCT);

        hr = pcmdTarget->QueryInterface(IID_IOleWindow, (void**)&spWnd);

        hr = spWnd->GetWindow(&hwnd);

        hinstSHDOCLC = LoadLibrary(TEXT("SHDOCLC.DLL"));

        if (hinstSHDOCLC == NULL)

        {

            // 载入模块错误 -- 尽可能安全地失败

            return;

        }

        hMenu=LoadMenu(hinstSHDOCLC,

            MAKEINTRESOURCE(IDR_BROWSE_CONTEXT_MENU));

        hMenu=GetSubMenu(hMenu,dwID);

        //获得语言子菜单

        hr = spCT->Exec(&CGID_ShellDocViewSHDVID_GETMIMECSETMENU, 0, NULL, &var);

        mii.cbSize = sizeof(mii);

        mii.fMask = MIIM_SUBMENU;

        mii.hSubMenu = (HMENU) var.byref;

        //加入语言子菜单到编码上下文菜单

        SetMenuItemInfo(hMenu, IDM_LANGUAGE, FALSE, &mii);

        //插入来自注册表的快捷菜单扩展

        V_VT(&var1) = VT_INT_PTR;

        V_BYREF(&var1) = hMenu;

        V_VT(&var2) = VT_I4;

        V_I4(&var2) = dwID;

        hr = spCT->Exec(&CGID_ShellDocViewSHDVID_ADDMENUEXTENSIONS, 0, &var1, &var2);

        //删除查看源代码

        DeleteMenu(hMenu, IDM_VIEWSOURCE, MF_BYCOMMAND);

        //显示快捷菜单

        int iSelection = ::TrackPopupMenu(hMenu,

            TPM_LEFTALIGN | TPM_RIGHTBUTTON | TPM_RETURNCMD,

            ppt->x,

            ppt->y,

            0,

            hwnd,

            (RECT*)NULL);

        //发送选定的快捷菜单项目指令到外

        LRESULT lr = ::SendMessage(hwnd, WM_COMMAND, iSelection, NULL);

        FreeLibrary(hinstSHDOCLC);

        return S_OK;

    }

    安全警告不正确地使用LoadLibrary能载入错误的动态链接库(DLL)来威胁你的应用程序的安全关于该如何正确地用微软Windows 的不同版本载入DLL的信息,参照LoadLibrary的文档

    IDocHostUIHandler::GetExternal: 扩充文档对象模型

    IDocHostUIHandler 提供一个让你用在你自己的应用程序中实现你自己的对象,方法和特性扩充IE文档对象模型 (DOM)的方法。你的实现是提供给MSHTML一个IDispatch接口指针,指向你自定义的COM自动化对象,实现你自定义的对象、属性和方法。这些对象,特性和方法之后可以在浏览器控件显示的任何页面中通过文档的外部对象访问

    这一个方法的实现可以是非常简单的, 假定你的IDispatch接口在实现IDocHostUIHandler的相同对象上。

    HRESULT CBrowserHost::GetExternal(IDispatch **ppDispatch)

    {

        *ppDispatch = this;

        return S_OK;

    }

    只要 MSHTML有对你的 IDispatch 的一个指针,MSHTML将会传递网页上对任何外部对象的调用你的应用程序的自动化方法:

    <SCRIPT language="JScript">

    function MyFunc(iSomeData)

    {

        external.MyCustomMethod("Some text", iSomeData);

    }

    </SCRIPT>

    你也能使用这技术传递整个对象一个页。为了实现它,在你的IDispatch实现中创建一个方法,传递回你的网页可以用的对象。

    <SCRIPT language="JScript">

    function MyFunc(iSomeData)

    {

        var oCustCalendarObj;

        external.GetCustomCalender(oCustCalenderObj);

        oCustCalerdarObj.doStuffWithIt();

    }

    </SCRIPT>

    可以看看示例代码中使用 ATLIDispatch自动化实现的一个例子 。

    译者注:IE也扩展了浏览器的文档对象模型,使得你在脚本中可以通过扩展对象menuArguments属性访问当前窗口对象。

    IDocHostUIHandler::GetOptionKeyPath

    IDocHostUIHandler::GetOptionKeyPath是自定义浏览器控件的一个非常有力的工具。 许多浏览器控件显示行为设定被储存在注册表中HKEY_CURRENT_USER键的下面。IDocHostUIHandler::GetOptionKeyPath给你一个机会为你的浏览器控件的特定实例覆盖这些注册表设定。它通过提供一个替代的注册表位置来实现,浏览器控件将会在这里读取注册表设置

    IDocHostUIHandler::GetOptionKeyPath的一个实现传递给浏览器控件读取注册表设置的位置的一个字符串。浏览器控件将会找寻在HKEY_CURRENT_USER键下面的这一个键。

    例子

    HRESULT CBrowserHost::GetOptionKeyPath(LPOLESTR *pchKey,

        DWORD dwReserved)

    {

        HRESULT hr;

        #define CCHMAX 256

        size_t cchLength;

        if (pchKey)

        {

            WCHAR* szMyKey = L"Software\MyCompany\MyApp";

            hr = StringCchLengthW(szMyKey, CCHMAX, &cchLength);

            //TODO: 在这里处理错误。

            *pchKey = (LPOLESTR)CoTaskMemAlloc((cchLength + 1) * sizeof(WCHAR));

            if (*pchKey)

                hr = StringCchCopyW(*pchKey, cchLength + 1, szKey);

            //TODO: 在这里处理错误。

            hr = (*pchKey) ? S_OK : E_OUTOFMEMORY;

        }

        else

            hr = E_INVALIDARG;

        return hr;

    }

    IDocHostUIHandler::GetHostInfo一样,确保为你的字符串使用 CoTaskMemAlloc分配内存。

    告诉浏览器控件该哪里找寻你的注册表设置实际上是第一步——就程序运行来说第二步。 你的程序必须在被IDocHostUIHandler::GetOptionKeyPath告诉的位置设置一个注册表,这样浏览器控件才可以去读取。有多种方法来完成这个步骤一个方法是当应用程序被安装的时候执行一个注册表脚本。另外的一个方法当应用程序启动的时候,用代码来完成。这里是改变默认值字体,大小和颜色的一个设定。

    例子

    HRESULT SetSomeKeys()

    {

        HKEY hKey = NULL;

        HKEY hKey2 = NULL;

        HKEY hKey3 = NULL;

        DWORD dwDisposition = NULL;

        LONG lResult = NULL;

        #define CBMAX 256

        size_t cbLength;

        RegCreateKeyEx(HKEY_CURRENT_USER, _T("Software\MyCompany\MyApp"),

            NULLNULLREG_OPTION_NON_VOLATILEKEY_SET_VALUE,

            NULL, &hKey, &dwDisposition);

        RegCreateKeyEx(hKey, _T("Main"), NULLNULLREG_OPTION_NON_VOLATILE,

            KEY_SET_VALUENULL, &hKey2, &dwDisposition);

        RegSetValueEx(hKey2, _T("Use_DlgBox_Colors"), NULLREG_SZ,

            (CONST BYTE*)_T("no"), sizeof(_T("no")));

        RegCloseKey(hKey2);

        RegCreateKeyEx(hKey, _T("Settings"), NULLNULLREG_OPTION_NON_VOLATILE,

            KEY_SET_VALUENULL, &hKey2, &dwDisposition);

        RegSetValueEx(hKey2, _T("Anchor Color"), NULLREG_SZ,

            (CONST BYTE*)_T("0,255,255"), sizeof(_T("0,255,255")));

        RegSetValueEx(hKey2, _T("Text Color"), NULLREG_SZ,

            (CONST BYTE*)_T("255,0,255"), sizeof(_T("255,0,255")));

        RegCloseKey(hKey2);

        RegCreateKeyEx(hKey, _T("International\Scripts"), NULLNULL,

            REG_OPTION_NON_VOLATILEKEY_SET_VALUENULL,

            &hKey2, &dwDisposition);

        BYTE bDefaultScript = 0x3;

        RegSetValueEx(hKey2, _T("Default_Script"), NULLREG_BINARY,

            &bDefaultScript, sizeof(bDefaultScript));

        RegCreateKeyEx(hKey2, _T("3"), NULLNULLREG_OPTION_NON_VOLATILE,

            KEY_SET_VALUENULL, &hKey3, &dwDisposition);

        BYTE bSize = 0x4; // Value from 0 - 4. 2 is medium.

        TCHAR* szFontName = _T("Comic Sans MS");

        TCHAR* szFixedFontName = _T("Courier");

        HRESULT hr = StringCbLength(szFontName, CBMAX, &cbLength);

        //TODO: 在这里处理错误。

        RegSetValueEx(hKey3, _T("IEPropFontName"), NULLREG_SZ,

            (CONST BYTE*)szFontName, cbLength + sizeof(TCHAR));

        hr = StringCbLength(szFixedFontName, CBMAX, &cbLength);

        //TODO: 在这里处理错误。

        RegSetValueEx(hKey3, _T("IEFixedFontName"), NULLREG_SZ,

            (CONST BYTE*)szFixedFontName, cbLength + sizeof(TCHAR));

        RegSetValueEx(hKey3, _T("IEFontSize"), NULLREG_BINARY, &bSize, sizeof(bSize));

        RegCloseKey(hKey3);

        RegCloseKey(hKey2);

        RegCloseKey(hKey);

        return S_OK;

    }

    IDocHostUIHandler2

    IDocHostUIHandler2 只有一个方法,IDocHostUIHandler2::GetOverrideKeyPath。它运行非常类似于IDocHostUIHandler::GetOptionKeyPath的一个功能。它指出你修改自默认注册表设置的集成浏览器使用的注册表设置的位置。IDocHostUIHandler2::GetOverrideKeyPath 的一个实现看起来会很类似于IDocHostUIHandler::GetOptionKeyPath的一个实现。

    GetOptionKeyPath 和 GetOverrideKeyPath 的比较

    你或许没看到IDocHostUIHandler::GetOptionKeyPath和IDocHostUIHandler2::GetOverrideKeyPath之间的任何不同。在他们之间的不同是微妙的, 但是重要的。如果你实现 IDocHostUIHandler::GetOptionKeyPath,你的浏览器控件实例将会忽略任何IE用户设定。这些设定被储存在注册表HKEY_CURRENT_USER/Software/Microsoft/Internet Explorer下面。如果你实现IDocHostUIHandler2::GetOverrideKeyPath,你的浏览器控件实例将会合并任何的用户设定—字体设定,菜单扩展,诸如此类——到显示和行为中

    举例说明在IDocHostUIHandler::GetOptionKeyPath和IDocHostUIHandler2::GetOverrideKeyPath之间的不同,让我们重新看看IDocHostUIHandler::ShowContextMenu那段的示例代码记住这一行:

    spCT->Exec(&CGID_ShellDocView, SHDVID_ADDMENUEXTENSIONS, 0, &var1, &var2);

    如果你已经实现IDocHostUIHandler::GetOptionKeyPath,因为菜单扩展信息被储存在当前用户的注册表信息中,所以这一加入任何自定义项目到快捷菜单。如果你已经实现IDocHostUIHandler2::GetOverrideKeyPath, 这一个添加在HKEY_CURRENT_USER/Software/Microsoft/Internet Explorer/MenuExt面定义的任何目前用户定义的菜单扩展, 除非你明确地在你的自定义注册信息位置提供一个空的或替代的MenuExt键。

    控制导航

    你可能想知道在IDocHostUIHandler那一节为什么不提到 IDocHostUIHandler::TranslateUrl,作为希望制页面导航实现方法。原因是这一个方法不是控制导航通用的技术。 除非你直接地集成MSHTML,这一个方法将没有控制导航的效果。作为替代,通过实现IDispatch::Invoke,处理DISPID_BEFORENAVIGATE2,你可以控制导航。例如,下列代码避免导航一个特别的网址,如果使用者尝试这么做,会显示 "没有允许导航" 错误页。

    例子

    case DISPID_BEFORENAVIGATE2:

    {

        CComBSTR url = ((*pDispParams).rgvarg)[5].pvarVal->bstrVal;

        if (url == "http://www.adatum.com" || url == "http://www.adatum.com/")

        {

            CComPtr<IWebBrowser2> spBrowser;

            CComPtr<IDispatch> spDisp = ((*pDispParams).rgvarg)[6].pdispVal;

            spDisp->QueryInterface(IID_IWebBrowser2, (void**)&spBrowser);

            spBrowser->Stop();

            CComBSTR newURL = "L"res://webhost.exe/nonavigate.htm";

            spBrowser->Navigate(newURL, NULLNULLNULLNULL);

            ((*pDispParams).rgvarg)[0].boolVal = TRUE;

        }

        break;

    }

    IDocHostShowUI

    这个接口给你对浏览器控件显示信息对话框和帮助的控制。它工作机理和IDocHostUIHandler和IDocHostUIHandler2一样,你实现它,这样在浏览器控件显示它自己的任何的信息或帮助之前 ,能调用你的IDocHostShowUI方法。这给你一个机会阻止浏览器控件显示任何东西,而且使你能够改为显示你自己的自定义信息或帮助。 IDocHostShowUI有两个方法,IDocHostShowUI::ShowMessage和IDocHostShowUI::ShowHelp。

    IDocHostShowUI::ShowMessage

    返回 S_OK禁用浏览器控件信息对话框。任何其他的返回数值,像S_FALSE或E_NOTIMPL,允许浏览器控件显示它的信息对话框

    通过这个方法能做的一件事情是为你的应用程序自定义信息框标题,替代 "Microsoft Internet Explorer" 。你能通过比较lpstrCaption和储存在Shdoclc.dll中的IE使用的字符串资源来完成它。它的ID是IDS_MESSAGE_BOX_TITLE,数值是2213。下列示例代码演示你可能需要做的工作

    例子

    HRESULT CBrowserHost::ShowMessage(HWND hwnd,

        LPOLESTR lpstrText,

        LPOLESTR lpstrCaption,

        DWORD dwType,

        LPOLESTR lpstrHelpFile,

        DWORD dwHelpContext,

        LRESULT *plResult)

    {

        USES_CONVERSION;

        TCHAR pBuffer[50];

        // 窗口标题"Microsoft Internet Explorer"的资源标识

        #define IDS_MESSAGE_BOX_TITLE 2213

        //载入Shdoclc.dll IE消息框标题字符串

        HINSTANCE hinstSHDOCLC = LoadLibrary(TEXT("SHDOCLC.DLL"));

        if (hinstSHDOCLC == NULL)

        {

            // 载入模块错误 -- 尽可能安全地失败

            return;

        }

        LoadString(hinstSHDOCLC, IDS_MESSAGE_BOX_TITLE, pBuffer, 50);

        // 比较IE消息框标题字符串和lpstrCaption

        // 如果相同,用自定义标题替换

        if (_tcscmp(OLE2T(lpstrCaption), pBuffer) == 0)

            lpstrCaption = L"Custom Caption";

        // 创建自己的消息框并且显示

            *plResult = MessageBox(OLE2T(lpstrText), OLE2T(lpstrCaption), dwType);

        //卸载Shdoclc.dll并且返回

        FreeLibrary(hinstSHDOCLC);

        return S_OK;

    }

    安全警告不正确地使用LoadLibrary能载入错误的动态链接库(DLL)来威胁你的应用程序的安全关于该如何正确地用微软Windows的不同版本载入DLL的信息,参照 LoadLibrary的文档

    IDocHostShowUI::ShowHelp

    这一个方法当IE需要显示帮助时被调用,举例来说当 F1 键被按下时,而且工作方式和IDocHostShowUI::ShowMessage类似。返回S_OK覆盖IE的帮助,或另外的HRESULT值IE执行自己的帮助

    控制下载和执行

    浏览器控件给你它下载,显示设置和执行的控制。 为了要得到这控制,你实现你的宿主的IDispatch接口,使得它处理DISPID_AMBIENT_DLCONTROL。当浏览器控件被实例化的时候,它将会以这一个ID调用你的IDispatch::Invoke。将pvarResult设置为下列的标识的一个位与的组合,指明你的配置

    · DLCTL_DLIMAGES , DLCTL_VIDEOS 和 DLCTL_BGSOUNDS: 如果这些标识被设定图像,视频背景音乐将会被从服务器下载并且显示或播放,否则将不被下载显示。

    · DLCTL_NO_SCRIPTS 和 DLCTL_NO_JAVA: 脚本Java程序将不被运行。

    · DLCTL_NO_DLACTIVEXCTLS 和 DLCTL_NO_RUNACTIVEXCTLS: ActiveX 控件将不被下载或者运行。

    · DLCTL_DOWNLOADONLY: 网页只将会被下载,不显示。

    · DLCTL_NO_FRAMEDOWNLOAD:浏览器控件将会下载并且解析框架集页面,但是不会下载和解析框架集中单独的框架。

    · DLCTL_RESYNCHRONIZE 和 DLCTL_PRAGMA_NO_CACHE: 这些标志导致Internet缓冲的刷新。通过 DLCTL_RESYNCHRONIZE,服务器将会被请求更新状态。如果服务器指出缓存信息是最新的,将会使用 缓存文件。通过DLCTL_PRAGMA_NO_CACHE,不管文件的更新状态如何,文件都会被从服务器重新下载。

    · DLCTL_NO_BEHAVIORS: 行为不被下载并且在文件中被禁用。

    · DLCTL_NO_METACHARSET_HTML: 忽略META元素中指明的字符集

    · DLCTL_URL_ENCODING_DISABLE_UTF8 和 DLCTL_URL_ENCODING_ENABLE_UTF8: 这些标志的功能类似于IDocHostUIHandler::GetHostInfo使用DOCHOSTUIFLAG_URL_ENCODING_DISABLE_UTF8DOCHOSTUIFLAG_URL_ENCODING_ENABLE_UTF8标志。不同是只有浏览器控件被初始化的时候,DOCHOSTUIFLAG标志才会被检查。这里的环境特性变化下载标志每当浏览器控件需要运行一个下载被检查。

    · DLCTL_NO_CLIENTPULL: 不运行客户端重定位页面操作(译者注:例如<meta http-equiv="refresh" content="30"> 的默认行为)

    · DLCTL_SILENT: 在下载期间没有用户界面显示。

    · DLCTL_FORCEOFFLINE: 浏览器控件总是在脱机模式中操作。

    · DLCTL_OFFLINEIFNOTCONNECTED 和 DLCTL_OFFLINE: 这些标志是相同的。如果不连接到英特网浏览器控件将会在脱机模式中操作。

    DISPID_AMBIENT_DLCONTROL和标志数值在mshtmdid.h被定义

    最初,当对IDispatch::Invoke调用开始的时候, pvarResult参数指向的VARIANTVT_EMPTY类型。 你必须为任何有效的设定设置它为VT_I4类型。你可以在VARIANT的lVal成员中存储标志数值。

    大部份标志数值有否定的效果,也就是说,他们避免行为正常地发生。举例来说,如果你自定义浏览器控件行为,那么通常脚本会被执行。 但是如果你设定DLCTL_NOSCRIPTS 标志,脚本将不会在控制的那个实例中运行。然而,三标志— DLCTL_DLIMAGES , DLCTL_VIDEOS 和 DLCTL_BGSOUNDS的作用正好相反。你必须全部设置标志,使得浏览器控件以它的默认行为执行关于图像,视频和声音的处理。

    下列示例代码使得一个浏览器控件实例下载并且显示图像和视频,但是不处理背景音乐,因为DLCTL_BGSOUNDS没有被明确地设定。浏览器控件显示的页上脚本运行被禁用

    STDMETHODIMP CAtlBrCon::Invoke(DISPID dispidMember, REFIID riid,

        LCID lcid, WORD wFlags,

        DISPPARAMS* pDispParams,

        VARIANT* pvarResult,

        EXCEPINFO* pExcepInfo,

        UINT* puArgErr)

    {

        switch (dispidMember)

        {

            case DISPID_AMBIENT_DLCONTROL:

                pvarResult->vt = VT_I4;

                pvarResult->lVal = DLCTL_DLIMAGES | DLCTL_VIDEOS | DLCTL_NO_SCRIPTS;

                break;

            default:

                return DISP_E_MEMBERNOTFOUND;

        }

        return S_OK;

    }

    IHostDialogHelper

    IHostDialogHelper是一个你能根据你的爱好创建对话框的接口。这一个接口有一个方法,IHostDialogHelper::ShowHTMLDialog。这一个方法提供如同功能ShowHTMLDialog一般的服务,但是使用起来稍微比较容易一点

    为了要使用IHostDialogHelper,你从头产生对话框辅助对象。在这里是你使用CoCreateInstance的方式创建它。接口和ID在 mshtmhst.h 被定义。

    例子

    IHostDialogHelper* pHDH;

    IMoniker* pUrlMoniker;

    BSTR bstrOptions = SysAllocString(L"dialogHeight:30;dialogWidth:40");

    BSTR bstrPath = SysAllocString(L"c:\dialog.htm");

    CreateURLMoniker(NULL, bstrPath, &pUrlMoniker);

    // 创建对话框辅助对象

    CoCreateInstance(CLSID_HostDialogHelper,

        NULL,

        CLSCTX_INPROC,

        IID_IHostDialogHelper,

        (void**)&pHDH);

    //调用ShowHTMLDialog 创建对话框

    pHDH->ShowHTMLDialog(NULL,

        pUrlMoniker,

        NULL,

        bstrOptions,

        NULL,

        NULL);

    //释放资源

    SysFreeString(bstrPath);

    SysFreeString(bstrOptions);

    pUrlMoniker->Release();

    pHDH->Release();

    译者注:如果要使用对话框来获得用户输入,你可能需要传递两个参数到ShowHTMLDialog。关于ShowHTMLDialog参数的说明,参见Platform SDK文档。ShowHTMLDialog和ShowHTMLDialogEx 似乎一直是MSHTML.DLL导出的两个函数,微软把它封装为接口,可能是在为未来的兼容性作准备。

    控制新的窗口

    控制浏览器控件的一个重要的方法控制导航。你在前面已经看如何在IDispatch::Invoke中拦截DISPID_BEFORENAVIGATE2实现控制你的浏览器控件导航位置。另外一个导航的重要的方面要控制导航发生方式, 尤其打开新的窗口的时候。让我们举例来说, 使用者右击一个链接,选择 "在新窗囗中打开" 或一页包含像这样的脚本:

    window.open("www.msn.com")

    默认地,浏览器控件行代码的处理通过打开IE的一个新的实例来显示页。这可能正好是你的应用程序需要的但是也可能不是。也许你需要在当前的浏览器控件实例中打开所有链接,你将在你控制下的浏览器控件的一个新的实例——具有你的用户界面和你的商标——打开链接

    可以在你的IDispatch实现中拦截一个事件——DWebBrowserEvents2::NewWindow2——来控制。你的控制需要连接到DWebBrowserEvents2连接点拦截这一个事件。

    你连接到DWebBrowserEvents2之后,实现你的IDispatch::Invoke以处理 DISPID_NEWWINDOW2。在为DISPID_NEWWINDOW2IDispatch::Invoke函数调用中,数组pDispParams包含两个参数。第一个,序号是零, 是一个布尔类型的数值,告诉浏览器控件是否取消新的窗囗。默认它是假值,而且将会打开一个新的窗囗。如果你要完全取消新窗囗的创建, 设定标志到真值。

    序号为一的参数是一个IDispatch接口的指针。你可以将这一个参数设定为你已经创建的浏览器控件的IDispatch。当你传回这样一个IDispatch之后,MSHTML将会使用你给出的控件打开链接

    译者注:MFC中的DHTML类和类向导默认支持这个事件。需要更多信息的话,参见MSJ1998年7月份的文章Keeping an Eye on Your Browser by Monitoring Internet Explorer 4.0 Events,以及 微软知识库文章 Q184876 HOWTO: Use the WebBrowser Control NewWindow2 Event

    显示一个正数对话框

    IE6或者更高版本中,你可以在用户浏览一个合法的安全超文本传输协议(HTTPS)站点的时候显示证书对话框。这和用户点击IE中的锁图标效果相同。你可以通过 DWebBrowserEvents2::SetSecureLockIcon事件来显示你自己的图标。

    #define SHDVID_SSLSTATUS 33

    IOleCommandTarget *pct;

    if (SUCCEEDED(pWebBrowser2->QueryInterface(IID_IOleCommandTarget, (void **) &pct)))

    {

       pct->Exec(&CGID_ShellDocView, SHDVID_SSLSTATUS, 0, NULL, NULL);

       pct->Release();

    }

    信息栏

    Windows XP SP2 中的Internet Explorer 6 引入了一个新的安全用户界面元素,称为信息栏。在特定操作被阻止的时候,信息栏给用户显示一个用户界面元素。特别的,它会在以下操作被阻止的时候显示。

    · 弹出窗口初始化(参见 弹出窗口杀手)

    · 

    · 文件下载 (see 文件下载的限制)

    · 

    · 安装ActiveX 控件(see ActiveX 的限制)

    · 

    · ActiveX控件安全提示的原因是用户安全设置或者是控件未标记为脚本安全的。

    · 

    · 文件的扩展名和多用途因特网邮件扩展类型(MIME)不符的(参见 MIME 处理)

    · 

    · 网络协议锁死的内容(参见 协议)

    · 

    信息栏是Windows XP SP2 中的Internet Explorer 6引入的安全特性之一。和其他安全特性控制一样,可以通过一个注册表键来控制:(FEATURE_SECURITYBAND). 默认情况下IE(iexplorer.exe) 和Windows 资源管理器(explorer.exe) 在这个安全特性控制下。下面显示注册表键和启用过程:

    HKEY_LOCAL_MACHINE (or HKEY_CURRENT_USER)

    SOFTWARE

    Microsoft

    Internet Explorer

    Main

    FeatureControl

    FEATURE_SECURITYBAND

    iexplorer.exe= 0x00000001

    explorer.exe= 0x00000001

    process name.exe=0x00000001

    这个FEATURE_SECURITYBAND 安全特性控制影响IE是否显示信息栏,信息栏在一个操作被阻止的时候提示用户。它不控制操作的阻止过程。

    一个集成浏览器控件的程序可以通过将其进程添加到这个注册表键来启用信息栏。这可以通过调用CoInternetSetFeatureEnabled函数来在运行时执行。如果一个应用程序并未在这个安全特性控制下,那么浏览器控件的行为和Internet Explorer 6 SP1b中的一样.

    没有方法通过脚本来访问这个特性。

    在FEATURE_SECURITYBAND及相关安全特性控制下的应用程序可以使用信息栏应用程序编程接口(API)来在一个URL 操作被禁止时自定义显示的用户界面。为信息栏引入了很多新的OLECMDID命令。头三个是属于CGID_DocHostCommandHandler组。宿主应用程序应该在它们的IDocHostUIHandler实现的同一个对象中实现IOleCommandTarget ,以接受来自浏览器控件IOleCommandTarget::Exec调用。

    · OLECMDID_PAGEACTIONBLOCKED

    · 

    · OLECMDID_PAGEACTIONUIQUERY

    · 

    · OLECMDID_FOCUSVIEWCONTROLS

    · 

    宿主应用程序可以使用下面两个新的OLECMDID 命令来执行浏览器控件IOleCommandTarget::Exec调用。

    · OLECMDID_FOCUSVIEWCONTROLSQUERY

    · 

    · OLECMDID_SHOWPAGEACTIONMENU

    · 

    这个示例使用IWebBrowser2::ExecWB 来执行OLECMDID_SHOWPAGEACTIONMENU 命令。

       POINT pt = { 0 };

       GetCursorPos(&pt);

       CComVariant varHwnd((LONG)hwnd);

       CComVariant varX(pt.x);

       CComVariant varY(pt.y);

       SAFEARRAY* psa = SafeArrayCreateVector(VT_VARIANT, 0, 3);

       LONG lIndex = 0;

       SafeArrayPutElement(psa, &lIndex, &varHwnd);

       lIndex++;

       SafeArrayPutElement(psa, &lIndex, &varX);

       lIndex++;

       SafeArrayPutElement(psa, &lIndex, &varY);

       CComVariant varArgIn;

       V_VT(&varArgIn) = VT_ARRAY | VT_I4;

       V_ARRAY(&varArgIn) = psa;

       pBrowser->ExecWB(OLECMDID_SHOWPAGEACTIONMENU, (OLECMDEXECOPT)dwPageActionFlags, &varArgIn, NULL);

    另外,应用程序可以实现IInternetSecurityManager来重载默认的安全区域设置,参见创建一个自定义URL安全管理器以获得更多信息.

    结论

    你现在有许多技术,可以根据你的处理来自定义浏览器控件。这个文章决不是没有遗漏的,但是希望现在可以自行发现超越本文的技术。检查IE注册表设置中那些你可以用IDocHostUIHandler::GetOptionKeyPath或IDocHostUIHandler2::GetOverrideKeyPath修改的信息。记住许多注册表设置相互依赖。你可能必须做一些实验发现注册表设置可以多么的有效地自定义;如果需要控制浏览器控件的拖放行为,你也可以去看看IDocHostUIHandler::GetDropTarget。

    C# WinForm WebBrowser (讨厌的问题 

    WebBrowse 编辑模式 中几个讨厌的问题:

    1、当设置DocumentText属性值时会一直弹出一个可恶的保存对话框

    现我已知的较好的策略有:
    1)在设置两个DocumentText属性值之间使用webBrowser1.Document.OpenNew(true)方法,但这个方法会引发一些问题。详细内容见下。
    2)在设置DocumentText属性之前将编辑模式改为浏览模式,设置完后再将浏览模式改为编辑模式。


    2、监控Html内容的改变。

    监控 WebBrowser 控件内容的改变


    3WebBrowseMouse事件。

    WebBrowse本身没有Mouse的相关事件,但是我们可以借助WebBrowse中的Body元素来模拟一些简单的相关事件。

    //WinForm中注册Web事件
    //假设HTML源代码如下:
    <html> 
    < body> 
    < input type="button" id="btnClose" value="关闭" /> 
    < /body> 
    < /html>
     
    // WinForm中注册Web事件
    HtmlDocument htmlDoc = webBrowser.Document; 
    HtmlElement btnElement = htmlDoc.All["btnClose"]; 
    if (btnElement != null

        btnElement.click += new HtmlElementEventHandler(HtmlBtnClose_Click); 
    }

    WebBrowse中更多的实用方法参见:C#WinForm WebBrowser (实用方法总结


    4webBrowser1.Document.OpenNew(true)Bug

    相关链接:
    1追踪导致 WebBrowser控件 编辑模式下 Ctrl + Z 失效的原因 【求大侠佐证,这算不算是微软的Bug呢?】

    追踪导致 WebBrowser控件 编辑模式下 Ctrl + Z 失效的原因 【求大侠佐证,这算不算是微软的Bug呢?】 


    导致Ctrl  + Z失效的原因由以下2点连锁引发而导致:

    1、为了解决 WebBrowser 控件导航时弹出保存对话框,使用了 this.webBrowser.Document.OpenNew(true); // 防止 弹出保存对话框, 该方法指示新的文本改变将会在新窗口中打开。

    2、 由原因1导致 webBrowser 控件的编辑模式失效, 表面上看上去还是可以编辑的,但实际上新窗口内部已经不支持编辑了。

    注:这里涉及到了WebBrowser控件的特殊性,它是由三层控件嵌套而成的,外面的两层是大概负责容器、 及 响应用户操作的, 而最内层的则是承载HTML标记,并通过渲染引擎展示HTML内容。用黑盒测试的方法推断,当使用webBrowser.Document.OpenNew(true);  方法时,最内层控件应该是一个新的实例, 表面上看上去还是可以编辑的,但实际上内部的新窗口已经不支持编辑了,进而导致了Ctrl + Z的失效!

    测试代码如下:

    public partial class FrmTest : Form
    {
    // 界面上有一个WebBrowser 和 4Button

    private string strUrl = "http://www.cnblogs.com/08shiyan";

    public FrmTest()
    {
    InitializeComponent();
    }

    /// <summary>
    /// 编辑模式
    /// </summary>
    public void EditMode()
    {
    if (this.webBrowser1.Document != null)
    {
    mshtml.IHTMLDocument2 doc = this.webBrowser1.Document.DomDocument as mshtml.IHTMLDocument2;
    doc.designMode = "on";
    }
    }

    /// <summary>
    /// 启用浏览模式
    /// </summary>
    public void BrowseMode()
    {
    if (this.webBrowser1.Document != null)
    {
    mshtml.IHTMLDocument2 doc = this.webBrowser1.Document.DomDocument as mshtml.IHTMLDocument2;
    doc.designMode = "off";
    }
    }

    // 请确保该按钮是应用程序启动后第一次被点击
    private void button1_Click(object sender, EventArgs e)
    {
    this.webBrowser1.DocumentText = string.Empty;
    this.webBrowser1.Document.Write(string.Format("<BODY>{0}我的誓言博客2</BODY>"this.strUrl));
    this.EditMode();

    this.webBrowser1.Document.OpenNew(true);
    this.webBrowser1.Document.Write(string.Format("<BODY>{0}我的誓言博客2</BODY>"this.strUrl));

    // 注意此时Ctrl + Z 撤销操作将会失效
    }

    // 请确保该按钮是应用程序启动后第一次被点击
    private void button2_Click(object sender, EventArgs e)
    {
    this.webBrowser1.DocumentText = string.Empty;
    this.webBrowser1.Document.Write(string.Format("<BODY>{0}我的誓言博客2</BODY>"this.strUrl));
    this.EditMode();

    this.webBrowser1.Document.OpenNew(true);
    this.webBrowser1.Document.Write(string.Format("<BODY>{0}我的誓言博客2</BODY>"this.strUrl));

    this.EditMode(); // button1的差别是再次启用编辑模式 // 注意此时Ctrl + Z 撤销操作也会失效
    }

    // 请确保该按钮是应用程序启动后第一次被点击
    private void button3_Click(object sender, EventArgs e)
    {
    this.webBrowser1.DocumentText = string.Empty;
    this.webBrowser1.Document.Write(string.Format("<BODY>{0}我的誓言博客2</BODY>"this.strUrl));
    this.EditMode();

    this.webBrowser1.Document.OpenNew(true);
    this.webBrowser1.Document.Write(string.Format("<BODY>{0}我的誓言博客2</BODY>"this.strUrl));

    this.BrowseMode(); // button2 的区别是 先关闭编辑模式,再启用编辑模式
    this.EditMode();

    // 此时 Ctrl + Z 可以使用
    }

    // 重启应用程序
    private void button4_Click(object sender, EventArgs e)
    {
    Application.Restart();
    }

    }

    根据以上得出结论:
    编辑模式下: this.webBrowser.Document.OpenNew(true); 方法会打开一个新的内部窗口,而新窗口中编辑模式出现问题,导致Ctrl + Z ,Ctrl +Y操作失效。 此时 需要先关闭 编辑模式” 然后再打开编辑模式” Ctrl + Z, Ctrl +Y 才能正常使用。

    求佐证。。。

    原创 转载请标明出处: http://www.cnblogs.com/08shiyan

    2http://topic.csdn.net/u/20110318/14/e3744686-3dae-4152-a1d8-c0011e8f355c.html



    更多的关于WebBrowse的问题。


    From:http://blog.csdn.net/xjj800211/article/details/7814196

    展开全文
  • android源生Browser分析---APP层基本架构

    千次阅读 2018-12-07 18:55:07
    App层的功能主要分几块: 使用WebView的浏览器页面主体 除WebView之外的UI ...BrowserActivity继承自Activity,提供了对Browser应用生命周期的控制,事件的入口。这里的事件包括Key的事件,菜单的...

    App层的功能主要分几块:

    使用WebView的浏览器页面主体

    除WebView之外的UI

    页面的相关功能,如页内查找,前进,后退

    设置

    事件

    多窗口管理

    书签/历史记录

     

    首先看构成主体框架的几个类

    BrowserActivity

    BrowserActivity继承自Activity,提供了对Browser应用生命周期的控制,事件的入口。这里的事件包括Key的事件,菜单的事件等。

    BrowserActivity创建了Controller(用于控制)和UI(用于显示)这两个核心类的对象。

    BrowserActivity中接收到的事件等信息都传递给Controller,由Controller来做具体的处理。这样BrowserActivity其实负责很轻松的工作,就是创建和传递。这里可以把BrowserActivity当做一个外界的信息源来看待,而把UI和Controller的组合当做真正的主体看待。

     

    主界面

    浏览页面的主界面由接口类UI来定义对外的接口,由UI的实现类BaseUI来实现基本的功能,由BaseUI的继承类PhoneUI和XLargeUI来分别实现Phone和Pad的特殊UI界面。

    Controller中有UI的引用,UI定义的接口主要就是提供给Controller,供Controller控制UI。即Controller只能通过UI提供的这些有限的接口来控制主界面。

    这样看主界面的控制并不繁琐,通过UI这个接口把界面的实现和界面的控制给分离开了。

    BaseUI是实现UI接口的类。BaseUI提供了主界面的实现。这里的主界面是指浏览网页的界面,不包含书签,设置等页面。

    PhoneUI和XLargeUI继承自BaseUI。他们对BaseUI的一些功能做了扩展,实际上BaseUI对一些函数做了空实现,由其继承类再做具体的实现。

    BaseUI主要由两部分界面组成,一个是上面的TitleBar,另一个是下面的WebView。这里分别对应了TitleBar类与Tab类。

     

    主界面的控制

    有了UI界面后,需要有相应的控制器来操作UI界面。于是抽象出了主界面的控制器UiController接口。

    其他的地方就可以通过获取UiController的引用,来操作UI了。

    Controller实现了UiController接口,即实现UiController具体功能的就是Controller,其他地方获取的就是Controller的引用。

    BaseUi本身也有UiController的引用,用于自身做一些控制跟UI相关的操作。其实UiController定义的接口并不都是控制UI界面的,而是指跟UI相关的一批功能。

    Controller继承UiController接口,本身有UI接口的引用。

    BaseUI继承UI接口,本身有UiController接口的引用。

     

    WebView的控制

    浏览器的主体是WebView,对网页的操作都是通过WebView这个控件完成的。

    WebView被Tab类给包装起来,并且把BrowserSetting说也包含进来了。BrowserSetting是一个单例类,也即只有一个BrowserSetting对象。但是每一个窗口对应一个Tab。每个Tab里会创建一个WebView,同时包含BrowserSetting的引用。用公共的BrowserSetting的设置内容来配置它自己的WebView。

    对于Tab,有一个TabControl的类来管理它,这里我觉得不称为控制,称为管理更好,因为TabControl与Tab是一对多的关系,TabControl用于创建,销毁Tab,并且管理所有的Tab,排序所有的Tab,让其他模块可以获取某个Tab,至于获取到Tab后,就由相应的模块直接控制该Tab了。

    而TabControl又是在Controller中创建的,由Controller 来维护,但是Controller 也提供了getTabControl()的接口,可以让其他模块获取到TabControl的引用。

     

    对于WebView 的控制操作,又抽象出了WebViewController接口。WebViewController中很多接口函数都是需要传入Tab作为参数的。而实现WebViewController接口的是Controller。

    这就比较容易理解为什么需要传入Tab作为参数了,因为Controller中管理的是TabControl

    的对象,而TabControl是管理一组Tab的。所以如果要明确的对某一个Tab进行相关的操作,则需要通过参数传入该Tab,而Tab中又包含着WebView,所以Controller能够进一步的操作到WebView。

    在Tab中又有WebViewController的引用,这样Tab也可以进一步调用到TabControl,进而与其他的Tab相互控制。

    界面,WebView,控制器

    通过以上可见,Controller即实现了UiController接口,又实现了WebViewController接口。而主页面BaseUI中又有一个当前被激活使用的Tab。BaseUI与Tab都通过Controller来控制。

    这样其他的模块只要获取了Controller的引用,即可控制界面的WebView和其他的界面部分。

      

    WebView的接口的使用

    WebView是伴随着Tab一起创建的,Tab中管理着WebView,但是WebView的create是在Controller中,再设置给Tab,这样Tab可以剥除它的WebView,也可以重新设置WebView。

    但是WebView的接口主要通过Tab来调用。

    Tab中有两个WebView,一个被称为mMainView,另一个为mSubView(暂时不知道何时使用)。另外有一个BrowserSettings用于获额取当前浏览器的设置,并可以通过BrowserSettings来对全局的设置进行操作。

    Tab之间又可以组建父子关系,在一个页面中通过点击一个链接,并且在新的Tab页中打开这个链接时,那么新Tab就是当前这个Tab的孩子。

    WebView的回调是通过WebChromeClient和WebViewClient这两个类作为回调类来实现的。

    Tab中创建这两个类的继承类对象,然后设置在其WebView上。

    这样外部模块通过Tab封装的WebView接口可以调用WebView的功能,或者通过Tab获取WebView,直接操作WebView来调用WebView的功能。

    WebView通过回调类来回调一些操作,这些操作通过Tab实现的回调类来把回调信息传递到外部。注意Tab是可以获取到WebViewController的,而WebViewController与UiController是同一个Controller。即UI跟WebView是通过Controller连接起来的。所以在Tab中获取到回调信息后,是可以进一步通过Controller传递出去的。

    UI请求WebView功能与WebView功能回调UI

    基于上诉的框架可以看以下的一个例子,看下loadUrl这个操作。

    当在地址栏输入一个url时并点击回车时,会触发loadUrl这个流程。

    首先看界面上,地址栏是属于TitleBar的。在layout中可以看到title_bar_nav.xml文件定义了布局。而地址栏就对应了类UrlInputView。所以事件会从这里开始触发。

    这个地址栏UI布局的从外到内整体情况如下:

    BaseUi->TitleBar->NavigationBarBase->UrlInputView

    在对事件从内向往的处理过程中,就可以通过BaseUi找到UiController了(实际代码中在创建一些UI相关的类对象时就会把UiController传给该UI类对象,以便于以后使用。但是UiController最初是在BaseUi中获取到的)。

    再根据前面所述的框架,UI找到了UiController(即Controller),然后调用UiController的处理方法,UiController的处理时,此时就不要把它再看做UiController,而是看做Controller,Controller的处理会通过TabControl找到某个具体的Tab,然后再通过Tab找到WebView,进而调用WebView的loadUrl。

    经过上述流程就完成了,然后Controller再调用UI接口提供的执行进度更新的处理,即又完成了Controller对UI的控制。

    通过以上可见,UI部分可以通过找到UiController,进而调用Controller的处理函数。

    Controller本身既包含对UI的处理,又包含对WebView的处理,以及对Tab的管理。

    而Tab也可以通过WebViewController来找到Controller,进而对UI或者其他的Tab进行处理。

    这样很清晰的看到Controller是个总控制,也是个中转。

    上面对WebView执行loadUrl之后,会收到WebView的一些回调信息,这里以onPageStarted为例。

    首先回调传达到WebViewClient的onPageStarted函数中。之前提过,WebViewClient是在Tab中创建的,并且关联到Tab中的WebView中。所以回调信息首先到达Tab中。

    Tab如果想把信息传达到UI中那么就必须先找到Controller。Tab中有WebViewController,WebViewController就是Controller。这样Tab找到了Controller,Controller中有UI接口的对象,那么通过UI接口提供的操作就可以传达到BaseUI中,这样进一步就可以到达具体的UI控件中了比如TitleBar和NavigationBar。

     

    WebView以事件方式的回调

    WebView还有一种方式是以事件的方式回调。WebView本身是继承自View的一个控件,本身又有Activity的上下文信息,这样WebView可以发起一些事件,由BrowserActivity来响应,典型的一个例子是长按网页上的一个链接或者一个图片时,会弹出一个ContentMenu。

    这个过程时WebView发起了performLongClick()请求,该请求会执行ContentMenu的事件调用。

    BrowserActivity中的onCreateContentMenu被调用,BrowserActivity会把事件传递给Controller,由Controller来处理,Controller会根据WebView请求的一些信息来填充ContentMenu的菜单项,同时会设置菜单项的点击事件。然后又通过UI来设置TitleBar的隐藏。

    这个过程其实就是组建了一个ContentMenu,然后又对当前UI做一些处理。也就是事件从WebView发出,BrowserActivity接收响应,响应传递给Controller。Controller做为主控制,则既可以操作UI也可以操作功能,可以填充ContentMenu也可以为每个菜单项设置具体的功能函数。可见在这个过程中Controller做了很多事,负担了组织和管理和分配的工作。

    设置的管理

    每个WebView有一个WebSettings与之对应,但是浏览器作为一个整体,其所有的WebView的设置内容都相同,于是在app层统一出一个BrowserSettings的单例类。

    在BrowserSettings中由一个List管理了所有的WebSettings。这个是WebSettings的管理中心。

    那么WebSettings的来源呢?在创建WebView的时候,会从该WebView中取出它的WebSettings,然后把这个WebSettings加入到BrowserSettings中进行统一管理,并且还会以当前BrowserSettings中的配置情况对这个WebSettings进行同步设置,这样新的WebSettings的设置情况就跟其他的WebSettings一样了,也即新创建的WebView的设置情况与其他的WebView的设置情况统一了。这么看就跟一个新员工入职一样,新员工入职(创建WebView),进行登记(把它的WebSettings加入到BrowserSettings),并且对他进行员工配置和培训(同步它的WebSettings),这样新员工就跟其他同事有了相同的职位属性了(WebSettings配置相同)。

     

    设置的本地存储

    有了上述的设置的管理和同步后,这些设置还需要保存到本地,以便下次启动时同步。根据android的数据保存的方式,该配置采用SharedPreferences的形式来保存,保存的位置就是手机的/data/data/com.android.browser/shared_prefs/com.android.browser_preferences.xml中。

    BrowserSettings可以获取到SharedPreferences,通过SharedPreferences来读取和写入某项设置的配置情况。并且BrowserSettings把自身作为OnSharedPreferenceChangeListener注册给SharedPreferences,这样当SharedPreferences有变化时,BrowserSettings会请求同步所有的WebSettings,这样各个WebSettings始终跟SharedPreferences的配置情况保持一致。

    设置的UI

    设置的UI采用PreferenceActivity的方式,先把设置分组,每组作为一个header,见preference_headers.xml

    每组的页面又以PreferenceFragment的形式展现,各个PreferenceFragment的初始配置从SharedPreferences中对应项取出。

    当用户选择一些配置项的设置时,就会触发前面所说的SharedPreferences的更新事件,对于一些复杂的配置项,则需要在PreferenceFragment中主动的执行SharedPreferences的设置了,这样同样也会触发SharedPreferences的更新事件。

     

    设置的整体结构

    这样,把上述的内容组合起来得到下面的设置的整体结构

     

    展开全文
  • Browser对象

    2017-10-13 22:27:08
    Window 对象Window 对象表示浏览器中打开的窗口。 如果文档包含框架(frame 或 ...History 对象History 对象包含用户(在浏览器窗口中)访问过的 URL。 History 对象是 window 对象的一部分,可通过 window.history

    Window 对象

    Window 对象表示浏览器中打开的窗口。
    如果文档包含框架(frame 或 iframe 标签),浏览器会为 HTML 文档创建一个 window 对象,并为每个框架创建一个额外的 window 对象。

    History 对象

    History 对象包含用户(在浏览器窗口中)访问过的 URL
    History 对象是 window 对象的一部分,可通过 window.history 属性对其进行访问。
    注释:没有应用于 History 对象的公开标准,不过所有浏览器都支持该对象。

    浏览器窗口有一个history对象,用来保存浏览历史。

    history.length // 3

    history对象提供了一系列方法,允许在浏览历史之间移动。

    back():移动到上一个访问页面,等同于浏览器的后退键。
    
    forward():移动到下一个访问页面,等同于浏览器的前进键。
    
    go():接受一个整数作为参数,移动到该整数指定的页面,比如go(1)相当于forward()go(-1)相当于back()

    history.back();

    history.forward();

    history.go(-2);

    如果移动的位置超出了访问历史的边界,以上三个方法并不报错,而是默默的失败。

    history.go(0)相当于刷新当前页面。

    常见的“返回上一页”链接,代码如下。

    document.getElementById('backLink').onclick = function () {
      window.history.back();
    }

    注意,返回上一页时,页面通常是从浏览器缓存之中加载,而不是重新要求服务器发送新的网页。

    HTML5为history对象添加了两个新方法,history.pushState()和history.replaceState(),用来在浏览历史中添加和修改记录。

    if (!!(window.history && history.pushState)){
      // 支持History API
    } else {
      // 不支持
    }

    上面代码可以用来检查,当前浏览器是否支持History API。如果不支持的话,可以考虑使用Polyfill库History.js。

    history.pushState方法接受三个参数,依次为:

    state:一个与指定网址相关的状态对象,popstate事件触发时,该对象会传入回调函数。如果不需要这个对象,此处可以填null。
    title:新页面的标题,但是所有浏览器目前都忽略这个值,因此这里可以填null。
    url:新的网址,必须与当前页面处在同一个域。浏览器的地址栏将显示这个网址。

    var stateObj = { foo: 'bar' };
    history.pushState(stateObj, 'page 2', '2.html');

    添加上面这个新记录后,浏览器地址栏立刻显示example.com/2.html,但并不会跳转到2.html,甚至也不会检查2.html是否存在,它只是成为浏览历史中的最新记录。假定这时你访问了google.com,然后点击了倒退按钮,页面的url将显示2.html,但是内容还是原来的1.html。你再点击一次倒退按钮,url将显示1.html,内容不变。

    总之,pushState方法不会触发页面刷新,只是导致history对象发生变化,地址栏会有反应。

    如果pushState的url参数,设置了一个新的锚点值(即hash),并不会触发hashchange事件。如果设置了一个跨域网址,则会报错。

    // 报错

    history.pushState(null, null, ‘https://twitter.com/hello‘);

    上面代码中,pushState想要插入一个跨域的网址,导致报错。这样设计的目的是,防止恶意代码让用户以为他们是在另一个网站上。

    history.replaceState()

    history.replaceState方法的参数与pushState方法一模一样,区别是它修改浏览历史中当前纪录。
    假定当前网址是example.com/1.html,我们使用pushState方法在浏览记录(history对象)中添加一个新记录。

    假定当前网页是example.com/example.html。

    history.pushState({page: 1}, ‘title 1’, ‘?page=1’);

    history.pushState({page: 2}, ‘title 2’, ‘?page=2’);

    history.replaceState({page: 3}, ‘title 3’, ‘?page=3’);

    history.back()

    // url显示为http://example.com/example.html?page=1

    history.back()

    // url显示为http://example.com/example.html

    history.go(2)

    // url显示为http://example.com/example.html?page=3

    history.state属性

    history.state属性返回当前页面的state对象。

    history.pushState({page: 1}, ‘title 1’, ‘?page=1’);

    history.state

    // { page: 1 }

    popstate事件

    每当同一个文档的浏览历史(即history对象)出现变化时,就会触发popstate事件。

    需要注意的是,仅仅调用pushState方法或replaceState方法 ,并不会触发该事件,只有用户点击浏览器倒退按钮和前进按钮,或者使用JavaScript调用back、forward、go方法时才会触发。另外,该事件只针对同一个文档,如果浏览历史的切换,导致加载不同的文档,该事件也不会触发。

    使用的时候,可以为popstate事件指定回调函数。这个回调函数的参数是一个event事件对象,它的state属性指向pushState和replaceState方法为当前URL所提供的状态对象(即这两个方法的第一个参数)。

    如果当前窗口先后访问了三个网址,那么history对象就包括三项,history.length属性等于3。
    转自:http://javascript.ruanyifeng.com/bom/history.html

    Location 对象

    Location 对象包含有关当前 URL 的信息。
    Location 对象是 Window 对象的一个部分,可通过 window.location 属性来访问。

    assign()    加载新的文档。
    reload()    重新加载当前文档。(刷新当前页面 重点)
    replace()   用新的文档替换当前文档。
    展开全文
  • wpf webBrowser控件

    万次阅读 2019-06-03 20:55:39
    wpf webBrowser控件介绍WebBrowsers可以让我们在窗体中进行导航网页。 WebBrowser控件内部使用ie的引擎,因此使用WebBrowser我们必须安装ie浏览器(windows默认安装的)。使用直接在xmal中使用webBrowser控件...
  • browser.js

    2020-07-30 23:33:32
    前端开发可能会用到的JavaScript脚本,browser.js文件
  • browsersync的使用方法

    千次阅读 2018-04-13 11:34:39
    使用browsersync两年时间了,最近一段时间放弃了,不是browsersync的问题,是自己的问题,简单的说是,以前项目都是静态文件,直接用browsersync自带服务器跑起来就好,后来用nodejs express做项目,用到了art...
  • 一、textbrowser输出变量的值 二、在ui中添加一个textedit、textbrowser和一个pushbutton。在textedit中输入文本,点击pushbutton后,textbrowser中显示textedit中输入的文本
  • VSCode插件View InBrowser,在浏览器中查看 当前插件功能类似Atom中的“Run-In-Browser”. 插件功能描述:从浏览器中查看html文件,使用系统的当前默认浏览器 注:只支持html文件 默认的快捷键Ctrl+F1,可以自定义...
  • FileBrowser文件浏览器部署

    万次阅读 2018-10-26 11:05:04
    FileBrowser文件浏览器部署 概述 FileBrowser 文件浏览器,又名ES文件浏览器,是一个能管理手机本地、局域网共享、FTP和蓝牙文件的管理器。 官网 官网https://filebrowser.github.io/ 官网安装文档 ...
  • Qt text Browser 控件使用

    万次阅读 2019-09-16 11:28:35
    在界面需要显示收到内容可以使用text Browser空间,在工作中使用方便,我在使用中直接使用 ui->textBrowser->insertPlainText(),插入文本可是在输出的内容的时候输出的位置不确定有时按顺序依次向下输出,...
  • VScode中open in browser 和 view in browser默认浏览器配置 VScode是我们常用的编辑器,但是对于小白来说,安装好一个VScode还是要走好多弯路的,下面我们介绍一下关于VScode的两个插件open in browser 和 view in ...
  • vscode open in browser配置默认浏览器

    万次阅读 热门讨论 2020-05-16 14:09:32
    1.文件-->首选项-->设置 2.输入open-in 3.在设置默认浏览器位置输入:Chrome 如下图:
  • 使用File Browser 搭建远程文件管理器

    千次阅读 2019-06-20 14:16:10
    软件 版本 下载地址 CentOS 7.3 ...filebrowser ...https://github.com/filebrowser/filebrowser ...1、安装filebrowser tar -xvf linux-amd64-filebrowser.tar.gz mkdir -p /filebrowser mv filebrowser /filebrows...
  • vscode安装open in browser插件后, Alt + B 弹出Open browser failed!! Please check if you have installed the browser correctly!错误. 解决方法 插件处搜索该插件, 打开图示中的设置 在输入框中写上...
  • 1、下载DB Browser for SQLite 个人觉得比较好用的一个SQLite数据库查看工具2、在Android项目中databases中的数据库文件复制到其他位置3、使用该工具打开,即可查看...
  • 关于$.browser browser就是用来获取浏览器基本信息的。 jQuery 从 1.9 版开始,移除了 $.browser 和 $.browser.version , 取而代之的是 $.support 。 在更新的 2.0 版本中,将不再支持 IE 6/7/8。 以后,如果...
  • Ubuntu 16.04查看软件安装位置

    万次阅读 2016-06-16 10:41:41
    以chromium-browser为例find命令totoro@SWH:~$ sudo find / -name chromium-browser /usr/lib/chromium-browser /usr/lib/chromium-browser/chromium-browser /usr/bin/chromium-browser /usr/share/doc/chromium-...
  • SQL Server Browser 无法启动

    万次阅读 2013-03-31 14:00:06
    问题:SQL Server Browser 服务无法启动,即启动选项为灰色,该服务涉及到SQL Server的远程访问,因此有些急迫。   解决:其实很简单,只要进入管理员账户就能启动了,此处的管理员账户并非“以管理员身份运行”...
  • "open-in-browser.default": "Chrome"
1 2 3 4 5 ... 20
收藏数 319,646
精华内容 127,858
关键字:

browser