Visio (的 Documents.AddEx 方法)

當允許在引數中傳遞額外資訊時，將新的樣板或繪圖加入到 Documents 集合中。

語法

運算式。 AddEx( _FileName_ , _MeasurementSystem_ , _Flags_ , _LangID_ )

表達 代表 Documents 物件的變數。

參數

名稱	必要/選用	資料類型	描述
FileName	必要	字串	要加入的文件類型或檔名;如果您未包含路徑，Microsoft Visio 會搜尋 Application 物件的TemplatePaths 屬性中指定的資料夾或資料夾，以及所有已發佈的範本，包括已發佈的第三方範本。
MeasurementSystem	選用	VisMeasurementSystem	要在新的文件中使用的度量單位。 如需可能的值，請參閱＜備註＞。
Flags	選用	Long	表示如何開啟新文件的旗標。 如需可能的值，請參閱＜備註＞。
LangID	選用	Long	此文件的語言識別碼。 請參閱＜備註＞一節。

傳回值

Document

註解

因為 AddEx 方法會套用到 Documents 集合，所以與 Add 方法類似，但是有一點例外，就是 AddEx 會提供數個其他引數，而呼叫者可在這些引數中指定此文件的建立方式。

MeasurementSystem 引數應該是下列其中一個 VisMeasurementSystem (宣告於 Visio 型別程式庫中) 成員。

常數	值	描述
visMSDefault	0	根據 [控制台] 中所設定的 [地區選項] 來選擇公制或英制。
visMSMetric	1	公制度量系統。
visMSUS	2	英制度量系統。

Flags 引數應該是下列其中一個或多個 VisOpenSaveArgs (宣告於 Visio 型別程式庫中) 成員的組合。

常數	值	描述
visAddDocked	4	在停駐視窗中加入文件。
visAddHidden	64	在隱藏視窗中加入文件。
visAddMacrosDisabled	128	加入已停用巨集的文件。
visAddMinimized	16	在最小化視窗中加入文件。
visAddNoWorkspace	256	加入不含任何工作區資訊的文件。
visAddStencil	512	加入新的樣板檔案。

LangID 自變數應該是 Windows 用來編碼不同語言版本的標準標識碼之一。 例如，如果是英文版本的 Visio，則語言識別碼為 &H0409。 若要查看語言識別碼的清單，請在 MSDN 上的 Microsoft Platform SDK 中搜尋 "VERSIONINFO"。

如果不要根據任何範本來建立新的繪圖，請將長度為零的字串 ("") 傳遞給 AddEx 方法。

若要根據範本建立新的繪圖，請將 「templatename.vst」 傳遞至 AddEx 方法。 Visio 會開啟樣板工作區一部分的樣板，並將樣式和其他與範本相關聯的設定複製到新檔。 如果範本檔名無效，則不會傳回任何檔，而且會產生錯誤。

若不要根據任何樣板來建立新的樣板，請傳遞 ("vss")。

若要開啟樣板的複本，請傳遞 ("stencilname.vss")。

若要開啟繪圖的複本，請傳遞 ("drawingname.vsd")。

注意事項

開啟樣板或繪圖的複本相當於選取 [開啟舊檔] 對話方塊的 [開啟] 清單中的 [開啟複本]，或是相當於搭配 visOpenCopy 旗標使用 OpenEx 方法。

範例

這個 Microsoft Visual Basic for Applications (VBA) 巨集將示範如何使用 AddEx 方法，以根據使用預設度量系統單位的 "BASICD_U.VST" 範本來建立文件。

Public Sub AddEx_Example() 
 
 Application.Documents.AddEx "BASICD_U.VST", visMSDefault 
 
End Sub

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。