HtmlTaskPane.HtmlWindow, propriété

Article
04/27/2010

Obtient une référence à l'interface IHTMLWindow2 MSHTML pour travailler avec le document HTML d'un volet Office personnalisé.

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

Syntaxe

Public MustOverride ReadOnly Property HtmlWindow As Object

Dim instance As HtmlTaskPane
Dim value As Object

value = instance.HtmlWindow

public abstract Object HtmlWindow { get; }

Valeur de la propriété

Objet IHTMLWindow2 associé au fichier HTML du volet Office personnalisé.

Exceptions

Type d'exception	Condition
SecurityException	Le modèle de formulaire n'est pas configuré en Autorisation totale avec la catégorie Sécurité et approbation de la boîte de dialogue Options de formulaire.

Remarques

La propriété HtmlWindow permet d'appeler des fonctions de script contenues dans le code HTML du volet Office à partir du code de formulaire principal, de manipuler le code HTML du volet Office et de travailler avec n'importe quelle propriété et méthode fournie par l'interface IHTMLWindow2.

Remarque
La propriété HtmlWindow propose la même fonctionnalité que la propriété HtmlDocument, mais n'est disponible qu'avec des formulaires en autorisation totale. Si le formulaire ne dispose pas d'une autorisation totale, vous pouvez utiliser la propriété HtmlDocument à la place.

Ce membre est accessible uniquement par les formulaires ouverts à partir d'un modèle de formulaire configuré pour être exécuté avec des autorisations totales à l'aide de la catégorie Sécurité et approbation de la boîte de dialogue Options de formulaire. Ce membre nécessite une autorisation totale pour l'appelant immédiat et ne peut pas être utilisé par un code partiellement fiable. Pour plus d'informations, voir « Using Libraries from Partially Trusted Code » (en anglais) sur MSDN.

Ce type ou ce membre est uniquement accessible à partir du code exécuté dans les formulaires ouverts dans Microsoft Office InfoPath 2007.

Exemple

Dans l'exemple suivant, la propriété HtmlWindow de la classe HtmlTaskPane est utilisée pour définir une référence à l'objet IHTMLWindow2 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é.

   // Get a reference to the custom task pane. It is always index [0]
   // in the TaskPanes collection.
   HtmlTaskPane custom = (Microsoft.Office.InfoPath.HtmlTaskPane)
      this.CurrentView.Window.TaskPanes[0];

   // Get a reference to the parent window of the task pane.
   IHTMLWindow2 window = (IHTMLWindow2)custom.HtmlWindow;

   // Call into script through CLR late binding mechanism.
   window.GetType().InvokeMember(
      "TaskPaneSwitchView",      // late bound method name.
      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);   // method arguments

   ' Get a reference to the custom task pane. It is always index (0)
   ' in the TaskPanes collection.
   Dim custom As HtmlTaskPane = _
      DirectCast(Me.CurrentView.Window.TaskPanes(0), _
      Microsoft.Office.InfoPath.HtmlTaskPane)

     ' Get a reference to the parent window of the task pane.
      Dim window As IHTMLWindow2 = DirectCast(custom.HtmlWindow, _
         IHTMLWindow2

     ' Call into script through CLR late binding mechanism.
     window.GetType().InvokeMember( _
      "TaskPaneSwitchView", _
      System.Reflection.BindingFlags.InvokeMethod Or _
      System.Reflection.BindingFlags.DeclaredOnly Or _
      System.Reflection.BindingFlags.Public Or _
      System.Reflection.BindingFlags.Instance, _
      Nothing, _
      window, _
      Nothing)

Voir aussi

Référence

HtmlTaskPane, classe
Membres HtmlTaskPane
Microsoft.Office.InfoPath, espace de noms

Partager via