Программирование надстроек уровня приложения

Статья
04/28/2010

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

Применение
Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям Microsoft Office. Тип проекта Проекты уровня приложения Версия Microsoft Office Выпуск системы Microsoft Office 2007 Microsoft Office 2003 Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

Сведения, приведенные в данном разделе, относятся только к указанным проектам Visual Studio Tools for Office и версиям Microsoft Office.

Тип проекта

Проекты уровня приложения

Версия Microsoft Office

Выпуск системы Microsoft Office 2007
Microsoft Office 2003

Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

При расширении приложения Microsoft Office путем создания надстройки Visual Studio Tools for Office код создается непосредственно для класса ThisAddIn данного проекта. Этот класс можно использовать для получения доступа к объектной модели ведущего приложения Microsoft Office, настройки пользовательского интерфейса приложения, а также для предоставления объектов созданной надстройки другим решениям Office.

Общие сведения о надстройках уровня приложения и других типах решений, которые можно создать при помощи Visual Studio Tools for Office, см. в разделе Общие сведения о разработке решений Office.

Создание кода в проекте надстройки

Код надстройки можно начать писать в классе ThisAddIn. Visual Studio Tools for Office автоматически генерирует этот класс в файле кода ThisAddIn.vb (для Visual Basic) или в файле ThisAddIn.cs (для C#) в проекте надстройки.

В классе ThisAddIn существует два обработчика событий по умолчанию. Для выполнения кода при загрузке надстройки следует добавить код в обработчик событий ThisAddIn_Startup. Для выполнения кода непосредственно перед выгрузкой надстройки следует добавить код в обработчик событий ThisAddIn_Shutdown. Дополнительные сведения см. в разделе Инструменты Visual Studio для событий проекта Office.

Класс ThisAddIn наследует большинство своих функций от класса AddIn. Класс AddIn предоставляет основные функциональные возможности, используемые всеми надстройками Visual Studio Tools for Office. Дополнительные сведения о классе AddIn см. в разделе Ведущий элемент AddIn.

Доступ к объектной модели ведущего приложения

Доступ к объектной модели ведущего приложения можно получить с помощью поля Application класса ThisAddIn. Это поле возвращает объект, представляющий текущий экземпляр ведущего приложения.

Следующий пример кода показывает способ использования поля Application для создания новой рабочей книги в надстройке для Microsoft Office Excel. Этот пример предназначен для запуска из класса ThisAddIn.

Dim newWorkbook As Excel.Workbook = Me.Application.Workbooks.Add()

Excel.Workbook newWorkbook = this.Application.Workbooks.Add(System.Type.Missing);

Следует делать то же самое вне класса ThisAddIn: для получения доступа к классу ThisAddIn используйте объект Globals. Дополнительные сведения об объекте Globals см. в разделе Глобальный доступ к объектам в Visual Studio Tools for Office.

Dim newWorkbook As Excel.Workbook = Globals.ThisAddIn.Application.Workbooks.Add()

Excel.Workbook newWorkbook = Globals.ThisAddIn.Application.Workbooks.Add(System.Type.Missing);

Следующая таблица описывает тип возвращаемого значения для поля Application в каждом проекте надстройки:

Ведущее приложение	Тип возвращаемого значения
Microsoft Office Excel	Microsoft.Office.Interop.Excel.Application
Microsoft Office InfoPath	Microsoft.Office.Interop.InfoPath.Application
Microsoft Office Outlook	Microsoft.Office.Interop.Outlook.Application
Microsoft Office PowerPoint	Microsoft.Office.Interop.PowerPoint.Application
Microsoft Office Project	Microsoft.Office.Interop.MSProject.Application
Microsoft Office Visio	Microsoft.Office.Interop.Visio.Application
Microsoft Office Word	Microsoft.Office.Interop.Word.Application

Настройка пользовательского интерфейса приложений Microsoft Office

С помощью надстройки уровня приложения можно программными средствами настроить пользовательский интерфейс для приложений Microsoft Office. Для систем Microsoft Office 2003 в пользовательском интерфейсе можно в том числе настроить меню и панели инструментов. Для приложений в выпуске 2007 системы Microsoft Office возможна настройка других элементов пользовательского интерфейса. В число этих элементов входят лента, пользовательские области задач и области формы Outlook. Дополнительные сведения см. в разделе Настройка пользовательского интерфейса Office.

Visual Studio Tools for Office предоставляет конструкторы и классы, которые можно использовать для создания пользовательских областей задач, настроек ленты и областей формы Outlook. Использование таких классов и конструкторов позволяет упростить настройку этих функций. Дополнительные сведения см. в разделах Общие сведения о настраиваемых областях задач, Конструктор лент и Создание областей форм Outlook.

Если какую-либо функцию необходимо настроить способом, который не поддерживается классами и конструкторами Visual Studio Tools for Office, это можно выполнить путем реализации в надстройке интерфейса расширяемости. Дополнительные сведения см. в разделе Настройка функций пользовательского интерфейса с помощью интерфейсов расширяемости.

Начиная с Visual Studio 2008 с пакетом обновления 1 (SP1), можно изменять пользовательский интерфейс документов Word и книг Excel путем создания ведущих элементов, которые расширяют функциональные возможности документов и книг. Это позволяет добавлять управляемые элементы управления и смарт-теги Visual Studio Tools for Office в документы и листы. Дополнительные сведения см. в разделе Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения.

Вызов кода в надстройках уровня приложения из других решений Office

Объекты в надстройке можно предоставлять другим решениям Microsoft Office. Это может понадобиться в тех случаях, если надстройка предоставляет службу, которую необходимо использовать в других решениях Office. Например, если надстройка для Microsoft Office Excel выполняет вычисления финансовых данных из веб-службы, то другие решения Office смогут выполнять такие вычисления путем вызова этой надстройки в Excel во время выполнения.

Дополнительные сведения см. в разделе Вызов кода в надстройках уровня приложения из других решений Office.