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

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

  • Статья

Обновлен: Ноябрь 2007

Применение

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

Тип проекта

  • Проекты уровня документа

Версия Microsoft Office

  • Выпуск 2007 системы Microsoft Office

  • Microsoft Office 2003

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

Расширив Microsoft Office Word или Microsoft Office Excel при помощи настройки уровня документа, можно выполнить следующие задачи:

  • Автоматизировать приложение Microsoft Office путем использования объектной модели приложения.

  • Добавить элементы управления в область документа.

  • Вызвать код VBA в документ из сборки настройки.

  • Вызвать код в сборке настройки из VBA.

  • Управлять определенными аспектами документа, если он размещен на сервере, на котором не установлена система Microsoft Office.

  • Настроить пользовательский интерфейс приложения.

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

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

При создании документа уровня проекта Visual Studio Tools for Office автоматически генерирует класс в проекте, который можно использовать, чтобы приступить к написанию кода. Visual Studio Tools for Office генерирует различные классы для Word и Excel:

  • В проектах уровня документа для Word класс вызывается ThisDocument по умолчанию.

  • Проекты уровня документа для Excel генерируют несколько классов: один для самой книги и по одному для каждого листа. По умолчанию эти классы имеют следующие имена:

    • ThisWorkbook

    • Sheet1

    • Sheet2

    • Sheet3

Сгенерированные классы включают обработчики событий, которые вызываются при открытии и закрытии документа. Для выполнения кода при открытом документе добавьте код в обработчик событий Startup. Для выполнения кода непосредственно перед закрытием документа добавьте код в обработчик событий Shutdown. Дополнительные сведения см. в разделе Инструменты Visual Studio для событий проекта Office.

Каждый из автоматически сгенерированных классов в проектах уровня документа является производным от класса Visual Studio Tools for Office, вызываемого ведущим элементом. Например, класс ThisDocument в проекте Word является производным ведущего элемента Microsoft.Office.Tools.Word.Document. Дополнительные сведения см. в разделе Общие сведения о ведущих элементах и элементах управления ведущего приложения.

Доступ к объектной модели ведущего приложения

Чтобы получить доступ к объектной модели ведущего приложения, используйте члены созданного класса в разрабатываемом проекте. Каждый из этих классов соответствует классу в объектной модели Excel или Word, они содержат в основном одинаковые свойства, методы и события. Например, класс ThisDocument в проекте уровня документа для Word представляет большинство тех же членов, что и класс Microsoft.Office.Interop.Word.Document в объектной модели Word.

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

Me.Save()

this.Save();

Чтобы сделать все то же самое, что и вне класса ThisDocument, используйте объект Globals для получения доступа к классу ThisDocument. Дополнительные сведения об объекте Globals см. в разделе Глобальный доступ к объектам в Visual Studio Tools for Office.

Например, можно добавить этот код в панель действий файла кода, если необходимо включить кнопку Записать в панель действий пользовательского интерфейса.

Globals.ThisDocument.Save()

Globals.ThisDocument.Save();

Поскольку класс ThisDocument является производным от ведущего элемента Microsoft.Office.Tools.Word.Document, метод Save, который вызывает этот код, в действительности является методом Save ведущего элемента Microsoft.Office.Tools.Word.Document. Этот метод соответствует методу Save класса Microsoft.Office.Interop.Word.Document в объектной модели Word.

Дополнительные сведения об использовании объектной модели Word и Excel см. в разделах Общие сведения об объектной модели Word и Общие сведения об объектной модели Excel.

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

Чтобы настроить пользовательский интерфейс документа, можно добавить элементы управления Windows Forms или ведущие элементы управления в область документа. Используя различные сочетания элементов управления и кода, можно связывать элементы управления с данными, собирать вводимые пользователем сведения и реагировать на действия пользователя.

Элементы управления являются классами, которые расширяют некоторые из объектов в объектной модели Word и Excel. Например, ведущий элемент управления Microsoft.Office.Tools.Excel.ListObject предоставляет всю функциональность Microsoft.Office.Interop.Excel.ListObject в Excel. Однако ведущий управляющий элемент Microsoft.Office.Tools.Excel.ListObject также имеет дополнительные возможности событий и привязки к данным.

Дополнительные сведения см. в разделах Общие сведения о ведущих элементах и элементах управления ведущего приложения и Общие сведения об использовании элементов управления Windows Forms в документах Office.

Объединение настроек VBA и настроек на уровне документа

Можно использовать код VBA в документе, который является частью настройки Visual Studio Tools for Office уровня документа. Во всех настройках на уровне документа код VBA можно вызывать в документе из сборки настройки. В проектах на уровне документа для выпуска 2007 системы Microsoft Office также можно настроить проект таким образом, чтобы разрешить использование в документе кода VBA для вызова кода из сборки настройки.

Дополнительные сведения см. в разделе Объединение настроек VBA и настроек на уровне документа.

Управление документами на сервере

Можно управлять некоторыми аспектами настроек уровня документа, если он размещен на сервере, на котором не установлены Office Word или Microsoft Office Excel. Например, можно получить доступ к данным и изменить данные в кэше данных документа. Можно управлять сборкой настройки Visual Studio Tools for Office, связанной с документом. Например, можно программно удалить сборку из документа, чтобы документ больше не выполнял код, или можно программно прикрепить сборку к документу.

Дополнительные сведения см. в разделе Управление документами на сервере с помощью класса ServerDocument.

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

Можно настроить пользовательский интерфейс Word и Excel путем использования настройки уровня документа.

Выпуск 2007 и выпуск 2003 системы Microsoft Office

Пользовательский интерфейс для систем Microsoft Office 2003 и the 2007 Microsoft Office можно настроить несколькими способами:

Выпуск 2007

Для Word 2007 и Excel 2007 также предусмотрены следующие способы настройки пользовательского интерфейса:

Выпуск 2003

Для Word 2003 и Excel 2003 также предусмотрены следующие способы настройки пользовательского интерфейса:

Дополнительные сведения о настройке пользовательского интерфейса Microsoft Office см. в разделе Настройка пользовательского интерфейса Office.

См. также

Задачи

Практическое руководство. Создание и изменение настраиваемых свойств документа

Практическое руководство. Чтение и запись в свойства документа

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

Объединение настроек VBA и настроек на уровне документа

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

Получение вложенных объектов из собственных объектов Office в настройках уровня документа

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

Элементы управления в документах Office