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

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

  • Статья

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

Применение

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

Тип проекта

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

Версия Microsoft Office

  • PowerPoint 2007

  • PowerPoint 2003

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

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

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

  • Создание проекта надстройки PowerPoint для PowerPoint 2003 или PowerPoint 2007.

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

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

  • Удаление проекта, чтобы надстройка больше не запускалась автоматически на компьютере разработчика.

Cc668192.alert_note(ru-ru,VS.90).gifПримечание.

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

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

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

  • Visual Studio Tools for Office (необязательный компонент Visual Studio 2008 Professional и Visual Studio Team System);

  • PowerPoint 2003 или PowerPoint 2007.

По умолчанию компонент Visual Studio Tools for Office устанавливается с перечисленными версиями Visual Studio. Для проверки, установлен ли он на компьютере, см. раздел Установка средств Visual Studio для Office.

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

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

  1. Запустите Visual Studio.

  2. В меню Файл выберите команду Создать и щелкните Проект.

  3. В панели Типы проектов разверните узел Visual C# или Visual Basic, а затем разверните узел Office.

  4. Выберите папку 2007 при разработке надстройки для PowerPoint 2007 или папку 2003 при разработке надстройки для PowerPoint 2003.

  5. В области Шаблоны выберите Надстройка PowerPoint 2007 или Надстройка PowerPoint 2003.

  6. В поле Имя введите FirstPowerPointAddIn.

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

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

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

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

  • Частичное определение класса ThisAddIn. Этот класс предоставляет точку входа для кода, а также доступ к объектной модели PowerPoint. Дополнительные сведения см. в разделе Ведущий элемент AddIn. Остальная часть класса ThisAddIn определена в скрытом файле кода, который нельзя изменить.

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

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

  1. В файле кода ThisAddIn добавьте в класс ThisAddIn следующий код. Этот код задает обработчик событий для события PresentationNewSlide класса Microsoft.Office.Interop.PowerPoint.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.");
}

  2. Если используется C#, следует добавить в обработчик событий ThisAddIn_Startup следующий код. Этот код требует подключения к обработчику событий Application_PresentationNewSlide события PresentationNewSlide.

    this.Application.PresentationNewSlide += 
    new PowerPoint.EApplication_PresentationNewSlideEventHandler(
    Application_PresentationNewSlide);

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

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

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

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

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

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

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

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

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

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

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

  4. Закройте PowerPoint.

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

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

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

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

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

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

См. также

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

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

Решения PowerPoint

Настройка пользовательского интерфейса Office

Общие сведения о шаблонах проектов пакета инструментов Visual Studio для Office

Ссылки

Шаблоны проектов надстроек для Microsoft Office 2003

Шаблоны проектов надстроек для Microsoft Office 2007

Другие ресурсы

Построение и отладка решений Office

Развертывание решений Office

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

Дата

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

Причина

Июль 2008

Добавлен раздел.

Улучшение информации.