Поделиться через


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

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

Применение

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

Тип проекта

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

Версия Microsoft Office

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

  • Microsoft Office 2003

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

Класс 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 таким образом, чтобы он возвращал экземпляр класса, реализующего интерфейс. Дополнительные сведения см. в разделе Настройка функций пользовательского интерфейса с помощью интерфейсов расширяемости.

Aa942742.alert_note(ru-ru,VS.90).gifПримечание.
Чтобы настроить пользовательский интерфейс ленты, переопределите метод CreateRibbonExtensibilityObject.

См. также

Задачи

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

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

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

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

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

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

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

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

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

Дата

Журнал

Причина

Июль 2008

Добавлены сведения о порядке добавления в документы смарт-тегов с помощью надстроек уровня приложения.

Изменение функции SP1.