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

Статья
08/11/2011

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

Заметки

Этот метод используется для создания новой CustomTaskPane, которая связана с указанным окном приложения. Этот метод полезен, если необходимо создать настраиваемые области задач, отображаемые в нескольких инспекторах или проводниках Outlook либо в нескольких документах Word или InfoPath. Дополнительные сведения см. в разделе Управление настраиваемыми областями задач в нескольких окнах приложений.

Тип параметра window зависит от приложения. В следующей таблице приведены допустимые типы параметра window.

Application	Тип параметра
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

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