Visio 物件模型概觀
若要開發 Microsoft Office Visio 的 Office 方案,您可以與 Visio 物件模型 (Object Model) 互動。 這個物件模型是由 Visio 的主要 Interop 組件 (Assembly) 提供的類別 (Class) 和介面組成,並且在 Microsoft.Office.Interop.Visio 命名空間 (Namespace) 中定義。
本主題提供 Visio 物件模型的簡短概觀。 如需使用 Visio 物件模型執行 Office 專案中的工作的詳細資訊,請參閱下列主題:
了解 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 物件模型的完整資訊,您可以參閱 Visio VBA 物件模型參考。 VBA 物件模型參考記載 Visio 物件模型公開給 Visual Basic for Applications (VBA) 程式碼時的資訊。 您可以從下列位置取得 Visio 適用的 VBA 物件模型參考:
Visio 2010 物件模型參考 (英文)
Visio 2007 物件模型參考 (英文)
VBA 物件模型參考中的所有物件和成員都會對應至 Visio 主要 Interop 組件 (PIA) 中的型別和成員。 例如,VBA 物件模型參考中的 Document 物件會對應至 Visio PIA 中的 Microsoft.Office.Interop.Visio.Document 型別。 雖然 VBA 物件模型參考會提供大部分屬性、方法和事件的程式碼範例,但如果您想要在以 Visual Studio 建立的 Visio 增益集專案中使用這些程式碼範例,您必須將此參考中的 VBA 程式碼改成 Visual Basic 或 Visual C# 程式碼。
注意事項 |
---|
目前沒有關於 Visio 主要 Interop 組件的參考文件。 |
如需用於建立 Visio 方案的相關程式碼範例和額外工具,請參閱下列下載:
Visio 2010 軟體開發套件 (英文)
Visio 2007 軟體開發套件 (英文)
主要 Interop 組件中的其他型別
您可以尋找主要 Interop 組件中因實作 (Implementation) 差異而在 VBA 內看不到的型別。 VBA 所提供的 Visio 物件模型檢視,只包含可以直接使用的物件和成員。 主要 Interop 組件會公開相同的物件模型,但還包含要將 COM 物件模型中的物件轉譯為 Managed 程式碼時,可以使用的其他介面、類別和成員。 這些額外項目不適合直接用於您的程式碼中。
如需詳細資訊,請參閱 Office 主要 Interop 組件中的類別和介面概觀 (英文) 和 Office 主要 Interop 組件。