Общие сведения об объектной модели Visio

Для разработки решений Office для Microsoft Office Visio вы можете взаимодействовать с объектной моделью Visio. Эта объектная модель состоит из классов и интерфейсов, которые предоставляются в основной сборке взаимодействия для Visio и определены в пространстве имен Microsoft.Office.Interop.Visio.

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

Общие сведения об объектной модели Visio

Visio предоставляет множество различных объектов, с которыми можно взаимодействовать. Они организованы в виде иерархии, которая точно соответствует пользовательскому интерфейсу. В верхней части иерархии находится объект Microsoft.Office.Interop.Visio.Application . Он представляет текущий экземпляр Visio. Объект Microsoft.Office.Interop.Visio.Application содержит Microsoft.Office.Interop.Visio.Document объекты и Microsoft.Office.Interop.Visio.Page объекты, а также Microsoft.Office.Interop.Visio.Documents коллекции.Microsoft.Office.Interop.Visio.Pages Каждый из этих объектов и коллекций содержит много методов и свойств, к которым можно обращаться для работы и взаимодействия с ними.

Дополнительные сведения см. в справочной документации VBA для объектов Microsoft.Office.Interop.Visio.Application, Microsoft.Office.Interop.Visio.Documentи Microsoft.Office.Interop.Visio.Page , а также для коллекций Microsoft.Office.Interop.Visio.Documents и Microsoft.Office.Interop.Visio.Pages .

В следующих разделах кратко описываются объекты верхнего уровня и их взаимодействие друг с другом. К числу этих объектов относятся следующие:

  • Объект приложения

  • объект документа;

  • Page - объект

Объект приложения

Объект Microsoft.Office.Interop.Visio.Application представляет приложение Visio и является родительским объектом всех других объектов. Обычно его элементы применяются к Visio как к единому целому. Для управления средой Visio можно использовать свойства и методы Microsoft.Office.Interop.Visio.Application и Microsoft.Office.Interop.Visio.ApplicationSettings объекты.

В проектах надстроек VSTO можно получить доступ к объекту Microsoft.Office.Interop.Visio.Application с помощью Application поля ThisAddIn класса. Дополнительные сведения см. в разделе Programming VSTO Add-Ins.

объект документа;

Объект Microsoft.Office.Interop.Visio.Document является центральным для программирования Visio. Он представляет документ, набор элементов или файл шаблона. При открытии документа Visio или создании нового документа создается новый объект Microsoft.Office.Interop.Visio.Document, который добавляется в коллекцию Microsoft.Office.Interop.Visio.Documents объекта Microsoft.Office.Interop.Visio.Application.

Документ, который находится в фокусе, называется активным документом. Он представлен свойством Microsoft.Office.Interop.Visio.Application.ActiveDocument объекта Microsoft.Office.Interop.Visio.Application.

Page - объект

Объект Microsoft.Office.Interop.Visio.Page представляет область рисования страницы переднего плана или фоновой страницы. Вы можете использовать свойство Microsoft.Office.Interop.Visio.Page.Background, чтобы определить, является ли страница основной или фоновой.

Для создания фигур можно использовать методы, в том числе Microsoft.Office.Interop.Visio.Page.DrawSpline и Microsoft.Office.Interop.Visio.Page.DrawOval. Кроме того, можно извлекать образцы из наборов элементов и размещать фигуры на странице с помощью метода Microsoft.Office.Interop.Visio.Page.Drop или Microsoft.Office.Interop.Visio.Page.DropMany.

Использование документации по объектной модели Visio

Полные сведения об объектной модели Visio см. в справочнике по объектной модели Visio VBA. В справочных документах по объектной модели VBA объектная модель Visio описана в том виде, в котором она предоставляется коду Visual Basic для приложений. Дополнительные сведения см. в справочнике по объектной модели Visio.

Все объекты и элементы в справочнике объектной модели VBA соответствуют типам и членам основной сборки взаимодействия Visio. Например, Document объект в справочнике по объектной модели VBA соответствует типу Microsoft.Office.Interop.Visio.Document в Visio PIA. Несмотря на то что в справочнике по объектной модели VBA содержатся примеры кода для большинства свойств, методов и событий, необходимо преобразовать код VBA в этом справочнике в код Visual Basic или Visual C#, если требуется использовать их в проекте надстройки Visio VSTO, создаваемом с помощью Visual Studio.

Примечание.

В настоящее время справочная документация по основной сборке взаимодействия Visio отсутствует.

Дополнительные примеры кода и дополнительные средства для создания решений Visio см . в пакете средств разработки программного обеспечения Visio 2010.

Дополнительные типы в основных сборках взаимодействия

В основных сборках взаимодействия можно найти типы, которые не видны для VBA из-за различий в реализации. VBA предоставляет представление объектной модели Visio, включающее только те объекты и члены, которые можно использовать напрямую. Основные сборки взаимодействия предоставляют такую же объектную модель, но они также содержат другие интерфейсы, классы и члены, которые преобразуют объекты объектной модели COM в управляемый код. Эти дополнительные элементы не предназначены для непосредственного использования в коде.

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