HTMLTaskPaneObject, interface

Article
04/27/2010

Représente un volet Office personnalisé 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("096cd548-0786-11d1-95fa-0080c78ee3bb")> _
<CLSCompliantAttribute(False)> _
<CoClassAttribute(GetType(HTMLTaskPaneObjectWrapper))> _
Public Interface HTMLTaskPaneObject
    Inherits HTMLTaskPane, TaskPane

Dim instance As HTMLTaskPaneObject

[GuidAttribute("096cd548-0786-11d1-95fa-0080c78ee3bb")] 
[CLSCompliantAttribute(false)] 
[CoClassAttribute(typeof(HTMLTaskPaneObjectWrapper))] 
public interface HTMLTaskPaneObject : HTMLTaskPane, 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 HTMLTaskPane.

L'objet HTMLTaskPane fournit des propriétés et méthodes permettant d'utiliser le volet Office personnalisé d'InfoPath. Il fournit également des propriétés et des méthodes de l'objet TaskPaneObject.

Les propriétés et méthodes 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 la valeur 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 TaskPane.

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

Remarque
Les propriétés et méthodes de l'objet HTMLTaskPane ne peuvent pas être appelées pendant un événement _XDocumentEventSink2_OnLoadEventHandler car la vue n'est pas encore chargée lorsque cet événement se produit et les volets Office sont associés à la vue.

Exemple

Dans l'exemple suivant, la propriété P:Microsoft.Office.Interop.InfoPath.SemiTrust.TaskPanes.Item(System.Object) de la collection T:Microsoft.Office.Interop.InfoPath.SemiTrust.TaskPanesCollection est utilisée pour obtenir une référence à l'objet T:Microsoft.Office.Interop.InfoPath.SemiTrust.TaskPaneObject qui représente le volet Office personnalisé. Le code appelle ensuite la méthode Navigate de l'objet HTMLTaskPane pour ouvrir un fichier HTML.

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

Dans l'exemple suivant, la propriété Item de la collection TaskPanesCollection est utilisée pour obtenir une référence à l'objet TaskPaneObject 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 HTMLTaskPane, 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);
 }
}

Voir aussi

Référence

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

Partager via