HtmlTaskPane.HtmlWindow-Eigenschaft

Artikel
04/27/2010

Ruft einen Verweis auf die MSHTML-IHTMLWindow2-Schnittstelle zum Arbeiten mit dem HTML-Dokument eines benutzerdefinierten Aufgabenbereichs ab.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Syntax

'Declaration
Public MustOverride ReadOnly Property HtmlWindow As Object
'Usage
Dim instance As HtmlTaskPane
Dim value As Object

value = instance.HtmlWindow

public abstract Object HtmlWindow { get; }

Eigenschaftswert

Ein IHTMLWindow2-Objekt, das der HTML-Datei des benutzerdefinierten Aufgabenbereichs zugeordnet ist.

Ausnahmen

Ausnahmetyp	Bedingung
SecurityException	Die Formularvorlage ist in der Kategorie Sicherheit und Vertrauensstellung des Dialogfeldes Formularoptionen nicht auf Voll Vertrauenswürdig festgelegt.

Hinweise

Mithilfe der HtmlWindow-Eigenschaft können Sie Skriptfunktionen im HTML-Code des Aufgabenbereichs aus dem primären Formularcode aufrufen, den HTML-Code des Aufgabenbereichs bearbeiten und mit den Eigenschaften und Methoden arbeiten, die die IHTMLWindow2-Schnittstelle bereitstellt.

Hinweis

Die HtmlWindow-Eigenschaft stellt dieselbe Funktionalität wie die HtmlDocument-Eigenschaft bereit, ist jedoch nur für vollständig vertrauenswürdige Formulare verfügbar. Wenn ein Formular nicht vollständig vertrauenswürdig ist, können Sie stattdessen die HtmlDocument-Eigenschaft verwenden.

Auf den Member kann nur über Formulare zugegriffen werden, die über eine Formularvorlage geöffnet werden. Die Formularvorlage muss zum voll vertrauenswürdigen Ausführen mithilfe der Kategorie "Sicherheit und Vertrauensstellung" des Dialogfelds "Formularoptionen" konfiguriert werden. Der Member erfordert volle Vertrauenswürdigkeit für den sofortigen Aufrufer und kann nicht von teilweise vertrauenswürdigem Code verwendet werden. Weitere Informationen finden Sie unter "Using Libraries from Partially Trusted Code" (in Englisch) auf MSDN.

Auf diesen Typ oder diesen Member kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 geöffnet wurden.

Beispiel

Im folgenden Beispiel wird die HtmlWindow-Eigenschaft der HtmlTaskPane-Klasse verwendet, um einen Verweis auf das IHTMLWindow2-Objekt des benutzerdefinierten Aufgabenbereichs eines vollständig vertrauenswürdigen Formulars festzulegen. Anschließend ruft der Code die benutzerdefinierte Funktion TaskPaneSwitchView auf, die im HTML-Code des benutzerdefinierten Aufgabenbereichs definiert ist.

   // Get a reference to the custom task pane. It is always index [0]
   // in the TaskPanes collection.
   HtmlTaskPane custom = (Microsoft.Office.InfoPath.HtmlTaskPane)
      this.CurrentView.Window.TaskPanes[0];

   // Get a reference to the parent window of the task pane.
   IHTMLWindow2 window = (IHTMLWindow2)custom.HtmlWindow;

   // Call into script through CLR late binding mechanism.
   window.GetType().InvokeMember(
      "TaskPaneSwitchView",      // late bound method name.
      System.Reflection.BindingFlags.InvokeMethod | // binding flags
      System.Reflection.BindingFlags.DeclaredOnly |
      System.Reflection.BindingFlags.Public |
      System.Reflection.BindingFlags.Instance,
      null,     // binder object
      window,   // target object
      null);   // method arguments

   ' Get a reference to the custom task pane. It is always index (0)
   ' in the TaskPanes collection.
   Dim custom As HtmlTaskPane = _
      DirectCast(Me.CurrentView.Window.TaskPanes(0), _
      Microsoft.Office.InfoPath.HtmlTaskPane)

     ' Get a reference to the parent window of the task pane.
      Dim window As IHTMLWindow2 = DirectCast(custom.HtmlWindow, _
         IHTMLWindow2

     ' Call into script through CLR late binding mechanism.
     window.GetType().InvokeMember( _
      "TaskPaneSwitchView", _
      System.Reflection.BindingFlags.InvokeMethod Or _
      System.Reflection.BindingFlags.DeclaredOnly Or _
      System.Reflection.BindingFlags.Public Or _
      System.Reflection.BindingFlags.Instance, _
      Nothing, _
      window, _
      Nothing)

Siehe auch

Referenz

HtmlTaskPane-Klasse
HtmlTaskPane-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über