Como: Implementar a comunicação bidirecional entre o código DHTML e o código do aplicativo de cliente
Você pode usar o WebBrowser o controle para adicionar o código de aplicativo Web em HTML (DHTML) dinâmico existente para seus aplicativos de cliente do Windows Forms. Isso é útil quando você investiu tempo de desenvolvimento significativo na criação de controles baseados em DHTML e desejar aproveitar os recursos de interface do usuário avançada do Windows Forms sem a necessidade de reescrever o código existente.
O WebBrowser controle permite que você implementar a comunicação bidirecional entre o código do seu aplicativo de cliente e o seu código de script da página da Web por meio de ObjectForScripting e Document Propriedades. Além disso, você pode configurar o WebBrowser de controle para que os controles da Web combinam perfeitamente com outros controles do formulário do aplicativo, ocultando sua implementação de DHTML. Para misturar perfeitamente os controles, formatar a página exibida para que sua cor de plano de fundo e estilo visual correspondentes ao resto do formulário e usam o AllowWebBrowserDrop, IsWebBrowserContextMenuEnabled, e WebBrowserShortcutsEnabled Propriedades para desabilitar recursos do navegador padrão.
Para incorporar o DHTML em seu aplicativo Windows Forms
Definir o WebBrowser do controle AllowWebBrowserDrop propriedade para false para impedir que o WebBrowser controle abram arquivos solto sobre o proprietário.
webBrowser1.AllowWebBrowserDrop = False
webBrowser1.AllowWebBrowserDrop = false;
Defina o controle IsWebBrowserContextMenuEnabled propriedade para false para impedir que o WebBrowser controle exiba seu menu de atalho quando o usuário clica o proprietário.
webBrowser1.IsWebBrowserContextMenuEnabled = False
webBrowser1.IsWebBrowserContextMenuEnabled = false;
Defina o controle WebBrowserShortcutsEnabled propriedade para false para impedir que o WebBrowser o controle de responder às teclas de atalho.
webBrowser1.WebBrowserShortcutsEnabled = False
webBrowser1.WebBrowserShortcutsEnabled = false;
Definir o ObjectForScripting propriedade no construtor do formulário ou um Load manipulador de eventos.
O código a seguir usa a classe de formulário para o objeto de script.
Observação Modelo de objeto componente (COM) deve ser capaz de acessar o objeto de script. Para tornar visível para COM a seu formulário, adicione a ComVisibleAttribute atributo para sua classe de formulário.
webBrowser1.ObjectForScripting = Me
webBrowser1.ObjectForScripting = this;
Implemente métodos ou propriedades públicas em seu código do aplicativo que usará o seu 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"); }
Use o window.external o objeto no código de script para acessar propriedades públicas e métodos do objeto especificado.
O código HTML a seguir demonstra como chamar um método no objeto de script a partir de um clique de botão. Copiar este código para o elemento de corpo de um documento HTML que você carregar usando o controle Navigate método ou que você atribui ao controle DocumentText propriedade.
<button onclick="window.external.Test('called from script code')"> call client code from script code </button>
Implementar funções em seu código de script que irá usar o código do seu aplicativo.
O elemento de SCRIPT HTML a seguir fornece uma função de exemplo. Copie este código no elemento HEAD de um documento HTML que você carregar usando o controle Navigate método ou que você atribui ao controle DocumentText propriedade.
<script> function test(message) { alert(message); } </script>
Use o Document propriedade para acessar o código de script do seu código de aplicativo do cliente.
Por exemplo, adicione o seguinte código para um botão Click manipulador de eventos.
webBrowser1.Document.InvokeScript("test", _ New String() {"called from client code"})
webBrowser1.Document.InvokeScript("test", new String[] { "called from client code" });
Quando tiver terminado de depuração do DHTML, defina o controle ScriptErrorsSuppressed propriedade para true para impedir que o WebBrowser o controle de 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, você pode usar para entender esse recurso. O código HTML é carregado na WebBrowser controlar através 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 System.Windows.Forms e de sistema.
Para obter informações sobre como criar este exemplo a partir da linha de comando para Visual Basic ou Visual C#, consulte Compilando a partir da linha de comando (Visual Basic) ou Comando -<>>linha criando com CSC. exe. Você também pode construir este exemplo no Visual Studio colando o código em um novo projeto. Para obter mais informações, consulte Como: Compilar e executar um exemplo de código Windows Forms concluída usando Visual Studio e Como: Compilar e executar um exemplo de código Windows Forms concluída usando Visual Studio e Como: Compilar e executar um exemplo de código Windows Forms concluída usando Visual Studio e Como: Compilar e executar um exemplo de código de formulários Windows concluída usando o Visual Studio e Como: Compilar e executar um exemplo de código de formulários de Windows completa usando Visual Studio e Como compilar e executar um exemplo de código dos Windows Forms concluído usando Visual Studio.