HtmlTaskPane.HtmlDocument Свойство

Определение

Пространство имен:

Microsoft.Office.InfoPath

Сборка:

Microsoft.Office.InfoPath.dll

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

public:
 abstract property System::Object ^ HtmlDocument { System::Object ^ get(); };

public abstract object HtmlDocument { get; }

member this.HtmlDocument : obj

Public MustOverride ReadOnly Property HtmlDocument As Object

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

Object

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

Примеры

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

В следующем примере свойство HtmlTaskPaneHtmlDocument класса используется для задания ссылки на объект окна 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)

Комментарии

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

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

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

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