Интерфейс HTMLTaskPaneObject

Статья
04/27/2010

Представляет настраиваемую область задач в форме Microsoft Office InfoPath 2007, которая связана с окном.

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

Синтаксис

'Декларация
<GuidAttribute("096cd548-0786-11d1-95fa-0080c78ee3bb")> _
<CLSCompliantAttribute(False)> _
<CoClassAttribute(GetType(HTMLTaskPaneObjectWrapper))> _
Public Interface HTMLTaskPaneObject
    Inherits HTMLTaskPane, TaskPane
'Применение
Dim instance As HTMLTaskPaneObject

[GuidAttribute("096cd548-0786-11d1-95fa-0080c78ee3bb")] 
[CLSCompliantAttribute(false)] 
[CoClassAttribute(typeof(HTMLTaskPaneObjectWrapper))] 
public interface HTMLTaskPaneObject : HTMLTaskPane, TaskPane

Заметки

Этот тип является программой-оболочкой для компонентного класса, которого требует управляемый программный код для COM-взаимодействия. Используйте этот тип для доступа к членам интерфейса COM, созданного этим компонентным классом. Дополнительные сведения об интерфейсе COM, включая ссылку на описания его членов, см. в статье HTMLTaskPane.

Объект HTMLTaskPane предоставляет ряд свойств и методов для работы с настраиваемой областью задач InfoPath, а также свойства и методы объекта TaskPaneObject.

Свойства и методы, доступные для области задач InfoPath, определяются типом рабочей области задач. Если свойство TaskPaneType возвращает 0, область задач является настраиваемой, а доступные свойства и методы предоставляются объектом HTMLTaskPane. Если свойство TaskPaneType возвращает любое другое значение, область задач является встроенной, а свойства предоставляются объектом TaskPane.

Свойство TaskPaneType основывается на списке XdTaskPaneType. Эти значения списка также используются в качестве аргументов для свойства Item коллекции TaskPanesCollection, чтобы возвратить ссылку на определенный тип области задач.

Заметка
Свойства и методы объекта HTMLTaskPane невозможно вызвать в ходе события _XDocumentEventSink2_OnLoadEventHandler, поскольку представление еще не загружено, когда происходит это событие, а области задач связаны с этим представлением.

Пример

В следующем примере свойство P:Microsoft.Office.Interop.InfoPath.SemiTrust.TaskPanes.Item(System.Object) коллекции T:Microsoft.Office.Interop.InfoPath.SemiTrust.TaskPanesCollection служит для назначения ссылки на объект T:Microsoft.Office.Interop.InfoPath.SemiTrust.TaskPaneObject, представляющий настраиваемую область задач. В таком случае код вызывает метод Navigate объекта HTMLTaskPane, чтобы открыть файл HTML.

public void CustomTaskPaneNavigation()
{
 // 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];

 // Navigate based on url specified.
 oTaskPane.Navigate("taskpane2.html");
}

В следующем примере свойство Item коллекции TaskPanesCollection используется для получения ссылки на объект TaskPaneObject, который представляет настраиваемую область задач. Код затем вызывает выполнение сценария функции, заданной в HTML-коде настраиваемой области задач с помощью свойства HTMLDocument объекта HTMLTaskPane, который наследуется объектом TaskPane.

// Ensure View has loaded before trying to access the task pane.
if (thisXDocument.View != null)
{
 // Get a reference to the custom task pane.  It is always the 0-th
 // task pane in the TaskPanes collection.
 HTMLTaskPane custom = (HTMLTaskPane) thisXDocument.View.Window.TaskPanes[0];

 // Ensure that the task pane is completely loaded.
 if (custom != null && custom.HTMLDocument.readyState == "complete")
 {
  mshtml.IHTMLWindow2 window = custom.HTMLDocument.parentWindow;

  object[] args =  new object[] {"ViewID"};

  // call into script through CLR late binding mechanism
  window.GetType().InvokeMember(
   "SelectView",      // 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
   args);
 }
}

См. также

Ссылка

Члены HTMLTaskPaneObject
Пространство имен Microsoft.Office.Interop.InfoPath.SemiTrust

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