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

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

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

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

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

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

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

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

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

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

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

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

Ведущие элементы нельзя создавать программными средствами в проектах уровня документа. Вместо этого используйте классы ThisDocument , ThisWorkbook или Sheet n , которые Visual Studio автоматически создает в проекте во время разработки. Эти созданные классы являются производными от ведущих элементов и обеспечивают точку входа для кода. Дополнительные сведения см. в разделе программные ограничения ведущих элементов и элементов управления ведущего приложения.

при создании надстройки VSTO у вас по умолчанию нет доступа к каким-либо ведущим элементам. Тем не менее вы можете создать ведущие элементы Document, Workbookи Worksheet в надстройках VSTO Word и Excel в среде выполнения.

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

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

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

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

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

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

связь между ведущим элементом и элементами управления ведущего приложения аналогична связи между Windowsной формой и Windows Forms элементами управления. Элемент управления NamedRange помещается в ведущий элемент Worksheet так же, как элемент управления "текстовое поле" помещается в форму Windows Forms. На следующем рисунке показана связь между ведущими элементами и элементами управления ведущего приложения.

Вы также можете использовать в решениях Office элементы управления Windows Forms, добавляя их непосредственно в область документа Word и Excel. дополнительные сведения см. в разделе Windows Forms controls on Office documents overview.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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