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


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

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

Область применения. Сведения в этом разделе относятся к проектам надстроек VSTO для PowerPoint. Дополнительные сведения см. в разделе "Функции", доступные по Приложение Office ликации и типу проекта.

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

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

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

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

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

    Примечание.

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

Необходимые компоненты

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

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

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

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

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

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

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

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

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

  7. Щелкните OK.

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

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

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

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

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

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

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

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

    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 событий к событию Microsoft.Office.Interop.PowerPoint.EApplication_Event.PresentationNewSlide .

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Следующие шаги

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

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

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

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

  • Построение и отладка надстроек VSTO для PowerPoint. Дополнительные сведения см. в статье "Сборка решений Office".

  • Развертывание надстроек VSTO для PowerPoint. Дополнительные сведения см. в статье "Развертывание решения Office".