Visio) (Document.Clean 方法

會在文件中檢查、報告及修復選取的狀況。

語法

運算式。乾淨 (nTargets、 nActions、 nAlerts、 nFixes、 bStopOnError、 bLogFileName、 nReserved)

運算式 代表 Document 物件的變數。

參數

傳回值

無

註解

內部的 Microsoft Visio 開發人員應該使用 Clean 方法，驗證並最佳化 Visio 隨附的文件，協力廠商開發人員則可以針對他們自己的文件使用這個方法。

建議開發人員使用 nTargets 、 nActions 、 nAlerts 和 nFixes 的預設值，並在清理文件之前製作文件的備份副本。

您可以比較 Clean 方法執行前後所儲存的 VDX (XML) 版本文件，以識別 Clean 方法所做的文件變更。

nTargets 引數可以是 Visio 型別程式庫中 VisDocCleanTargets 中所定義常數值的任何組合，並如下表所述。

nActions、nAlerts 和 nFixes 引數可以是 Visio 型別程式庫中 VisDocCleanActions 中所定義常數值的任意組合，並如下表所述。

範例

下列程序會示範 Clean 方法的其中一種用法。 在此例中，會以原本繼承的相同值覆寫矩形的圖樣，以形成不必要的本機覆寫。 然後執行 Clean 方法來偵測此狀況，並且顯示讓使用者選擇是否要修正此狀況的警告。

1. 建立新的空白繪圖。

2. 使用 [矩形] 工具在繪圖頁面上繪製矩形。 如果在 ShapeSheet 視窗中檢視這個圖形，可以看到 LinePattern 儲存格中的值 ("1") 是黑色，表示這是繼承的值。

3. 以滑鼠右鍵按一下圖形，指向 [格式]，按一下 [線條]，然後在 [線條] 對話方塊中重新套用相同的線條樣式。 此舉會在圖形中建立本機值，又稱為本機覆寫。 現在如果在 ShapeSheet 視窗中檢視這個圖形，則可以看到 LinePattern 儲存格中的值是藍色，表示這是本機的值。

4. 將下列 Clean_Example 程序插入文件的 Microsoft Visual Basic for Applications 專案中：

5. 執行 Clean_Example 程序 (按一下 [檢視] 索引標籤上的 [巨集]；然後，在 [巨集] 對話方塊的巨集清單中，選取 [ThisDocument.Clean_Example]，再按一下 [執行])。

 
    Public Sub Clean_Example() 
     
        ActiveDocument.Clean, visDocCleanActLocalFormulas, _  
           visDocCleanActLocalFormulas, visDocCleanActLocalFormulas 
     
End Sub

繪圖頁面上會顯示警告，詢問您是否要移除不需要的本機覆寫。 如果您按一下 [是]，然後重新開啟 ShapeSheet 視窗，則可以看到 LinePattern 儲存格中的值又變回黑色，表示已還原成繼承的值。

支援和意見反應

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