CustomTaskPaneCollection.Add メソッド (UserControl, String, Object)

[アーティクル]
08/09/2011

新しい CustomTaskPane を作成し、現在の CustomTaskPaneCollection に追加します。カスタム作業ウィンドウは、指定された UserControl に基づき、指定されたタイトルがあり、指定されたアプリケーションウィンドウに関連付けられています。

名前空間: Microsoft.Office.Tools
アセンブリ: Microsoft.Office.Tools.Common (Microsoft.Office.Tools.Common.dll 内)

構文

'宣言
Function Add ( _
    control As UserControl, _
    title As String, _
    window As Object _
) As CustomTaskPane

CustomTaskPane Add(
    UserControl control,
    string title,
    Object window
)

パラメーター

control
型: System.Windows.Forms.UserControl
新しいカスタム作業ウィンドウのユーザーインターフェイスを提供する UserControl。

title
型: System.String
新しいカスタム作業ウィンドウのタイトルバーに表示されるテキスト。

window
型: System.Object
新しいカスタム作業ウィンドウを関連付けるアプリケーションウィンドウを表すオブジェクト。

戻り値

型: Microsoft.Office.Tools.CustomTaskPane
新しいカスタム作業ウィンドウを表す CustomTaskPane。

例外

例外	条件
ArgumentNullException	control または title が nullnull 参照 (Visual Basic では Nothing) です。
ObjectDisposedException	Dispose() メソッドは既に、CustomTaskPaneCollection で呼び出されています。

解説

特定のアプリケーションウィンドウに関連付けられている新しい CustomTaskPane を作成するには、このメソッドを使用します。このメソッドは、Outlook で複数のエクスプローラーウィンドウやインスペクターウィンドウを表示したり、Word や InfoPath で複数の文書を表示したりするカスタム作業ウィンドウを作成する場合に便利です。詳細については、「複数のアプリケーションウィンドウでカスタム作業ウィンドウを管理する」を参照してください。

window パラメーターの型はアプリケーションによって異なります。次の表に、window パラメーターの有効な型を示します。

アプリケーション	パラメーターの型
Word	Microsoft.Office.Interop.Word.Window
Excel	Microsoft.Office.Interop.Excel.Window
PowerPoint	Microsoft.Office.Interop.PowerPoint.DocumentWindow
InfoPath	Microsoft.Office.Interop.InfoPath.WindowObject
Outlook	Microsoft.Office.Interop.Outlook.Explorer または Microsoft.Office.Interop.Outlook.Inspector

CustomTaskPaneCollection は CustomTaskPane オブジェクトのコレクションですが、Add メソッドは、CustomTaskPane オブジェクトではなく UserControl オブジェクトを受け入れます。詳細については、「カスタム作業ウィンドウの概要」を参照してください。