HTMLTaskPane.HTMLDocument-Eigenschaft

Artikel
04/27/2010

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

Namespace: Microsoft.Office.Interop.InfoPath
Assembly: Microsoft.Office.Interop.InfoPath (in microsoft.office.interop.infopath.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).

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-Namespace

Freigeben über