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

Статья
02/20/2013

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

Применение. Сведения этого раздела применяются к проектам уровня документа и уровня приложения для следующих приложений: Excel 2013 и Excel 2010; Word 2013 и Word 2010. Дополнительные сведения см. в разделе Доступность функций по типам приложений Office и проектов.

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

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

Каждое из этих средств тип расширяет объект, расположенный непосредственно в объектной модели 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 во время разработки.Эти созданные классы являются производными от ведущих элементов; они обеспечивают точку входа для кода.Дополнительные сведения см. в разделе Программные ограничения ведущих элементов и элементов управления ведущего приложения.

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

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

После создания ведущего элемента, можно также выполнить такие задачи, как добавление элементов управления в документы.Дополнительные сведения см. в разделе Расширение документов 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.На следующем рисунке показано отношение между ведущими элементами и элементами управления ведущего приложения.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Примечание
Не удаляйте элементы управления программными средствами во время работы обработчика событий 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 (cреда выполнения) расширяет эти объекты, добавляя программируемые события.Можно иметь доступ к этим событиям и записывать код для реагирования на них таким же образом, как выполняется доступ к событиям элементов управления в Windows Forms: через раскрывающийся список событий в Visual Basic и страницу свойств событий в C#.Дополнительные сведения см. в разделе Пошаговое руководство. Программирование реакции на события элементов управления NamedRange.

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