Freigeben über


HTMLTaskPane.HTMLDocument Eigenschaft

Definition

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

public:
 property mshtml::IHTMLDocument2 ^ HTMLDocument { mshtml::IHTMLDocument2 ^ get(); };
public mshtml.IHTMLDocument2 HTMLDocument { get; }
member this.HTMLDocument : mshtml.IHTMLDocument2
Public ReadOnly Property HTMLDocument As IHTMLDocument2

Eigenschaftswert

Beispiele

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: In den folgenden Beispielen 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.<span class="label">HTMLDocument</span>;
  // 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 TaskPaneSwitchView benutzerdefinierte Funktion 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.<span class="label">HTMLDocument</span>.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);

Hinweise

Die HTMLDocument-Eigenschaft des HTMLTaskPaneObject Objekts ist eine der Eigenschaften, die TaskPaneObject vom Objekt geerbt werden, wenn der Typ des Aufgabenbereichs 0 ist, was bedeutet, dass 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: Bevor Sie die HTMLDocument-Eigenschaft des HTMLTaskPaneObject Objekts verwenden, müssen Sie das TaskPaneObject Objekt zuerst in ein HTMLTaskPane-Objekt umwandeln, wie in den folgenden Beispielen gezeigt.

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

Gilt für: