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

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

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

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

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

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

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

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

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

    Замечание

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

Предпосылки

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

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

Создание проекта документа Word в Visual Studio

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

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

  3. В диалоговом окне "Создание проекта " выберите проект документа WORD VSTO .

    Замечание

    Вы также можете найти шаблоны, введя имя продукта Office в текстовом поле поиска в верхней части диалогового окна "Создание проекта ". Например, при вводе excel отображаются все шаблоны проектов для Excel. Вы также можете отфильтровать список шаблонов, чтобы отобразить только шаблоны для Office, выбрав Office в раскрывающемся списке "Тип проекта". Дополнительные сведения см. в статье "Создание нового проекта в Visual Studio".

  4. Нажмите кнопку Далее.

  5. Введите FirstWorkbookCustomization в поле "Имя " в диалоговом окне "Настройка нового проекта " и нажмите кнопку "Создать".

  6. Выберите "Создать документ" в мастере проектов Visual Studio Tools для Office и нажмите кнопку "ОК".

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

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

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

Чтобы закрыть и снова открыть документ в конструкторе

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

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

    - или -

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    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. Дополнительные сведения см. в статье "Написание кода в решениях Office".

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

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

  1. Нажмите клавишу F5 , чтобы создать и запустить проект.

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

  2. В документе убедитесь, что отображается следующий текст.

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

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

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

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

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

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

  1. В Visual Studio в меню "Сборка" нажмите кнопку "Очистить решение".

Дальнейшие шаги

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

Связанный контент

  • Last updated on