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
)
参数
- 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 参数的有效类型。
Application |
参数类型 |
---|---|
Word |
|
Excel |
|
PowerPoint |
Microsoft.Office.Interop.PowerPoint.DocumentWindow |
InfoPath |
|
Outlook |
Microsoft.Office.Interop.Outlook.Explorer - 或 - |
虽然 CustomTaskPaneCollection 是 CustomTaskPane 对象的集合,但是 Add 方法接受 UserControl 对象而不是 CustomTaskPane 对象。 有关更多信息,请参见自定义任务窗格。
.NET Framework 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。