Ведущий элемент AddIn

Обновлен: Июль 2008

Класс Microsoft.Office.Tools.AddIn является ведущим элементом для надстроек уровня приложений, создаваемых с помощью Visual Studio Tools for Office. Ведущий элемент — это класс в решении Visual Studio Tools for Office, предоставляющий точку входа для кода. 

Общие сведения о классах AddIn и ThisAddIn

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

Вместо этого используйте класс ThisAddIn. Visual Studio Tools for Office создает в проекте надстройки этот класс, обеспечивающим взаимосвязь приложений Microsoft Office и кода надстройки. Класс ThisAddIn является производным от класса AddIn. Visual Studio Tools for Office автоматически создает экземпляр этого класса при загрузке надстройки приложением Microsoft Office.

Класс ThisAddIn предоставляет местоположение, в котором можно начать написание кода в проекте. Класс ThisAddIn также можно использовать для выполнения таких задач, как доступ к объектной модели ведущего приложения. Дополнительные сведения см. в разделе Программирование надстроек уровня приложения.

Использование классов AddIn и ThisAddIn в проектах надстроек Outlook 2007

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

В проектах надстроек для Outlook 2007 класс ThisAddIn является производным от класса OutlookAddIn. Класс ThisAddIn используется в надстройках Outlook 2007 точно так же, как и в надстройках для других приложений Microsoft Office.

Члены класса, используемые в различных задачах

В приведенной ниже таблице описаны наиболее распространенные задачи и показано, какие члены класса ThisAddIn можно использовать для выполнения соответствующей задачи.

Задача	Используемые члены класса
Выполнение кода для инициализации надстройки при ее загрузке.	Добавьте код в метод ThisAddIn_Startup. Этот метод является обработчиком событий Startup по умолчанию. Дополнительные сведения см. в разделе Инструменты Visual Studio для событий проекта Office.
Выполнение кода для очистки ресурсов, используемых надстройкой, перед выгрузкой надстройки.	Добавьте код в метод ThisAddIn_Shutdown. Этот метод является обработчиком событий Shutdown по умолчанию. Дополнительные сведения см. в разделе Инструменты Visual Studio для событий проекта Office.
Автоматизация ведущего приложения путем доступа к объектной модели.	Используйте поле Application класса ThisAddIn. Это поле возвращает экземпляр класса Application приложения, с которым работает надстройка. Дополнительные сведения см. в разделе Программирование надстроек уровня приложения.
Создайте смарт-тег, который может распознаваться любым открытым документом Word или рабочей книгой Excel. До Visual Studio 2008 с пакетом обновления 1 (SP 1) данная функциональная возможность не использовалась.	Используйте поле VstoSmartTags класса ThisAddIn. Данное поле доступно только в проектах надстройки для Excel 2007 и Word 2007, созданных после установки пакета обновлений 1. Дополнительные сведения см. в разделе Общие сведения о смарт-тегах.
Представление объектов в надстройке другим решениям Microsoft Office.	Переопределите метод RequestComAddInAutomationService. Дополнительные сведения см. в разделе Вызов кода в надстройках уровня приложения из других решений Office.
Настройка функции в выпуске 2007 системы Microsoft Office путем реализации интерфейса расширяемости.	Переопределите метод RequestService таким образом, чтобы он возвращал экземпляр класса, реализующего интерфейс. Дополнительные сведения см. в разделе Настройка функций пользовательского интерфейса с помощью интерфейсов расширяемости. Примечание. Чтобы настроить пользовательский интерфейс ленты, переопределите метод CreateRibbonExtensibilityObject.

См. также

Задачи

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

Основные понятия

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

Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения

Настройка функций пользовательского интерфейса с помощью интерфейсов расширяемости

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

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

Инструменты Visual Studio для событий проекта Office

Журнал изменений