本節要做的是:檢查檔案是否已被 HotMetal 以外的程式改動過。這個機制由三個巨集串成:On_Document_Open_Complete、On_Document_Activate 與 On_Application_Activate。前面提過,這些名稱是預定義的,不能更改——名稱本身就指定了觸發事件的時機,這種事件與巨集的關聯是隱含的,無法透過任何設定改寫。
<MACRO name="On_Document_Open_Complete" lang="JScript"><![CDATA[
var name = ActiveDocument.LocalFullName;
if (Application.ReadableFileExists(name)) { // 若文件從未儲存過,什麼也不做
Application.Run("On_Document_Save");
}
]]></MACRO>
先取出當前檔案的路徑(ActiveDocument.LocalFullName),檢查該檔案是否可讀;接著執行 On_Document_Save 巨集。這裡的邏輯是:新建立、還沒存檔的文件沒有磁碟上的版本可比對,所以直接跳過。
<MACRO name="On_Document_Save" lang="JScript"><![CDATA[
var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFile(ActiveDocument.LocalFullName);
var mod = Date.parse(f.DateLastModified);
var props = ActiveDocument.CustomDocumentProperties;
if (props.count != 0) {
props.Add("LastMod", mod);
}
]]></MACRO>
這個巨集示範了 ActiveX 元件的使用方式:new ActiveXObject("Scripting.FileSystemObject") 建立微軟腳本庫的 FileSystemObject。接著 fso.GetFile(name) 取得磁碟上的檔案物件,再從 DateLastModified 屬性取出最後修改時間並用 Date.parse 轉成毫秒數。
然後透過 ActiveDocument 的 CustomDocumentProperties 屬性建立一個自訂屬性集合,並用名為 "LastMod" 的屬性把這個時間戳存進文件本身。也就是說,時間戳不是存在外部檔案裡,而是伴隨文件走——這是個聰明的設計。
<MACRO name="On_Document_Activate" lang="JScript" id="44" desc="Runs Macro: Hide_On_Document_Activate"><![CDATA[
// 只處理本地文件
if (ActiveDocument.FullName == ActiveDocument.LocalFullName) {
var name = ActiveDocument.LocalFullName;
if (Application.ReadableFileExists(name)) {
var fso = new ActiveXObject("Scripting.FileSystemObject");
var f = fso.GetFile(name);
var newMod = Date.parse(f.DateLastModified);
var props = ActiveDocument.CustomDocumentProperties;
if (props.count != 0) {
oldMod = props.Item("LastMod").value;
if (oldMod != newMod) {
var Yes = 6;
var No = 7;
var msg = "The disk version of this document has changed from the\n";
msg += "version in memory. Do you want to re-open the document?";
var ret = Application.MessageBox(msg, 36, "Document Changed");
if (ret == Yes) {
ActiveDocument.Reload();
}
}
}
}
}
]]></MACRO>
這個巨集在文件被切換到前景時執行。它比對磁碟上檔案的修改時間與記憶體中記錄的時間戳,若兩者不同就提示使用者。
幾個細節值得注意。開頭的 if (ActiveDocument.FullName == ActiveDocument.LocalFullName) 是為了排除遠端檔案——只有本地檔案才有可靠的磁碟時間可比。Application.MessageBox 的第二個參數 36 是「是/否」按鈕加上問號圖示的組合常數,回傳值用 6 代表 Yes、7 代表 No。若使用者選擇重新載入,就呼叫 ActiveDocument.Reload()。
這整套機制的價值在於解決一個真實的協作問題:多人或跨工具編輯同一個檔案時,你可能正在編輯一個已經過時的版本,而不自知。自動偵測並提示,能避免大量白工與覆蓋他人修改的風險。