CustomTaskPaneCollection.Add - метод (UserControl, String, Object)

Статья
05/19/2013

Создает новый объект 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 — nullссылка NULL (Nothing в Visual Basic).
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 принимает объекты UserControl вместо объектов CustomTaskPane.Дополнительные сведения см. в разделе Настраиваемые области задач.

Безопасность платформы .NET Framework

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