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

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

Применимость
Сведения в данном разделе относятся только к указанным проектам Visual Studio Tools for Office и версиям приложений Microsoft Office. Тип проекта Проекты уровня документа Версия Microsoft Office Word 2007 Word 2003 Дополнительные сведения см. в разделе Доступность функций по типам приложений и проектов.

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

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

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

• Добавление текста в документ, размещенный в конструкторе Visual Studio.

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

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

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

Примечание.
На вашем компьютере названия некоторых элементов интерфейса пользователя 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.

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

5. В области Шаблоны выберите Документ Word 2003 или Документ Word 2007.

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

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

   Откроется вкладка Мастер проектов Visual Studio Tools for Office.

8. Выберите Создать новый документ и нажмите кнопку OK.

   Visual Studio создает проект FirstDocumentCustomization и добавляет документ FirstDocumentCustomization и файл кода ThisDocument в проект. Документ FirstDocumentCustomization открывается в конструкторе автоматически.

Закрытие и повторное открытие документа в конструкторе

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

Закрытие и повторное открытие документа в конструкторе

1. Для закрытия документа нажмите кнопку Закрыть (X) в окне конструктора.

2. В обозревателе решений щелкните правой кнопкой мыши файл кода ThisDocument и выберите пункт Конструктор представлений.

   —либо—

   Дважды щелкните файл кода ThisDocument в обозревателе решений.

Добавление текста в документ в конструкторе

Можно разработать пользовательский интерфейс настройки, изменив документ, открытый в конструкторе. Например, можно добавить текст, таблицы или элементы управления Word. Дополнительные сведения об использовании конструктора см. в разделе Общие сведения о работе с документами Office в среде Visual Studio.

Добавление текста в документ с помощью конструктора

• В документе, открытом в конструкторе, введите следующий текст.

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

Добавление текста в документ в конструкторе программными средствами

Затем, добавьте код в файл кода ThisDocument. В этом коде для добавления второго абзаца текста в документ используется объектная модель Word. По умолчанию файл кода ThisDocument содержит следующий созданный код:

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

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

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

1. В обозревателе решений щелкните правой кнопкой файл ThisDocument, а затем выберите Просмотреть код.

   Файл кода открывается в Visual Studio.

2. Замените обработчик событий ThisDocument_Startup следующим кодом. После открытия документа этот код добавляет в него второй абзац текста.

   Private Sub ThisDocument_Startup(ByVal sender As Object, ByVal e As System.EventArgs) Handles Me.Startup
       Me.Paragraphs(1).Range.InsertParagraphAfter()
       Me.Paragraphs(2).Range.Text = "This text was added by using code."
   End Sub
   

   private void ThisDocument_Startup(object sender, System.EventArgs e)
   {
       this.Paragraphs[1].Range.InsertParagraphAfter();
       this.Paragraphs[2].Range.Text = "This text was added by using code.";
   }
   

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

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

Тестирование документа

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

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

2. Проверьте в документе, виден ли следующий текст.

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

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

3. Закройте документ.

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

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

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

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

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

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

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

• Задачи программирования, специфичные для настроек уровня документа для Word: Разработка настройки Word на уровне документа.

• Использование объектной модели Word: Общие сведения об объектной модели Word.

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

• Использование расширенных объектов Word, предоставленных Visual Studio Tools for Office, для выполнения задач, которые невозможно выполнить с использованием объектной модели Word (например, размещение управляемых элементов управления в документах и привязка элементов управления Word к данным с помощью модели привязки данных Windows Forms): Автоматизация Word с помощью расширенных объектов.

• Привязка и отладка настроек уровня документа для Word: Построение и отладка решений Office.

• Развертывание настроек уровня документа для Word: Развертывание решений Office.

См. также

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

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

Разработка настройки Word на уровне документа

Настройки программирования уровня документа

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

Автоматизация Word с помощью расширенных объектов

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

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

Ссылки

Шаблон проекта документа Word

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

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

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

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

Дата	Журнал изменений	Причина
Июль 2008	Добавленный раздел.	Улучшение информации.