Свойство HtmlTaskPane.HtmlDocument

Статья
04/27/2010

Возвращает ссылку на интерфейс IHTMLDocument2 MSHTML для работы с объектной моделью HTML-документа настраиваемой области задач.

Пространство имен: Microsoft.Office.InfoPath
Сборка: Microsoft.Office.InfoPath (в microsoft.office.infopath.dll)

Синтаксис

'Декларация
Public MustOverride ReadOnly Property HtmlDocument As Object
'Применение
Dim instance As HtmlTaskPane
Dim value As Object

value = instance.HtmlDocument

public abstract Object HtmlDocument { get; }

Значение свойства

Объект IHTMLDocument2, связанный с HTML-файлом настраиваемой области задач.

Заметки

С помощью свойства HtmlDocument можно вызвать выполнение сценария для функций, содержащихся в HTML-коде области задач, через позднее привязывание, как показано во втором примере ниже. Можно также напрямую управлять HTML-кодом области задач с помощью любых свойств и методов, предоставляемых интерфейсом IHTMLDocument2.

Для работы с объектом IHTMLDocument2, возвращенным свойством HtmlDocument, необходимо добавить ссылку на объект Microsoft.mshtml на вкладке диалогового окна в приложении Набор средств Microsoft Visual Studio для приложений (VSTA) или Visual Studio. Дополнительно, необходимо преобразовать объект, возвращенный свойством HtmlDocument, в тип IHTMLDocument2 .

Доступ к этому члену имеется только у форм, запускаемых на том же домене, что и открытая в настоящий момент форма, или у форм, которым были присвоены междоменные разрешения.

Доступ к этому типу или члену имеется только из программы, работающей в формах, открытых в Microsoft Office InfoPath 2007.

Пример

В следующих примерах предполагается, что в разделе описаний файла кода формы имеется директива using mshtml; или Imports mshtml.

В следующем примере свойство HtmlDocument класса HtmlTaskPane используется для установки ссылки на объект window HTML настраиваемой области задач полностью доверенной формы. Затем код изменяет цвет фона настраиваемой области задач.

// 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"

В следующем примере свойство HtmlDocument класса HtmlTaskPane используется для установки ссылки на объект window HTML настраиваемой области задач полностью доверенной формы. Затем код вызывает настраиваемую функцию TaskPaneSwitchView, которая определяется в HTML-коде настраиваемой области задач.

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

См. также

Ссылка

Класс HtmlTaskPane
Члены HtmlTaskPane
Пространство имен Microsoft.Office.InfoPath

Поделиться через