Document.Clean 方法 (Visio)
會在文件中檢查、報告及修復選取的狀況。
語法
表達式。Clean (nTargets、 nActions、 nAlerts、 nFixes、 bStopOnError、 bLogFileName、 nReserved)
表達 代表 Document 物件的變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| nTargets | 選用 | Variant | 指出要檢查的文件部分。 如需可能的值，請參閱＜備註＞。 |
| nActions | 選用 | Variant | 指出要偵測的狀況。 如需可能的值，請參閱＜備註＞。 |
| nAlerts | 選用 | Variant | 指出偵測到狀況後，需要回報的狀況。 如需可能的值，請參閱＜備註＞。 |
| nFixes | 選用 | Variant | 指出偵測到狀況後，需要修正的狀況。 如需可能的值，請參閱＜備註＞。 |
| bStopOnError | 選用 | Variant | 如果在修正偵測到的狀況時發生錯誤，非零 (True) 的值會造成處理停止，零 (False) 值則允許繼續處理。 |
| bLogFileName | 選用 | Variant | 保留供日後使用。 |
| nReserved | 選用 | Variant | 保留供日後使用。 |
傳回值
無
註解
內部的 Microsoft Visio 開發人員應該使用 Clean 方法，驗證並最佳化 Visio 隨附的文件，協力廠商開發人員則可以針對他們自己的文件使用這個方法。
建議開發人員針對 nTargets 、 nActions 、 nAlerts 和 nFixes 使用預設值，並在清除檔之前建立文件的備份複本。
您可以比較 Clean 方法執行前後所儲存的 VDX (XML) 版本文件，以識別 Clean 方法所做的文件變更。
nTargets 自變數可以是 Visio 類型連結庫中 VisDocCleanTargets 中定義之常數值的任何組合，如下表所述。
| 常數 | 值 | 描述 |
|---|---|---|
| visDocCleanTargAll | &HFF | 檢查 nTargets ) 的所有物件 (預設值。 |
| visDocCleanTargFPages | &H1 | 檢查前景頁面 |
| visDocCleanTargBPages | &H2 | 檢查背景頁面 |
| visDocCleanTargMasters | &H4 | 檢查主圖形 |
| visDocCleanTargStyles | &H8 | 檢查樣式 |
| visDocCleanTargDoc | &H10 | 檢查文件工作表 |
| visDocCleanTargPageSheet | &H100 | 檢查頁面工作表 |
nActions、nAlerts 和 nFixes 自變數可以是 Visio 類型連結庫中 VisDocCleanActions 中所定義常數值的任何組合，如下表所述。
| 常數 | 值 | 描述 |
|---|---|---|
| visDocCleanActLocalFormulas | &H1 | 偵測不必要的本機覆寫 |
| visDocCleanActEmptyRowsAndSects | &H2 | 偵測空的本機列及區段 |
| visDocCleanActNonDefaultFonts | &H4 | 偵測非預設字型設定 |
| visDocCleanActStaleResults | &H8 | 偵測與公式不相符的結果 |
| visDocCleanActMissingSubs | &H10 | 偵測遺失的訂閱 (儲存格相依性) |
| visDocCleanActConstantFormulas | &H20 | 偵測可從結果產生的公式 |
| visDocCleanActNearZero | &H40 | 偵測幾乎為零的結果並將它們變更為零 |
| visDocCleanActDuplicateSubs | &H80 | 偵測重複的訂閱 (儲存格相依性) |
| visDocCleanActBadDisplayLists | &H100 | 偵測無效的顯示清單連結 |
| visDocCleanActDeletedFields | &H400 | 偵測刪除的欄位 |
| visDocCleanActBadFieldFormulas | &H800 | 偵測遺失公式或公式不標準的欄位 |
| visDocCleanActBadFieldMarks | &H1000 | 偵測計數及標記值不同步的欄位。 變更逸出字元的位置以符合字元計數 |
| visDocCleanActBadReferences | &H2000 | 偵測有 #Ref() 錯誤的公式 |
| visDocCleanActAll | &H3FFF | 執行所有動作 |
| visDocCleanActDefault | &H1FD8 | 偵測 (nActions ) 預設值的默認條件。 |
| visDocCleanAlertDefault | &H0 | 要報告的默認條件 (nAlerts ) 的預設值。 |
| visDocCleanFixDefault | &H3D8 | 修正 nFixes ) (預設值的默認條件。 |
範例
下列程序會示範 Clean 方法的其中一種用法。 在此例中，會以原本繼承的相同值覆寫矩形的圖樣，以形成不必要的本機覆寫。 然後執行 Clean 方法來偵測此狀況，並且顯示讓使用者選擇是否要修正此狀況的警告。
建立新的空白繪圖。
使用 [矩形] 工具在繪圖頁面上繪製矩形。 如果在 ShapeSheet 視窗中檢視這個圖形，可以看到 LinePattern 儲存格中的值 ("1") 是黑色，表示這是繼承的值。
以滑鼠右鍵按一下圖形，指向 [格式]，按一下 [線條]，然後在 [線條] 對話方塊中重新套用相同的線條樣式。 此舉會在圖形中建立本機值，又稱為本機覆寫。 現在如果在 ShapeSheet 視窗中檢視這個圖形，則可以看到 LinePattern 儲存格中的值是藍色，表示這是本機的值。
將下列 Clean_Example 程序插入文件的 Microsoft Visual Basic for Applications 專案中：
執行 Clean_Example 程序 (按一下 [檢視] 索引標籤上的 [巨集]；然後，在 [巨集] 對話方塊的巨集清單中，選取 [ThisDocument.Clean_Example]，再按一下 [執行])。
Public Sub Clean_Example()
ActiveDocument.Clean, visDocCleanActLocalFormulas, _
visDocCleanActLocalFormulas, visDocCleanActLocalFormulas
End Sub
繪圖頁面上會顯示警告，詢問您是否要移除不需要的本機覆寫。 如果您按一下 [是]，然後重新開啟 ShapeSheet 視窗，則可以看到 LinePattern 儲存格中的值又變回黑色，表示已還原成繼承的值。
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。