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

Статья
02/20/2013

В данном пошаговом руководстве иллюстрируется порядок создания надстройки уровня приложения для Microsoft Office PowerPoint.Функциональные возможности, создаваемые в этом виде решения, доступны самому приложению независимо от типа открываемых презентаций.Дополнительные сведения см. в разделе Общие сведения о разработке решений Office.

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

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

Создание проекта надстройки PowerPoint для PowerPoint.
Создание кода, использующего объектную модель PowerPoint для добавления текстового поля к каждому новому слайду.
Построение и запуск проекта для тестирования.
Удаление проекта, чтобы надстройка больше не запускалась автоматически на компьютере разработчика.

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

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

ссылка на видео Для просмотра связанных демонстрационных видеороликов перейдите по ссылке How Do I: Create an Add-in for Microsoft PowerPoint?.

Обязательные компоненты

Ниже приведены компоненты, необходимые для выполнения данного пошагового руководства.

Выпуск Visual Studio 2012, включающий инструменты разработчика Microsoft Office. Дополнительные сведения см. в разделе [Настройка компьютера для разработки решений Office](bb398242\(v=vs.110\).md).

PowerPoint 2013 или PowerPoint 2010.

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

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

Запустите Visual Studio.
В меню Файл последовательно выберите пункты Создать и Проект.
В области шаблонов разверните узел Visual C# или Visual Basic, а затем разверните Office/SharePoint.
В разделе развернуть узел Office/SharePoint выберите узел Добавить- ins office.
В списке шаблонов проектов выберите Надстройка PowerPoint 2010 или PowerPoint_15_short.
В поле Имя введите FirstPowerPointAddIn.
Нажмите кнопку ОК.

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

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

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

Частичное определение класса ThisAddIn.Этот класс предоставляет точку входа для кода, а также доступ к объектной модели PowerPoint.Дополнительные сведения см. в разделе Программирование надстроек уровня приложения.Остальная часть класса ThisAddIn определена в скрытом файле кода, который не подлежит изменению.
Обработчики событий ThisAddIn_Startup и ThisAddIn_Shutdown.Эти обработчики событий вызываются, когда PowerPoint загружает и выгружает надстройку.Эти обработчики событий следует использовать для инициализации надстройки при ее загрузке и для освобождения ресурсов, занятых надстройкой, при ее выгрузке.Дополнительные сведения см. в разделе События в проектах Office.

Добавление текстового поля в каждый новый слайд

В файле кода ThisAddIn добавьте в класс ThisAddIn следующий код.Этот код задает обработчик событий для события PresentationNewSlide объекта Application.

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

Private Sub Application_PresentationNewSlide(ByVal Sld As PowerPoint.Slide) _
    Handles Application.PresentationNewSlide
    Dim textBox As PowerPoint.Shape = Sld.Shapes.AddTextbox( _
        Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50)
    textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.")
End Sub

void Application_PresentationNewSlide(PowerPoint.Slide Sld)
{
    PowerPoint.Shape textBox = Sld.Shapes.AddTextbox(
        Office.MsoTextOrientation.msoTextOrientationHorizontal, 0, 0, 500, 50);
    textBox.TextFrame.TextRange.InsertAfter("This text was added by using code.");
}

Если используется C#, следует добавить в обработчик событий ThisAddIn_Startup следующий код.Этот код требует подключения к обработчику событий Application_PresentationNewSlide события PresentationNewSlide.
```
this.Application.PresentationNewSlide += 
    new PowerPoint.EApplication_PresentationNewSlideEventHandler(
    Application_PresentationNewSlide);
```

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

Поле Application класса ThisAddIn.Поле Application возвращает объект Application, который представляет текущий экземпляр PowerPoint.
Параметр Sld обработчика событий для события PresentationNewSlide.Параметр Sld является объектом Slide, представляющим новый слайд.Дополнительные сведения см. в разделе Решения PowerPoint.

Проверка проекта

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

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

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

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

Этот текст добавлен с помощью кода.
Закройте PowerPoint.

Удаление проекта

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

Удаление проекта

В меню Visual Studio Построение выберите пункт Удалить решение.

Следующие действия

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

Общие программные задачи, которые можно выполнять в надстройках для PowerPoint.Дополнительные сведения см. в разделе Программирование надстроек уровня приложения.
Использование объектной модели PowerPoint.Дополнительные сведения см. в разделе Решения PowerPoint.
Настройка пользовательского интерфейса PowerPoint, например добавление настраиваемой вкладки на ленту или создание собственной настраиваемой области задач.Дополнительные сведения см. в разделе Настройка пользовательского интерфейса Office.
Построение и отладка надстройки уровня приложения для PowerPoint.Дополнительные сведения см. в разделе Построение решений Office.
Развертывание надстроек уровня приложения для PowerPoint.Дополнительные сведения см. в разделе Развертывание решения Office.