Ведущий элемент книги

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

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

Ведущим элементом Workbook является объект рабочей книги, предоставляющий доступ к событиям и служащий контейнером для компонентов.

При создании новой настройки уровня документа для Microsoft Office Excel Visual Studio Tools for Office автоматически создает в проекте ведущий элемент Workbook. Для обращения к объекту Workbook используется свойство ThisWorkbook.

Начиная с пакета обновления 1 для Visual Studio 2008, можно получать ведущий элемент Workbook в проекте надстройки уровня приложения путем вызова метода GetVstoObject объекта Microsoft.Office.Interop.Excel.Workbook. Дополнительные сведения см. в разделе Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения.

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

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

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

Примечание.
Visual Studio Tools for Office не поддерживает общие книги.

События

Ниже перечислены события, доступные для ведущего элемента Workbook.

• ActivateEvent

• AddinInstall

• AddinUninstall

• AfterXmlExport

• AfterXmlImport

• BeforeClose

• BeforePrint

• BeforeSave

• BeforeXmlExport

• BeforeXmlImport

• BindingContextChanged

• Deactivate

• Disposed

• New

• NewSheet

• Open

• PivotTableCloseConnection

• PivotTableOpenConnection

• RowsetComplete

• SheetActivate

• SheetBeforeDoubleClick

• SheetBeforeRightClick

• SheetCalculate

• SheetChange

• SheetDeactivate

• SheetFollowHyperlink

• SheetPivotTableUpdate

• SheetSelectionChange

• Shutdown

• Startup

• SyncEvent

• WindowActivate

• WindowDeactivate

• WindowResize

См. также

Задачи

Пример динамических элементов управления надстройками Excel

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

Расширение документов Word и книг Excel в надстройках уровня приложения во время выполнения

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

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

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

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

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

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

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