Proprietà HtmlTaskPane.HtmlDocument

Ottiene un riferimento all'interfaccia IHTMLDocument2 MSHTML per l'utilizzo del modello a oggetti del documento HTML di un riquadro attività personalizzato.

Spazio dei nomi: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)

Sintassi

Public MustOverride ReadOnly Property HtmlDocument As Object

Dim instance As HtmlTaskPane
Dim value As Object

value = instance.HtmlDocument

public abstract Object HtmlDocument { get; }

Valore proprietà

Oggetto IHTMLDocument2 associato al file HTML del riquadro attività personalizzato.

Osservazioni

Utilizzando la proprietà HtmlDocument è possibile chiamare funzioni di script incluse nel codice HTML del riquadro attività tramite associazione tardiva, come illustrato nel secondo esempio riportato di seguito. È inoltre possibile modificare direttamente il codice HTML del riquadro attività utilizzando qualsiasi proprietà o metodo implementato dall'interfaccia IHTMLDocument2.

Per utilizzare l'oggetto IHTMLDocument2 restituito dalla proprietà HtmlDocument, è necessario aggiungere un riferimento a Microsoft.mshtml nella scheda .NET della finestra di dialogo Aggiungi riferimento di Microsoft Visual Studio Tools for Applications (VSTA) o Visual Studio. È inoltre necessario eseguire il cast dell'oggetto restituito dalla proprietà HtmlDocument al tipo IHTMLDocument2 .

Possono accedere a questo membro solo moduli eseguiti nello stesso dominio del modulo aperto oppure moduli a cui sono state concesse autorizzazioni tra domini.

A questo tipo o membro può accedere solo il codice in esecuzione in moduli aperti in Microsoft Office InfoPath 2007.

Esempio

L'esempio seguente presuppone che sia presente una direttiva using mshtml; o Imports mshtml nella sezione delle dichiarazioni del file di codice del modulo.

Nell'esempio seguente viene utilizzata la proprietà HtmlDocument della classe HtmlTaskPane per impostare un riferimento all'oggetto window HTML del riquadro attività personalizzato di un modulo completamente attendibile. Viene quindi cambiato il colore di sfondo del riquadro attività.

// 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 custom task pane document and cast to
// the IHTMLDocument2 type.
IHTMLDocument2 oHTMLdoc = (IHTMLDocument2)(custom.HtmlDocument);

// Change custom task pane background color to red.
oHTMLdoc.bgColor = "red";

' 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 custom task pane document and cast to
' the IHTMLDocument2 type.
IHTMLDocument2 oHTMLdoc = _
   DirectCast(custom.HtmlDocument,IHTMLDocument2)

' Change custom task pane background color to red.
oHTMLdoc.bgColor = "red"

Nell'esempio seguente viene utilizzata la proprietà HtmlDocument della classe HtmlTaskPane per impostare un riferimento all'oggetto window HTML del riquadro attività personalizzato di un modulo completamente attendibile. Viene quindi chiamata la funzione personalizzata TaskPaneSwitchView definita nel codice HTML del riquadro attività personalizzato.

   // 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 custom task pane document.
   IHTMLDocument2 oHTMLdoc = (IHTMLDocument2)custom.HtmlDocument;

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

   // 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 custom task pane document.
   Dim oHTMLdoc As IHTMLDocument2 = DirectCast(
      custom.HtmlDocument, IHTMLDocument2)

     ' Get a reference to the parent window of the task pane.
      Dim window As IHTMLWindow2 = DirectCast(oHTMLdoc.parentWindow, _
         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)

Vedere anche

Riferimenti

Classe HtmlTaskPane
Membri HtmlTaskPane
Spazio dei nomi Microsoft.Office.InfoPath

Last updated on 2010-04-27