當允許在引數中傳遞額外資訊時,將新的樣板或繪圖加入到 Documents 集合中。
語法
運算式。
AddEx( _FileName_ , _MeasurementSystem_ , _Flags_ , _LangID_ )
詞 一個代表 文件 物件的變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| FileName | 必要 | 字串 | 要新增的文件類型或檔名;如果你沒有包含路徑,Microsoft Visio 會搜尋 應用程式物件TemplatePaths 屬性中指定的資料夾,以及所有已發佈的範本,包括已發佈的第三方範本。 |
| 測量系統 | 選用 | VisMeasurementSystem | 要在新的文件中使用的度量單位。 如需可能的值,請參閱<備註>。 |
| Flags | 選用 | Long | 表示如何開啟新文件的旗標。 如需可能的值,請參閱<備註>。 |
| LangID | 選用 | Long | 此文件的語言識別碼。 請參閱<備註>一節。 |
傳回值
Document
註解
因為 AddEx 方法會套用到 Documents 集合,所以與 Add 方法類似,但是有一點例外,就是 AddEx 會提供數個其他引數,而呼叫者可在這些引數中指定此文件的建立方式。
MeasurementSystem 引數應該是下列其中一個 VisMeasurementSystem (宣告於 Visio 型別程式庫中) 成員。
| 常數 | 值 | 描述 |
|---|---|---|
| visMS故障 | 0 | 根據 [控制台] 中所設定的 [地區選項] 來選擇公制或英制。 |
| visMSMetric | 1 | 公制度量系統。 |
| visMSUS | 2 | 英制度量系統。 |
Flags 引數應該是下列其中一個或多個 VisOpenSaveArgs (宣告於 Visio 型別程式庫中) 成員的組合。
| 常數 | 值 | 描述 |
|---|---|---|
| visAddDocked | 4 | 在停駐視窗中加入文件。 |
| visAddHidden | 64 | 在隱藏視窗中加入文件。 |
| visAddMacrosDisabled | 128 | 加入已停用巨集的文件。 |
| visAddMinimized | 16 | 在最小化視窗中加入文件。 |
| visAddNoWorkspace | 256 | 加入不含任何工作區資訊的文件。 |
| visAddStencil | 512 | 加入新的樣板檔案。 |
LangID 參數應該是 Windows 用來編碼不同語言版本的標準 ID 之一。 例如,如果是英文版本的 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 支援與意見反應。