WebBrowser.ObjectForScripting Tulajdonság
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Lekéri vagy beállít egy objektumot, amely a vezérlőben megjelenített weblapon WebBrowser található szkriptkóddal érhető el.
public:
property System::Object ^ ObjectForScripting { System::Object ^ get(); void set(System::Object ^ value); };[System.ComponentModel.Browsable(false)]
public object ObjectForScripting { get; set; }[System.ComponentModel.Browsable(false)]
public object? ObjectForScripting { get; set; }[<System.ComponentModel.Browsable(false)>]
member this.ObjectForScripting : obj with get, setPublic Property ObjectForScripting As ObjectTulajdonság értéke
A szkriptelési kód számára elérhetővé tett objektum.
- Attribútumok
Kivételek
A tulajdonság beállításakor megadott érték nem nyilvános típusú példány.
-vagy-
A tulajdonság beállításakor megadott érték egy olyan típusú példány, amely nem LÁTHATÓ a COM-on. További információért lásd IsTypeVisibleFromCom(Type).
Példák
Az alábbi példakód bemutatja a ObjectForScripting tulajdonság használatát. A példában a ObjectForScripting tulajdonság az aktuális űrlapra van állítva.
using System;
using System.Windows.Forms;
using System.Security.Permissions;
[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" });
}
}
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
Megjegyzések
Ezzel a tulajdonságtal engedélyezheti a vezérlőelem által üzemeltetett weblapok és a vezérlőt WebBrowser tartalmazó alkalmazás közötti kommunikációt WebBrowser . Ez a tulajdonság lehetővé teszi dinamikus HTML-kód (DHTML) integrálását az ügyfélalkalmazás kódjával. A tulajdonsághoz megadott objektum objektumként window.external a weblapszkript számára érhető el, amely egy beépített DOM-objektum, amely a gazdagéphez való hozzáférést biztosítja.
Ezt a tulajdonságot bármely OLYAN COM-beli objektumra beállíthatja, amelynek nyilvános tulajdonságait és metódusait elérhetővé szeretné tenni a szkriptelési kód számára. A COM-osztályokat úgy teheti láthatóvá, hogy megjelöli azt a ComVisibleAttribute.
A weblapon definiált függvények ügyfélalkalmazás-kódból való meghívásához használja a HtmlDocument.InvokeScriptHtmlDocument tulajdonságból Document lekérhető objektum metódusát.
