Ведущий элемент AddIn
Обновлен: Июль 2008
Применение |
|---|
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта
Версия Microsoft Office
Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов. |
Класс 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 таким образом, чтобы он возвращал экземпляр класса, реализующего интерфейс. Дополнительные сведения см. в разделе Настройка функций пользовательского интерфейса с помощью интерфейсов расширяемости. .gif "Примечание") Примечание.
Чтобы настроить пользовательский интерфейс ленты, переопределите метод CreateRibbonExtensibilityObject.
|
См. также
Задачи
Пошаговое руководство. Вызов кода из VBA в настройках на уровне приложения
Основные понятия
Программирование надстроек уровня приложения
Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения
Настройка функций пользовательского интерфейса с помощью интерфейсов расширяемости
Вызов кода в надстройках уровня приложения из других решений Office
Приступая к программированию надстроек на уровне приложения
Инструменты Visual Studio для событий проекта Office
Журнал изменений
Дата |
Журнал |
Причина |
|---|---|---|
Июль 2008 |
Добавлены сведения о порядке добавления в документы смарт-тегов с помощью надстроек уровня приложения. |
Изменение функции SP1. |