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

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

  • Статья

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

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

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

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

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

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

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

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

    Примечание.

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

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

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

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

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

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

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

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

    Примечание.

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

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

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

  6. Выберите "Создать документ" в мастере проектов набор средств Visual Studio для 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 в следующих разделах можно ознакомиться с процессом разработки настроек:

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

  • Задачи программирования, относящиеся к настройкам на уровне документа для решений Word: Word.

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

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

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

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

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

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