Visio 物件模型概觀

更新：2007 年 11 月

若要開發 Microsoft Office Visio 的 Visual Studio Tools for Office 方案，您可以與 Visio 物件模型 (Object Model) 互動。這個物件模型是由 Visio 的主要 Interop 組件 (Assembly) 提供的類別 (Class) 和介面組成，並且在 Microsoft.Office.Interop.Visio 命名空間 (Namespace) 中定義。

本主題提供 Visio 物件模型的簡短概觀。如需使用 Visio 物件模型執行 Visual Studio Tools for Office 專案中的工作的詳細資訊，請參閱下列主題：

• 使用 Visio 文件

• 使用 Visio 圖案

了解 Visio 物件模型

Visio 會提供許多您可以與之互動的物件。這些物件的組織密切依照使用者介面的階層架構。階層架構最上層是 Microsoft.Office.Interop.Visio.Application 物件。這個物件代表目前 Visio 的執行個體 (Instance)。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 集合。這其中每一個物件和集合都有許多方法和屬性，可供您存取來管理該物件和集合並且與之互動。

如需詳細資訊，請參閱 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 參考文件。

下列各節簡述最上層的物件，並描述它們彼此的互動關係。這些物件包含下列四個物件：

• Application 物件

• Document 物件

• Page 物件

Application 物件

Microsoft.Office.Interop.Visio.Application 物件代表 Visio 應用程式，也是所有其他物件的父代 (Parent)。它的成員通常是套用至 Visio 整體。您可以使用 Microsoft.Office.Interop.Visio.Application 和 Microsoft.Office.Interop.Visio.ApplicationSettings 物件的屬性和方法來控制 Visio 環境。

在應用程式層級增益集專案中，您可以使用 ThisAddIn 類別的 Application 欄位存取 Microsoft.Office.Interop.Visio.Application 物件。如需詳細資訊，請參閱應用程式層級增益集程式設計。

Document 物件

Microsoft.Office.Interop.Visio.Document 物件是 Visio 程式設計的核心。它表示繪圖、模板 (Stencil) 或範本檔案。開啟 Visio 文件或建立新文件時，會建立新的 Microsoft.Office.Interop.Visio.Document 物件，該物件會加入至 Microsoft.Office.Interop.Visio.Application 物件的 Microsoft.Office.Interop.Visio.Documents 集合。

具有焦點 (Focus) 的文件稱為現用文件。它是由 Microsoft.Office.Interop.Visio.Application 物件的 Microsoft.Office.Interop.Visio.Application.ActiveDocument 屬性所代表。

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 物件模型中使用之類別的詳細資訊，請參閱下列文件。線上 MSDN Library 文件可提供 VBA 中的 Visio 物件模型和程式碼範例資訊。Visio 2007 軟體開發套件 (SDK) (英文) 可提供 Visual Basic 和 C# 程式碼範例。Visio 2007 SDK 也提供發行工具和 Visual Studio 範本。

Microsoft Office Visio 2007

• Visio 物件模型參考

• 歡迎使用 Microsoft Office Visio 2007 SDK

• 歡迎使用 Microsoft Visio 2007 另存成網頁開發人員參考

• 歡迎使用 Microsoft Office Visio 2007 XML 結構描述參考

• 歡迎使用 Microsoft Office Visio 2007 ShapeSheet 參考

Microsoft Office Visio 2003

• Visio 物件模型 [Visio 2003 SDK 文件]

• 關於 Microsoft Office Visio ShapeSheet 參考 [Visio 2003 SDK 文件]

• 關於 Microsoft Office Visio 2003 另存成網頁參考 [Visio 2003 SDK 文件]

• 歡迎使用 Microsoft Office Visio 2003 XML 結構描述參考 [Visio 2003 SDK 文件]

主要 Interop 組件中的其他型別

您可以尋找主要 Interop 組件中因實作 (Implementation) 差異而在 VBA 內看不到的型別。VBA 所提供的 Visio 物件模型檢視，只包含可以直接使用的物件和成員。主要 Interop 組件會公開相同的物件模型，但還包含要將 COM 物件模型中的物件轉譯為 Managed 程式碼時，可以使用的其他介面、類別和成員。這些額外項目不適合直接用於您的程式碼中。

如需詳細資訊，請參閱 Overview of Classes and Interfaces in the Office Primary Interop Assemblies和Office 主要 Interop 組件。

注意事項：
目前沒有關於 Visio 主要 Interop 組件的參考文件。

VBA 參考

VBA 參考中的所有物件和成員都對應至主要 Interop 組件中供您用在 Visual Studio Tools for Office 專案中的類別和成員。例如，Visio VBA 文件中的 Visio.Application 物件會對應至主要 Interop 組件中的 Microsoft.Office.Interop.Visio.Application 類別。

VBA 參考有下列優點：

• 它會同時記錄 Visio 2007 和 Visio 2003 的物件模型。

• 提供大多數成員的程式碼範例。

VBA 參考有下列缺點：

• 只提供 VBA 的語法和程式碼範例。若要在 Visual Studio Tools for Office 專案中使用程式碼範例，您必須將 VBA 程式碼轉譯為 Visual Basic 或 Visual C#。

請參閱

概念

Visio 方案

使用 Visio 文件

使用 Visio 圖案