CustomTaskPaneCollection.Add Метод (UserControl, String, Object) (2007 System)

Статья
11/16/2008

Обновлен: Ноябрь 2007

Создает новый объект 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 имеет значение nullссылка null (Nothing в Visual Basic).
ObjectDisposedException	Метод Dispose уже вызван для CustomTaskPaneCollection.

Заметки

Этот метод используется для создания новой 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

Хотя класс CustomTaskPaneCollection является коллекцией объектов CustomTaskPane метод Add принимает объекты UserControl вместо объектов CustomTaskPane. Дополнительные сведения см. в разделе Общие сведения о настраиваемых областях задач.

Разрешения

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.