CustomTaskPaneCollection.Add 方法 (UserControl, String, Object) (2007 system)

项目
09/04/2008

更新：2007 年 11 月

创建新的 CustomTaskPane 并将它添加到当前的 CustomTaskPaneCollection 中。自定义任务窗格基于指定的 UserControl，具有指定的标题，并且与指定的应用程序窗口关联。

命名空间： Microsoft.Office.Tools
程序集： Microsoft.Office.Tools.Common.v9.0（在 Microsoft.Office.Tools.Common.v9.0.dll 中）

语法

声明
Public Function Add ( _
    control As UserControl, _
    title As String, _
    window As Object _
) As CustomTaskPane
用法
Dim instance As CustomTaskPaneCollection
Dim control As UserControl
Dim title As String
Dim window As Object
Dim returnValue As CustomTaskPane

returnValue = instance.Add(control, title, _
    window)

public 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	已经对 CustomTaskPaneCollection 调用了 Dispose 方法。

备注

使用此方法可以新建与特定的应用程序窗口关联的 CustomTaskPane。如果要创建在 Outlook 中的多个检查器或资源管理器内或者在 Word 或 InfoPath 中的多个文档内可见的自定义任务窗格，此方法很有用。有关更多信息，请参见在多个应用程序窗口中管理自定义任务窗格。

window 参数的类型取决于应用程序。下表列出了 window 参数的有效类型。

应用程序	参数类型
Word 2007	Microsoft.Office.Interop.Word.Window
Excel 2007	Microsoft.Office.Interop.Excel.Window
PowerPoint 2007	Microsoft.Office.Interop.PowerPoint.DocumentWindow
InfoPath 2007	Microsoft.Office.Interop.InfoPath.WindowObject
Outlook 2007	Microsoft.Office.Interop.Outlook.Explorer - 或 - Microsoft.Office.Interop.Outlook.Inspector