TaskPaneObject-Schnittstelle

Artikel
04/27/2010

Stellt einen Aufgabenbereich in einem Microsoft Office InfoPath-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("096CD58E-0786-11D1-95FA-0080C78EE3BB")> _
<CoClassAttribute(GetType(TaskPaneObjectClass))> _
Public Interface TaskPaneObject
    Inherits TaskPane

Dim instance As TaskPaneObject

[GuidAttribute("096CD58E-0786-11D1-95FA-0080C78EE3BB")] 
[CoClassAttribute(typeof(TaskPaneObjectClass))] 
public interface TaskPaneObject : TaskPane

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 TaskPane.

Das TaskPaneObject-Objekt bietet Eigenschaften für das Arbeiten mit den in InfoPath integrierten Aufgabenbereichen. Das HTMLTaskPaneObject-Objekt erbt diese Eigenschaften für das Arbeiten mit einem benutzerdefinierten Aufgabenbereich.

Die Eigenschaften, 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 TaskPaneObject-Objekt bereitgestellt.

Hinweis:
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.

Beispiel

Im folgenden Beispiel wird die Item-Eigenschaft der TaskPanesCollection-Auflistung verwendet, um einen Verweis auf das TaskPane-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 HTMLTaskPaneObject-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);
 }
}

Hinweis:
Für das vorstehende Beispiel ist ein Verweis auf die Microsoft.mshtml.dll-Assembly erforderlich.

Siehe auch

Referenz

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

Share via