Общие сведения о ведущих элементах и элементах управления ведущего приложения

Статья
04/28/2010

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

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

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

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

Excel 2003
Excel 2007
Word 2003
Word 2007

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

Excel 2007
Word 2007

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

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

Ведущие элементы

Ведущие элементы являются классами верхнего уровня иерархии объектной модели в проектах Visual Studio Tools for Office. Visual Studio Tools for Office определяет следующие ведущие элементы для решений Word и Excel:

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

Ведущие элементы обычно имеют тот же базовый набор функций, что и соответствующие объекты Office, однако, у них есть также некоторые дополнительные функции:

Возможность размещения управляемых элементов управления, включая ведущие элементы управления и элементы управления Windows Forms.
Расширенные модели событий. Некоторые события документов, рабочих книг и рабочих листов в собственных объектных моделях Word и Excel вызываются только на уровне приложения. Ведущие элементы обеспечивают данные события на уровне документа; таким образом упрощается обработка событий для конкретного документа.

Основные сведения о ведущих элементах в проектах уровня документа

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

Ведущие элементы Microsoft.Office.Tools.Word.Document и Microsoft.Office.Tools.Excel.Worksheet имеют конструкторы, которые являются визуальным представлением документа или рабочего листа, как, например, конструктор Windows Forms. Можно использовать конструктор для изменения содержимого документа или листа непосредственно в Word или Excel, а также для перетаскивания элементов на область конструктора. Дополнительные сведения см. в разделах Ведущий элемент документа и Ведущие элементы листа.

Ведущий элемент Microsoft.Office.Tools.Excel.Workbook не функционирует в качестве контейнера для элементов управления, имеющих пользовательский интерфейс. Конструктор для данного ведущего элемента функционирует как область компонентов, что позволяет перетаскивать компоненты, например DataSet, на область конструктора. Дополнительные сведения см. в разделе Ведущий элемент книги.

Ведущие элементы в проектах на уровне документа нельзя создавать программным способом. Вместо этого лучше использовать классы ThisDocument, ThisWorkbook или Sheetn, которые Visual Studio Tools for Office создает в проекте автоматически во время разработки. Эти созданные классы являются производными от классов ведущих элементов; они обеспечивают точку входа для кода. Дополнительные сведения см. в разделе Программные ограничения ведущих элементов и элементов управления ведущего приложения.

Основные сведения о ведущих элементах в проектах уровня приложения

При создании надстройки уровня приложения доступ ко всем ведущим элементам по умолчанию отсутствует. Однако при использовании Visual Studio, начиная с версии 2008, пакет обновления 1 (SP1), можно создавать ведущие элементы Microsoft.Office.Tools.Word.Document, Microsoft.Office.Tools.Excel.Workbook и Microsoft.Office.Tools.Excel.Worksheet в надстройках во время выполнения.

После создания ведущего элемента можно выполнять такие задачи, как добавление элементов управления в документа и создание смарт-тегов, распознаваемых в конкретном документе. Дополнительные сведения см. в разделе Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения.

Элементы управления ведущего приложения

Ведущие элементы расширяют различные объекты пользовательского интерфейса в объектных моделях Word и Excel, например, объекты Microsoft.Office.Interop.Word.ContentControl и Microsoft.Office.Interop.Excel.Range.

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

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

Ведущие элементы управления, добавляемые в документы Office, функционируют как собственные объекты Office, однако, ведущие элементы управления имеют дополнительные функции, включающие события и возможность привязки к данным. Например, если нужно перехватывать события собственного объекта Microsoft.Office.Interop.Excel.Range в Excel, необходимо вначале обработать событие изменения листа. Затем необходимо определить, произошло ли изменение в Microsoft.Office.Interop.Excel.Range. В противоположность этому, элемент управления ведущего приложения Microsoft.Office.Tools.Excel.NamedRange имеет событие Change, которое может быть обработано непосредственно.

Отношение между ведущим элементом и элементами управления ведущего приложения очень похоже на отношение между Windows Forms и элементами управления Windows Forms. Аналогично помещению элемента управления текстового поля на форме Windows Forms, элемент управления Microsoft.Office.Tools.Excel.NamedRange помещается на ведущем элементе Microsoft.Office.Tools.Excel.Worksheet. На следующем рисунке показано отношение между ведущими элементами и элементами управления ведущего приложения.

Отношение между размещаемыми элементами и элементами управления

Кроме того, Visual Studio Tools for Office позволяет использовать элементы управления Windows Forms в решениях Office, добавляя их непосредственно в область документа Word и Excel. Дополнительные сведения см. в разделе Общие сведения об использовании элементов управления Windows Forms в документах Office.

Примечание.
Добавление элементов управления ведущего приложения или элементов управления Windows Forms во вложенный документ Word не поддерживается.

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

