пошаговое руководство. создание первой VSTO надстройки для PowerPoint

в этом пошаговом руководстве показано, как создать надстройку VSTO для Microsoft Office PowerPoint. Функции, создаваемые в подобном решении, доступны для приложения независимо от того, какие презентации открыты. дополнительные сведения см. в статье Office solutions development overview (VSTO).

Применимо к: Сведения в этом разделе относятся к добавлению VSTO - в проекты для PowerPoint. Дополнительные сведения см. в разделе доступность функций по типам приложений Office и проектов.

В этом пошаговом руководстве описаны следующие задачи:

создание проекта надстройки VSTO для PowerPoint;

написание кода, использующего объектную модель PowerPoint для добавления текстового поля в каждый новый слайд;

Построение и запуск проекта для тестирования.

очистка проекта для прекращения автоматического запуска надстройки VSTO на компьютере разработчика.

Отображаемые на компьютере имена или расположения некоторых элементов пользовательского интерфейса Visual Studio могут отличаться от указанных в следующих инструкциях. Это зависит от имеющегося выпуска Visual Studio и используемых параметров. Дополнительные сведения см. в разделе Персонализация среды IDE.

Предварительные требования

Для выполнения этого пошагового руководства требуются следующие компоненты:

Выпуск Visual Studio, включающий инструменты разработчика Microsoft Office. Дополнительные сведения см. в статье Настройка компьютера для разработки решений Office.

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

Запустите среду Visual Studio.

В меню Файл укажите Создать, затем нажмите Проект.

В области шаблонов разверните узел Visual C# или Visual Basic, а затем узел Office/SharePoint.

В развернутом узле Office/SharePoint выберите узел Надстройки Office .

В списке шаблонов проектов выберите шаблон проекта надстройки VSTO для PowerPoint.

В поле имя введите фирстповерпоинтаддин.

Нажмите кнопку ОК.

Visual Studio создает проект фирстповерпоинтаддин и открывает файл кода ThisAddIn в редакторе.

Написание кода, добавляющего текст к каждому новому слайду

Затем добавьте код в файл ThisAddIn. Новый код использует объектную модель PowerPoint для добавления текстового поля в каждый новый слайд. По умолчанию файл кода ThisAddIn содержит следующий созданный код:

Частичное определение класса ThisAddIn . Этот класс предоставляет точку входа для кода и обеспечивает доступ к объектной модели PowerPoint. дополнительные сведения см. в статье надстройки программы VSTO. Оставшаяся часть ThisAddIn класса определяется в скрытом файле кода, который не следует изменять.

Обработчики событий ThisAddIn_Startup и ThisAddIn_Shutdown . Эти обработчики событий вызываются, когда PowerPoint загружает и выгружает надстройку VSTO. Их можно использовать для инициализации надстройки VSTO в процессе ее загрузки, а также для освобождения ресурсов, используемых вашей надстройкой VSTO при ее выгрузке. дополнительные сведения см. в разделе события в Office проектах.

В файл кода ThisAddIn добавьте в класс ThisAddIn указанный ниже код. Этот код определяет обработчик событий для Microsoft. Office. Com. PowerPoint. Событие EApplication_Event. Пресентатионневслиде объекта приложения .

Когда пользователь добавляет новый слайд в активную презентацию, этот обработчик событий добавляет текстовое поле в верхнюю часть нового слайда, а также добавляет в поле текст.

Если используется C#, добавьте в обработчик событий ThisAddIn_Startup указанный ниже код. Этот код необходим для подключения Application_PresentationNewSlide обработчика событий к Microsoft. Office. Com. PowerPoint. Событие EApplication_Event. Пресентатионневслиде .

Для изменения каждого нового слайда в приведенных выше примерах кода используются следующие объекты:

Поле Application класса ThisAddIn . Application Поле возвращает объект приложения , который представляет текущий экземпляр PowerPoint.

Sld Параметр обработчика событий для Microsoft. Office. Com. PowerPoint. Событие EApplication_Event. Пресентатионневслиде . Sld Параметр является объектом слайда , который представляет новый слайд. дополнительные сведения см. в разделе PowerPoint solutions.

Тестирование проекта

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

Нажмите клавишу F5 для построения и запуска проекта.

При построении проекта код компилируется в сборку, которая включается в выходную папку сборки для проекта. Visual Studio также создает ряд записей реестра, которые позволяют PowerPoint обнаружить и загрузить надстройку VSTO, и настраивает параметры безопасности на компьютере разработчика, разрешая запуск надстройки VSTO. дополнительные сведения см. в разделе Build Office solutions.

В PowerPoint добавьте новый слайд в активную презентацию.

Убедитесь, что следующий текст добавляется в новое текстовое поле в верхней части слайда.

Этот текст добавляется с помощью кода.

Очистить проект

Завершив разработку проекта, удалите с компьютера сборку надстройки VSTO, записи реестра и параметры безопасности. В противном случае надстройка VSTO будет запускаться при каждом открытии PowerPoint на компьютере разработчика.

1. В Visual Studio в меню Построение выберите пункт Очистить решение.

Дальнейшие действия

Теперь, когда вы создали базовую надстройку VSTO для PowerPoint, изучите более подробную информацию о разработке надстроек VSTO в следующих разделах:

Общие задачи программирования, которые можно выполнять в надстройках VSTO для PowerPoint. дополнительные сведения см. в статье надстройки программы VSTO.

Использование объектной модели PowerPoint. дополнительные сведения см. в разделе PowerPoint solutions.

Настройка пользовательского интерфейса PowerPoint, например, путем добавления настраиваемой вкладки на ленту или создания собственной настраиваемой области задач. дополнительные сведения см. в разделе Office настройка пользовательского интерфейса.

Построение и отладка надстроек VSTO для PowerPoint. дополнительные сведения см. в разделе Build Office solutions.

Развертывание надстроек VSTO для PowerPoint. дополнительные сведения см. в разделе Deploy a Office solution.