Share via


HTMLTaskPaneObject Schnittstelle

Definition

Stellt einen benutzerdefinierten Aufgabenbereich in einem Microsoft InfoPath-Formular dar, das einem Fenster zugeordnet ist.

public interface class HTMLTaskPaneObject : Microsoft::Office::Interop::InfoPath::HTMLTaskPane
[System.Runtime.InteropServices.Guid("096CD548-0786-11D1-95FA-0080C78EE3BB")]
public interface HTMLTaskPaneObject : Microsoft.Office.Interop.InfoPath.HTMLTaskPane
type HTMLTaskPaneObject = interface
    interface HTMLTaskPane
Public Interface HTMLTaskPaneObject
Implements HTMLTaskPane
Abgeleitet
Attribute
Implementiert

Beispiele

Im folgenden Beispiel wird die P:Microsoft.Office.Interop.InfoPath.TaskPanes.Item(System.Object)-Eigenschaft der T:Microsoft.Office.Interop.InfoPath.TaskPanesCollection-Auflistung verwendet, um einen Verweis auf das T:Microsoft.Office.Interop.InfoPath.TaskPaneObject-Objekt abzurufen, das den benutzerdefinierten Aufgabenbereich darstellt. Der Code ruft dann die Navigate(String) -Methode des HTMLTaskPane-Objekts auf, um eine HTML-Datei zu öffnen.

public void CustomTaskPaneNavigation()
{
 // Get a reference to the custom task pane. It is always index [0] in the TaskPanes collection.   
<span class="label">HTMLTaskPane</span> oTaskPane = (HTMLTaskPane)thisXDocument.View.Window.TaskPanes[0];

 // Navigate based on url specified.
 oTaskPane.Navigate("taskpane2.html");
}

Im folgenden Beispiel wird die Item[Object] -Eigenschaft der TaskPanesCollection Auflistung verwendet, um einen Verweis auf das TaskPaneObject -Objekt abzurufen, das den benutzerdefinierten Aufgabenbereich darstellt. Der Code ruft dann eine Skriptfunktion auf, die im HTML-Code des benutzerdefinierten Aufgabenbereichs mithilfe der HTMLDocument -Eigenschaft des HTMLTaskPane-Objekts definiert ist, das vom TaskPane-Objekt geerbt wird.

// Ensure View has loaded before trying to access the task pane.
if (thisXDocument.View != null)
{
 // Get a reference to the custom task pane.  It is always the 0-th
 // task pane in the TaskPanes collection.
<span class="label">HTMLTaskPane</span> custom = (HTMLTaskPane) thisXDocument.View.Window.TaskPanes[0];

 // Ensure that the task pane is completely loaded.
 if (custom != null &amp;&amp; custom.HTMLDocument.readyState == "complete")
 {
  mshtml.IHTMLWindow2 window = custom.HTMLDocument.parentWindow;

  object[] args =  new object[] {"ViewID"};

  // call into script through CLR late binding mechanism
  window.GetType().InvokeMember(
   "SelectView",      // 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
   args);
 }
}

Hinweise

Dieser Typ ist ein Wrapper für eine CoClass, die von verwaltetem Code für COM-Interoperabilität benötigt wird. Verwenden Sie diesen Typ, um auf die Mitglieder der COM-Schnittstelle zuzugreifen, die von dieser CoClass implementiert wird. Informationen zur COM-Schnittstelle, einschließlich eines Links zu Beschreibungen ihrer Member, finden Sie unterHTMLTaskPane .

Das HTMLTaskPane-Objekt stellt eine Reihe von Eigenschaften und Methoden für die Arbeit mit dem benutzerdefinierten InfoPath-Aufgabenbereich bereit und stellt Eigenschaften und Methoden des TaskPaneObject Objekts bereit.

Die Eigenschaften und Methoden, die für einen InfoPath-Aufgabenbereich verfügbar sind, werden durch den Typ des Aufgabenbereichs bestimmt, mit dem Sie arbeiten. Wenn die TaskPaneType Eigenschaft 0 zurückgibt, ist der Aufgabenbereich ein benutzerdefinierter Aufgabenbereich, und die verfügbaren Eigenschaften und Methoden werden vom HTMLTaskPane-Objekt bereitgestellt. Wenn die TaskPaneType-Eigenschaft einen anderen Wert zurückgibt, handelt es sich um einen integrierten Aufgabenbereich, und die Eigenschaften werden vom TaskPane-Objekt bereitgestellt.

Die TaskPaneType-Eigenschaft basiert auf der XdTaskPaneType -Enumeration. Diese Aufzählungswerte werden auch als Argumente für die Item[Object] -Eigenschaft der TaskPanesCollection Auflistung verwendet, um einen Verweis auf einen angegebenen Aufgabenbereichstyp zurückzugeben.

Hinweis: Die Eigenschaften und Methoden des HTMLTaskPane-Objekts können während eines _XDocumentEventSink2_OnLoadEventHandler Ereignisses nicht aufgerufen werden, da die Ansicht noch nicht geladen ist, wenn dieses Ereignis eintritt, und Aufgabenbereiche der Ansicht zugeordnet sind.

Eigenschaften

HTMLDocument

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

(Geerbt von HTMLTaskPane)
HTMLWindow

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

(Geerbt von HTMLTaskPane)
TaskPaneType

Ruft einen Wert ab, der den Typ des Aufgabenbereichs angibt, der durch das HTMLTaskPaneObject -Objekt dargestellt wird, bei dem es sich immer um einen benutzerdefinierten Aufgabenbereich handelt.

(Geerbt von HTMLTaskPane)
Visible

Ruft einen Wert ab, der angibt, dass der durch das -Objekt dargestellte Aufgabenbereich, bei dem HTMLTaskPaneObject es sich immer um einen benutzerdefinierten Aufgabenbereich handelt, in der Microsoft Office InfoPath 2003-Benutzeroberfläche angezeigt wird, oder legt diesen fest.

(Geerbt von HTMLTaskPane)

Methoden

Navigate(String)

Lädt das angegebene HTML-Dokument in den benutzerdefinierten Microsoft Office InfoPath 2003-Aufgabenbereich.

(Geerbt von HTMLTaskPane)

Gilt für: