TaskPaneObject, interface

Article
04/27/2010

Représente un volet Office dans un formulaire Microsoft Office InfoPath 2007 associé à une fenêtre.

Espace de noms : Microsoft.Office.Interop.InfoPath.SemiTrust
Assembly : Microsoft.Office.Interop.InfoPath.SemiTrust (dans microsoft.office.interop.infopath.semitrust.dll)

Syntaxe

<GuidAttribute("096cd58e-0786-11d1-95fa-0080c78ee3bb")> _
<CoClassAttribute(GetType(TaskPaneObjectWrapper))> _
<CLSCompliantAttribute(False)> _
Public Interface TaskPaneObject
    Inherits TaskPane

Dim instance As TaskPaneObject

[GuidAttribute("096cd58e-0786-11d1-95fa-0080c78ee3bb")] 
[CoClassAttribute(typeof(TaskPaneObjectWrapper))] 
[CLSCompliantAttribute(false)] 
public interface TaskPaneObject : TaskPane

Remarques

Ce type est le wrapper d'une classe de composants (coclass) requise par le code managé pour l'interopérabilité COM. Ce type permet d'accéder aux membres de l'interface COM implémentés par cette classe de composants. Pour plus d'informations sur l'interface COM, et pour accéder aux descriptions de ses membres, voir TaskPane.

L'objet TaskPaneObject fournit des propriétés permettant d'utiliser les volets Office prédéfinis d'InfoPath. L'objet HTMLTaskPaneObject hérite de ces propriétés pour utiliser un volet Office personnalisé.

Les propriétés disponibles pour un volet Office InfoPath sont déterminées par le type de volet Office que vous utilisez. Si la propriété TaskPaneType renvoie 0, le volet Office est un volet Office personnalisé et les propriétés et méthodes disponibles sont fournies par l'objet HTMLTaskPane. Si la propriété TaskPaneType renvoie une autre valeur, le volet Office est un volet Office prédéfini et les propriétés sont fournies par l'objet TaskPaneObject.

Remarque
La propriété TaskPaneType est basée sur l'énumération XdTaskPaneType. Ces valeurs énumérées sont également utilisées comme arguments pour la propriété Item de la collection TaskPanesCollection afin de renvoyer une référence à un type spécifié de volet Office.

Exemple

Dans l'exemple suivant, la propriété Item de la collection TaskPanesCollection est utilisée pour obtenir une référence à l'objet TaskPane qui représente le volet Office personnalisé. Le code appelle ensuite une fonction de script définie dans le code HTML du volet Office personnalisé à l'aide de la propriété HTMLDocument de l'objet HTMLTaskPaneObject, hérité par l'objet TaskPane.

// 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);
 }
}

Remarque
L'exemple ci-dessus requiert une référence à l'assembly Microsoft.mshtml.dll.

Voir aussi

Référence

Membres TaskPaneObject
Microsoft.Office.Interop.InfoPath.SemiTrust, espace de noms

Partager via