HTMLTaskPaneObject-Schnittstelle

Artikel
04/27/2010

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

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

Syntax

<GuidAttribute("096CD548-0786-11D1-95FA-0080C78EE3BB")> _
<CoClassAttribute(GetType(HTMLTaskPaneObjectClass))> _
Public Interface HTMLTaskPaneObject
    Inherits HTMLTaskPane

Dim instance As HTMLTaskPaneObject

[GuidAttribute("096CD548-0786-11D1-95FA-0080C78EE3BB")] 
[CoClassAttribute(typeof(HTMLTaskPaneObjectClass))] 
public interface HTMLTaskPaneObject : HTMLTaskPane

Hinweise

Dies ist ein Wrappertyp für eine Coklasse, die für den verwalteten Code der COM-Interoperabilität erforderlich ist. Verwenden Sie diesen Typ zum Zugreifen auf die Member der COM-Schnittstelle, die von der Coklasse implementiert wurden. Informationen zur COM-Schnittstelle, einschließlich eines Links zu den Memberbeschreibungen, finden Sie unter HTMLTaskPane.

Das HTMLTaskPane-Objekt stellt mehrere Eigenschaften und Methoden für die Arbeit mit einem benutzerdefinierten InfoPath-Aufgabenbereich und 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 den Wert 0 zurückgibt, handelt es sich um einen benutzerdefinierten 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 verfügbaren Eigenschaften werden vom TaskPane-Objekt bereitgestellt.

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

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

Beispiel

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 festzulegen, das den benutzerdefinierten Aufgabenbereich darstellt. Der Code ruft dann die Navigate-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.   
 HTMLTaskPane oTaskPane = (HTMLTaskPane)thisXDocument.View.Window.TaskPanes[0];

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

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

// 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.
 HTMLTaskPane custom = (HTMLTaskPane) thisXDocument.View.Window.TaskPanes[0];

 // Ensure that the task pane is completely loaded.
 if (custom != null && 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);
 }
}

Siehe auch

Referenz

HTMLTaskPaneObject-Member
Microsoft.Office.Interop.InfoPath-Namespace

Share via