HTMLTaskPane.HTMLDocument, propriété

Article
04/27/2010

Obtient une référence à un objet de document HTML du volet Office personnalisé Microsoft Office InfoPath 2007.

Cette propriété n'est pas conforme à la spécification CLS.

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

Syntaxe

<DispIdAttribute(4)> _
ReadOnly Property HTMLDocument As IHTMLDocument2

Dim instance As HTMLTaskPane
Dim value As IHTMLDocument2

value = instance.HTMLDocument

[DispIdAttribute(4)] 
IHTMLDocument2 HTMLDocument { get; }

Remarques

La propriété HTMLDocument de l'objet HTMLTaskPaneObject est l'une des propriétés héritées par l'objet TaskPaneObject lorsque le type de volet Office a la valeur 0, ce qui signifie qu'il s'agit du volet Office personnalisé.

La propriété HTMLDocument vous permet d'appeler des fonctions de script contenues dans le code HTML du volet Office par le biais de la liaison tardive, comme dans le deuxième exemple ci-dessous. Vous pouvez également manipuler directement le code HTML du volet Office à l'aide de n'importe quelle propriété et méthode fournie par l'objet document HTML.

Remarque
Avant d'utiliser la propriété HTMLDocument de l'objet HTMLTaskPaneObject, vous devez tout d'abord transmettre l'objet TaskPaneObject à un objet HTMLTaskPane, comme l'illustrent les exemples ci-après.

Important :
Ce membre est accessible uniquement par les formulaires qui s'exécutent dans le même domaine que le formulaire ouvert ou par les formulaires qui disposent d'autorisations indépendantes des domaines.

Exemple

Dans l'exemple suivant, la propriété HTMLDocument de l'objet HTMLTaskPane est utilisée pour définir une référence à l'objet Window HTML du volet Office personnalisé d'un formulaire avec autorisation totale. Le code change ensuite la couleur d'arrière-plan du volet Office.

Remarque
Les exemples suivants requièrent une référence à l'assembly Microsoft.mshtml.dll.

using mshtml;
public void ChangeBackgroundColor()
 {
 // 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];
  // Get a reference to the HTML document object of the custom task pane.
  IHTMLDocument2 oHTMLDoc = oTaskPane.HTMLDocument;
  // Change custom task pane background color to red.
  oHTMLDoc.bgColor = "red";
}

Dans l'exemple suivant, la propriété HTMLDocument de l'objet HTMLTaskPane est utilisée pour définir une référence à l'objet Window HTML du volet Office personnalisé d'un formulaire avec autorisation totale. Le code appelle ensuite la fonction personnalisée TaskPaneSwitchView définie dans le code HTML du volet Office personnalisé.

HTMLTaskPane custom = (HTMLTaskPane) thisXDocument.View.Window.TaskPanes[0];
mshtml.IHTMLWindow2 window = custom.HTMLDocument.parentWindow; 
// call into script through CLR late binding mechanism
custom.HTMLDocument.parentWindow.GetType().InvokeMember(
 "TaskPaneSwitchView",      // 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
 null);

Voir aussi

Référence

HTMLTaskPane, interface
Membres HTMLTaskPane
Microsoft.Office.Interop.InfoPath.SemiTrust, espace de noms

Partager via