Como: Implementar a comunicação bidirecional entre o código DHTML e o código do aplicativo cliente

Você pode usar o WebBrowser controle para adicionar código do aplicativo Web Web HTML (DHTML) dinâmico existente a seus aplicativos de cliente do Windows Forms. Isso é útil quando você investiu time de desenvolvimento significativo na criação de controles com base em DHTML e deseja usufruir os recursos de interface do usuário avançado do Windows Forms sem a necessidade de reescrever o código existente.

The WebBrowser o controle permite que você implementar a comunicação bidirecional entre o código do aplicativo cliente e o código de script da página da Web por meio do ObjectForScripting e Document Propriedades. Além disso, você pode configurar o WebBrowser controle para que os controles da Web combinar diretamente com outros controles de formulário seu aplicativo, ocultando a implementação de DHTML. Para misturar diretamente os controles, formatar a página exibida para que sua cor do plano de fundo e estilo visual correspondentes ao resto do formulário e usam o AllowWebBrowserDrop, IsWebBrowserContextMenuEnabled, e WebBrowserShortcutsEnabled propriedades para desabilitar os recursos do navegador padrão.

Para incorporar DHTML em seu aplicativo Windows Forms

1. conjunto o WebBrowser do controle AllowWebBrowserDrop propriedade para false Para impedir que o WebBrowser controlar abram arquivos solto sobre ele.

   webBrowser1.AllowWebBrowserDrop = False
   

   webBrowser1.AllowWebBrowserDrop = false;
   

2. conjunto IsWebBrowserContextMenuEnabled propriedade para false Para impedir que o WebBrowser controle de exibir seu menu de atalho quando o usuário clica com o botão direito do mouse-lo.

   webBrowser1.IsWebBrowserContextMenuEnabled = False
   

   webBrowser1.IsWebBrowserContextMenuEnabled = false;
   

3. conjunto WebBrowserShortcutsEnabled propriedade para false Para impedir que o WebBrowser controle de responder a teclas de atalho.

   webBrowser1.WebBrowserShortcutsEnabled = False
   

   webBrowser1.WebBrowserShortcutsEnabled = false;
   

4. conjunto o ObjectForScripting propriedade no construtor do formulário ou um Load manipulador de eventos.

   O código a seguir usa a própria classe de formulário para o objeto de script.

   Observação:
   componente Object Model (COM) deve ser capaz de acesso o objeto de script.Para tornar o formulário visível para com., adicione o ComVisibleAttribute o atributo à sua classe de formulário.

   webBrowser1.ObjectForScripting = Me
   

   webBrowser1.ObjectForScripting = this;
   

5. Implementa métodos ou propriedades públicas no código do aplicativo que usará o código de script.

   Por exemplo, se você usar a classe de formulário para o objeto de script, adicione o seguinte código à sua classe de formulário.

   Public Sub Test(ByVal message As String)
       MessageBox.Show(message, "client code")
   End Sub
   

   public void Test(String message)
   {
       MessageBox.Show(message, "client code");
   }
   

6. Use o window.external objeto no código de script para acesso públicas propriedades e métodos do objeto especificado.

   O código HTML a seguir demonstra como chamar um método no objeto de script a partir um clicar de botão.Copie este código no elemento BODY de um documento HTML que você carregar o uso Navigate método ou que você atribuir ao controle DocumentText propriedade.

   <button onclick="window.external.Test('called from script code')">
       call client code from script code
   </button>
   

7. Implementar funções em seu código de script que o código do seu aplicativo usará.

   O seguinte elemento de SCRIPT de HTML fornece uma função de exemplo.Copie este código para o elemento HEAD de um documento HTML que você carregar o uso Navigate método ou que você atribuir ao controle DocumentText propriedade.

   <script>
   function test(message) { 
       alert(message); 
   }
   </script>
   

8. Use o Document propriedade para acessar o código de script a partir do código do aplicativo cliente.

   Por exemplo, adicione o seguinte código para um botão Click evento manipulador.

   webBrowser1.Document.InvokeScript("test", _
       New String() {"called from client code"})
   

   webBrowser1.Document.InvokeScript("test",
       new String[] { "called from client code" });
   

9. Quando tiver terminado de depurar o DHTML, conjunto ScriptErrorsSuppressed propriedade para true Para impedir que o WebBrowser Controlar exibição de mensagens de erro para problemas de código de script.

   ' Uncomment the following line when you are finished debugging.
   'webBrowser1.ScriptErrorsSuppressed = True
   

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

Exemplo

O exemplo de código completo a seguir fornece um aplicativo de demonstração que você pode usar para entender esse recurso.O código HTML é carregado no WebBrowser controlar por meio do DocumentText propriedade em vez de sendo carregado a partir de um arquivo HTML separado.

Imports System
Imports System.Windows.Forms
Imports System.Security.Permissions

<PermissionSet(SecurityAction.Demand, Name:="FullTrust")> _
<System.Runtime.InteropServices.ComVisibleAttribute(True)> _
Public Class Form1
    Inherits Form

    Private webBrowser1 As New WebBrowser()
    Private WithEvents button1 As New Button()

    <STAThread()> _
    Public Shared Sub Main()
        Application.EnableVisualStyles()
        Application.Run(New Form1())
    End Sub

    Public Sub New()
        button1.Text = "call script code from client code"
        button1.Dock = DockStyle.Top
        webBrowser1.Dock = DockStyle.Fill
        Controls.Add(webBrowser1)
        Controls.Add(button1)
    End Sub

    Private Sub Form1_Load(ByVal sender As Object, ByVal e As EventArgs) _
        Handles Me.Load

        webBrowser1.AllowWebBrowserDrop = False
        webBrowser1.IsWebBrowserContextMenuEnabled = False
        webBrowser1.WebBrowserShortcutsEnabled = False
        webBrowser1.ObjectForScripting = Me
        ' 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>"
    End Sub

    Public Sub Test(ByVal message As String)
        MessageBox.Show(message, "client code")
    End Sub

    Private Sub button1_Click(ByVal sender As Object, ByVal e As EventArgs) _
        Handles button1.Click

        webBrowser1.Document.InvokeScript("test", _
            New String() {"called from client code"})

    End Sub

End Class

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

}

Compilando o código

Esse código requer:

• Referências aos assemblies sistema e sistema.Windows.Forms.

Para obter informações sobre como criar este exemplo a partir da linha de comando para Visual Basic ou Visual C#, consulte Criando a partir da linha de comando (Visual Basic) ou Linha de comando criando com csc.exe.Você também pode construir este exemplo no Visual Studio colando o código em um novo projeto.

Consulte também

Referência

WebBrowser

WebBrowser.Document

WebBrowser.ObjectForScripting

Outros recursos

WebBrowser controle (Windows Forms)