В проектах уровня документа во время разработки в документы Word или листы Excel можно добавлять ведущие элементы управления одним из следующих способов:

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

В проектах уровня документа и уровня приложения, начиная с версии с пакетом обновлений 1 (SP1) можно также добавлять некоторые ведущие элементы управления в документы во время выполнения. Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.

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

Именование элементов управления ведущего приложения

При перетаскивании в документ элемента управления ведущего приложения из панели элементов элемент управления автоматически именуется с использованием типа элемента управления с присоединенным в конце последовательным номером. Например, закладки именуются как bookmark1, bookmark2 и т.д. При использовании собственной функциональности Word или Excel для добавления элемента управления во время создания можно дать ему конкретное имя. Можно также переименовывать элементы управления посредством изменения значения свойства Имя в окне Свойства.

Примечание.
Для именования элементов управления ведущего приложения нельзя использовать зарезервированные слова. Например, при добавлении в лист элемента управления NamedRange и изменении его имени на Система при построении проекта происходит ошибка.

Для именования элементов управления ведущего приложения нельзя использовать зарезервированные слова. Например, при добавлении в лист элемента управления NamedRange и изменении его имени на Система при построении проекта происходит ошибка.

Удаление элементов управления ведущего приложения

В проектах уровня документа ведущие элементы управления можно удалять во время разработки, выделив элемент управления на листе Excel или в документе Word и нажав клавишу DELETE. Однако необходимо использовать диалоговое окно Определение имени в Excel для удаления элементов управления NamedRange. Дополнительные сведения см. в разделе Практическое руководство. Удаление элементов управления NamedRange во время разработки.

При добавлении в документ элемента управления ведущего приложения во время проектирования его нельзя удалить программными средствами во время выполнения, поскольку при попытке следующего использования в коде элемента управления возникает исключение. Метод Delete элемента управления ведущего приложения удаляет только элементы управления ведущего приложения, добавленные в документ во время выполнения. Если вызывается метод Delete элемента управления ведущего приложения, созданного во время разработки, возникает исключение.

Например, метод Delete класса NamedRange выполняет удаление NamedRange только в том случае, если он был программным способом добавлен на лист (т.н. динамическое создание ведущих элементов управления). Динамически созданные ведущие элементы управления можно также удалить посредством передачи имени элемента управления в метод Remove свойства Worksheet.Controls или Document.Controls. Дополнительные сведения см. в разделе Добавление элементов управления в документы Office во время выполнения.

Если конечный пользователь удаляет из документа ведущий элемент управления во время выполнения, возможно возникновение непредвиденных сбоев в решении. В Word и Excel можно использовать функции защиты документа для защиты от удаления элементов управления ведущего приложения. Дополнительные сведения см. в разделах Пример Word Document Protection Techniques и Пример Excel Document Protection Techniques.

Примечание.
Не удаляйте элементы управления программными средствами во время работы обработчика событий Shutdown документа или листа. При вызове события Shutdown элементы пользовательского интерфейса документа становятся недоступными. Если необходимо удалить элементы управления до закрытия приложения, добавьте свой код в другой обработчик событий, в такой как BeforeClose или BeforeSave.

Не удаляйте элементы управления программными средствами во время работы обработчика событий Shutdown документа или листа. При вызове события Shutdown элементы пользовательского интерфейса документа становятся недоступными. Если необходимо удалить элементы управления до закрытия приложения, добавьте свой код в другой обработчик событий, в такой как BeforeClose или BeforeSave.

Программирование реакции на события элементов управления ведущего приложения

Одним из способов расширения элементами управления ведущего приложения объектов Office является добавление событий. Например, объект Microsoft.Office.Interop.Excel.Range в Excel и объект Microsoft.Office.Interop.Word.Bookmark в Word не имеют событий, но Visual Studio Tools for Office расширяет эти объекты, добавляя программируемые события. Можно иметь доступ к этим событиям и записывать код для реагирования на них таким же образом, как выполняется доступ к событиям элементов управления в Windows Forms: через раскрывающийся список событий в Visual Basic и страницу свойств событий в C#. Дополнительные сведения см. в разделе Пошаговое руководство. Программирование реакции на события элементов управления NamedRange.

Примечание.
Нельзя устанавливать для свойства EnableEvents объекта Application в Excel значение false. Установка этого свойства в false предотвращает инициирование событий в Excel, включая события элементов управления ведущего приложения.

См. также

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

Элементы управления содержимым

Привязка данных к элементам управления

Программные ограничения ведущих элементов и элементов управления ведущего приложения

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

Элементы управления ведущего приложения Word

Элементы управления ведущего приложения Excel

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

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

Дата	Журнал	Причина
Июль 2008	Дополнительные сведения об использовании ведущих элементов и ведущих элементов управления в надстройках уровня приложения.	Изменение функции SP1.

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