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

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

  • Статья

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

Применение

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

Тип проекта

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

Версия Microsoft Office

  • Word 2007

  • Word 2003

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

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

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

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

  • Написание кода, использующего объектную модель Word, для добавления текста в документ при его сохранении.

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

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

Cc442946.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).

  • Word 2003 или Word 2007.

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

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

Создание нового проекта надстройки Word в Visual Studio

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

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

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

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

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

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

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

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

Написание кода для добавления текста в сохраненный документ

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

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

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

Добавление абзаца текста в сохраненный документ

  1. В файле кода ThisAddIn добавьте в класс ThisAddIn следующий код. Новый код определяет обработчик событий для события DocumentBeforeSave, возникающего при сохранении документа.

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

    Private Sub Application_DocumentBeforeSave(ByVal Doc As Word.Document, ByRef SaveAsUI As Boolean, _
    ByRef Cancel As Boolean) Handles Application.DocumentBeforeSave
    Doc.Paragraphs(1).Range.InsertParagraphBefore()
    Doc.Paragraphs(1).Range.Text = "This text was added by using code."
End Sub

    void Application_DocumentBeforeSave(Word.Document Doc, ref bool SaveAsUI, ref bool Cancel)
{
    Doc.Paragraphs[1].Range.InsertParagraphBefore();
    Doc.Paragraphs[1].Range.Text = "This text was added by using code.";
}
    Cc442946.alert_note(ru-ru,VS.90).gifПримечание.

    Этот код использует значение индекса 1 для доступа к первому абзацу коллекции Paragraphs. Хотя в Visual Basic и Visual C# используются массивы, в которых индекс начинается с 0, нижней границей массива для большинства коллекций в объектной модели Word является 1. Дополнительные сведения см. в разделе Сравнение программирования на Visual Basic и C#.

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

    this.Application.DocumentBeforeSave += 
    new Word.ApplicationEvents4_DocumentBeforeSaveEventHandler(Application_DocumentBeforeSave);

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

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

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

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

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

  2. В Word сохраните активный документ.

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

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

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

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

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

Очистка завершенного проекта на компьютере разработчика

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

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

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

См. также

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

Общие сведения о разработке решений Office

Разработка надстроек уровня приложения для Word

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

Общие сведения об объектной модели Word

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

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

Ссылки

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

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

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

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

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

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

Дата

Журнал

Причина

Июль 2008

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

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