HtmlTaskPane.HtmlWindow Eigenschaft

Definition

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

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

public:
 abstract property System::Object ^ HtmlWindow { System::Object ^ get(); };

public abstract object HtmlWindow { get; }

member this.HtmlWindow : obj

Public MustOverride ReadOnly Property HtmlWindow As Object

Eigenschaftswert

Object

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

Ausnahmen

SecurityException

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

Beispiele

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)

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 bietet die gleiche Funktionalität wie die HtmlDocument -Eigenschaft, ist aber nur verfügbar, wenn voll vertrauenswürdige Formulare verwendet werden. Wenn ein Formular nicht vollständig vertrauenswürdig ist, können Sie stattdessen die HtmlDocument-Eigenschaft verwenden.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die über eine Formularvorlage geöffnet wurden, die mithilfe der Kategorie "Sicherheit und Vertrauensstellung" im Dialogfeld "Formularoptionen" so konfiguriert wurde, dass sie mit voller Vertrauenswürdigkeit ausgeführt wird. Dieses Mitglied erfordert die volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer und kann von teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie auf MSDN unter "Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code".

Auf diesen Typ oder dieses Mitglied kann nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler geöffnet wurden.