如何:在 DHTML 代码和客户端应用程序代码之间实现双向通信

全文摘自:http://msdn.microsoft.com/zh-cn/library/a0746166(VS.80).aspx

可以使用 WebBrowser 控件向 Windows 窗体客户端应用程序添加现有的动态 HTML (DHTML) Web 应用程序代码。在投入大量的开发时间创建基于 DHTML 的控件,并希望利用丰富的 Windows 窗体用户界面功能而无需重写现有的代码时,该控件十分有用。

使用 WebBrowser 控件,可以通过 ObjectForScriptingDocument 属性在客户端应用程序代码和网页脚本代码之间实现双向通信。此外,可以对 WebBrowser 控件进行配置,使 Web 控件可以与应用程序窗体上的其他控件进行无缝整合,从而隐藏其 DHTML 实现。若要使控件无缝整合,请对所显示页的格式进行设置,使其背景颜色和视觉样式与窗体的其余部分匹配,然后使用AllowWebBrowserDropIsWebBrowserContextMenuEnabledWebBrowserShortcutsEnabled 属性禁用标准浏览器功能。

在 Windows 窗体应用程序中嵌入 DHTML

  1. WebBrowser 控件的 AllowWebBrowserDrop 属性设置为 false,以防止 WebBrowser 控件打开拖放到其上的文件。

    C#

    webBrowser1.AllowWebBrowserDrop = false;
  2. 将该控件的 IsWebBrowserContextMenuEnabled 属性设置为 false,以防止 WebBrowser 控件在用户右击它时显示其快捷菜单。

    C#

    webBrowser1.IsWebBrowserContextMenuEnabled = false;
  3. 将该控件的 WebBrowserShortcutsEnabled 属性设置为 false,以防止 WebBrowser 控件响应快捷键。

    C#

    webBrowser1.WebBrowserShortcutsEnabled = false;
  4. 在窗体的构造函数或 Load 事件处理程序中设置 ObjectForScripting 属性。

    下面的代码将窗体类自身用于脚本对象。

    Note注意

    组件对象模型 (COM) 必须能够访问脚本对象。若要使窗体对 COM 可见,请将 ComVisibleAttribute 属性添加到窗体类中。

    C#

    webBrowser1.ObjectForScripting = this;
  5. 在应用程序代码中实现脚本代码将使用的公共属性或方法。

    例如,如果要使用脚本对象的窗体类,请向窗体类添加以下代码。

    C#

    public void Test(String message)
    
    {
    
        MessageBox.Show(message, "client code");
    
    }
  6. 使用脚本代码中的 window.external 对象访问指定对象的公共属性和方法。

    下面的 HTML 代码演示如何通过单击按钮对脚本对象调用方法。将此代码复制到 HTML 文档的 BODY 元素中,该文档使用控件的 Navigate 方法加载或被分配给控件的DocumentText 属性。

    <button onclick="window.external.Test('called from script code')">
    
        call client code from script code
    
    </button>
  7. 在脚本代码中实现应用程序代码将使用的函数。

    下面的 HTML SCRIPT 元素提供了一个示例函数。将此代码复制到 HTML 文档的 HEAD 元素中,该文档使用控件的 Navigate 方法加载或被分配到控件的DocumentText 属性。

    <script>
    
    function test(message) { 
    
        alert(message); 
    
    }
    
    </script>
  8. 使用 Document 属性从客户端应用程序代码访问脚本代码。

    例如,将下面的代码添加到按钮 Click 的事件处理程序中。

    C#

    webBrowser1.Document.InvokeScript("test",
    
        new String[] { "called from client code" });
  9. 调试完 DHTML 之后,将该控件的 ScriptErrorsSuppressed 属性设置为 true,以防止 WebBrowser 控件显示脚本代码问题的错误信息。

    C#

    // Uncomment the following line when you are finished debugging.
    
    //webBrowser1.ScriptErrorsSuppressed = true;

示例

下面的完整代码示例提供了一个演示应用程序,可用于理解此功能。HTML 代码通过 DocumentText 属性加载到 WebBrowser 控件中,而不是从单独的 HTML 文件加载。

C#

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>" +

            "function test(message) { alert(message); }" +

            "</script></head><body><button " +

            "onclick=\"window.external.Test('called from script code')\">" +

            "call client code from script code</button>" +

            "</body></html>";

    }



    public void Test(String message)

    {

        MessageBox.Show(message, "client code");

    }



    private void button1_Click(object sender, EventArgs e)

    {

        webBrowser1.Document.InvokeScript("test",

            new String[] { "called from client code" });

    }



}

你可能感兴趣的:(html)