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

创建新的 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
)

参数

  • 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

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

虽然 CustomTaskPaneCollectionCustomTaskPane 对象的集合,但是 Add 方法接受 UserControl 对象而不是 CustomTaskPane 对象。 有关更多信息,请参见 自定义任务窗格概述

.NET Framework 安全性

请参见

参考

CustomTaskPaneCollection 接口

Add 重载

Microsoft.Office.Tools 命名空间

其他资源

自定义任务窗格概述

在多个应用程序窗口中管理自定义任务窗格