HTMLTaskPaneObject インターフェイス

[アーティクル]
04/27/2010

ウィンドウに関連付けられている、Microsoft Office InfoPath 2007 フォーム内のカスタム作業ウィンドウを表します。

名前空間: Microsoft.Office.Interop.InfoPath
アセンブリ: Microsoft.Office.Interop.InfoPath (microsoft.office.interop.infopath.dll 内)

構文

'宣言
<GuidAttribute("096CD548-0786-11D1-95FA-0080C78EE3BB")> _
<CoClassAttribute(GetType(HTMLTaskPaneObjectClass))> _
Public Interface HTMLTaskPaneObject
    Inherits HTMLTaskPane
'使用
Dim instance As HTMLTaskPaneObject

[GuidAttribute("096CD548-0786-11D1-95FA-0080C78EE3BB")] 
[CoClassAttribute(typeof(HTMLTaskPaneObjectClass))] 
public interface HTMLTaskPaneObject : HTMLTaskPane

この型は、COM 相互運用のためにマネージコードで必要とされるコクラスのラッパーです。この型を使用して、このコクラスによって実装される COM インターフェイスのメンバにアクセスします。COM インターフェイスについては (このメンバの説明へのリンクを含む)、次を参照してください HTMLTaskPane.

HTMLTaskPane オブジェクトは、InfoPath のカスタム作業ウィンドウを操作する複数のプロパティとメソッドを提供し、さらに TaskPaneObject オブジェクトのプロパティとメソッドも提供します。

InfoPath の作業ウィンドウに対して使用できるプロパティとメソッドは、対象となる作業ウィンドウの種類によって決まります。TaskPaneType プロパティが 0 を返す場合、作業ウィンドウはカスタム作業ウィンドウであり、使用可能なプロパティとメソッドは HTMLTaskPane オブジェクトによって提供されます。TaskPaneType プロパティがその他の値を返す場合、作業ウィンドウは組み込み作業ウィンドウであり、プロパティは TaskPane オブジェクトによって提供されます。

TaskPaneType プロパティは、XdTaskPaneType 列挙に基づいています。列挙値は、指定した種類の作業ウィンドウへの参照を返すために、TaskPanesCollection コレクションの Item プロパティに対する引数としても使用されます。

メモ :
_XDocumentEventSink2_OnLoadEventHandler イベントの発生時にはビューがまだ読み込まれておらず、作業ウィンドウはビューに関連付けられているため、このイベント中に HTMLTaskPane オブジェクトのプロパティやメソッドを呼び出すことはできません。

例

次の例では、T:Microsoft.Office.Interop.InfoPath.TaskPanesCollection コレクションの P:Microsoft.Office.Interop.InfoPath.TaskPanes.Item(System.Object) プロパティを使用して、カスタム作業ウィンドウを表す T:Microsoft.Office.Interop.InfoPath.TaskPaneObject オブジェクトへの参照を取得します。次に、HTMLTaskPane オブジェクトの Navigate メソッドを呼び出し、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");
}

次の例では、TaskPanesCollection コレクションの Item プロパティを使用して、カスタム作業ウィンドウを表す TaskPaneObject オブジェクトへの参照を取得します。次に、TaskPane オブジェクトから継承される HTMLTaskPane オブジェクトの HTMLDocument プロパティを使用して、カスタム作業ウィンドウの HTML コード内で定義されているスクリプト関数を呼び出します。

// 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 インターフェイス

構文

コメント

例

関連項目

参照

その他のリソース