HTMLTaskPane.HTMLDocument-Eigenschaft

Artikel
04/27/2010

Ruft einen Verweis auf ein HTML-Dokumentobjekt des benutzerdefinierten Aufgabenbereichs von Microsoft Office InfoPath 2007 ab.

Diese Eigenschaft ist nicht CLS-kompatibel.

Namespace: Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly: Microsoft.Office.Interop.InfoPath.SemiTrust (in microsoft.office.interop.infopath.semitrust.dll)

Syntax

<DispIdAttribute(4)> _
ReadOnly Property HTMLDocument As IHTMLDocument2

Dim instance As HTMLTaskPane
Dim value As IHTMLDocument2

value = instance.HTMLDocument

[DispIdAttribute(4)] 
IHTMLDocument2 HTMLDocument { get; }

Hinweise

Die HTMLDocument-Eigenschaft des HTMLTaskPaneObject-Objekts ist eine der Eigenschaften, die vom TaskPaneObject-Objekt geerbt werden, wenn der Aufgabenbereich den Typ 0 aufweist, d. h., wenn es sich um den benutzerdefinierten Aufgabenbereich handelt.

Mithilfe der HTMLDocument-Eigenschaft können Sie Skriptfunktionen im HTML-Code des Aufgabenbereichs über eine späte Bindung aufrufen, wie im zweiten Beispiel unten gezeigt wird. Außerdem können Sie den HTML-Code des Aufgabenbereichs mithilfe der Eigenschaften und Methoden, die das HTML-Dokumentobjekt bereitstellt, direkt bearbeiten.

Hinweis:
Vor dem Verwenden der HTMLDocument-Eigenschaft des HTMLTaskPaneObject-Objekts müssen Sie zuerst das TaskPaneObject-Objekt einem HTMLTaskPane-Objekt zuordnen (siehe die Beispiele unten).

Wichtig:
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

Beispiel

Im folgenden Beispiel wird die HTMLDocument-Eigenschaft des HTMLTaskPane-Objekts verwendet, um einen Verweis auf das HTML-Fensterobjekt des benutzerdefinierten Aufgabenbereichs eines vollständig vertrauenswürdigen Formulars festzulegen. Anschließend ändert der Code die Hintergrundfarbe des benutzerdefinierten Aufgabenbereichs.

Hinweis:
Für die folgenden Beispiele ist ein Verweis auf die Microsoft.mshtml.dll-Assembly erforderlich.

using mshtml;
public void ChangeBackgroundColor()
 {
 // Get a reference to the custom task pane. It is always index [0] in the TaskPanes collection.
  HTMLTaskPane oTaskPane = (HTMLTaskPane)thisXDocument.View.Window.TaskPanes[0];
  // Get a reference to the HTML document object of the custom task pane.
  IHTMLDocument2 oHTMLDoc = oTaskPane.HTMLDocument;
  // Change custom task pane background color to red.
  oHTMLDoc.bgColor = "red";
}

Im folgenden Beispiel wird die HTMLDocument-Eigenschaft des HTMLTaskPane-Objekts verwendet, um einen Verweis auf das HTML-Fensterobjekt 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.

HTMLTaskPane custom = (HTMLTaskPane) thisXDocument.View.Window.TaskPanes[0];
mshtml.IHTMLWindow2 window = custom.HTMLDocument.parentWindow; 
// call into script through CLR late binding mechanism
custom.HTMLDocument.parentWindow.GetType().InvokeMember(
 "TaskPaneSwitchView",      // late bound method      
 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);

Siehe auch

Referenz

HTMLTaskPane-Schnittstelle
HTMLTaskPane-Member
Microsoft.Office.Interop.InfoPath.SemiTrust-Namespace

Freigeben über