多人協作或同時開著好幾個編輯器時,最麻煩的莫過於「我手上的版本」和「磁碟上的版本」已經不是同一份了。HoTMetaL PRO 6.0 提供了幾個預先定義好的事件宏,只要把檢查邏輯掛上去,就能在文件開啟、視窗切換的瞬間自動比對時間戳,避免拿舊內容覆蓋掉別人的心血。
這裡要動用到三個事件宏:On_Document_Open_Complete、On_Document_Activate 與 On_Application_Activate。它們的名稱是 HoTMetaL 內建的約定,事件與宏之間的對應關係是隱含的,無法自行改寫,我們能做的只是往裡頭填程式碼。
每次文件開啟完畢,這個宏就會被呼叫。它先取出目前文件的完整路徑,確認磁碟上真的有這個檔案(從未存檔過的新文件就什麼都不做),接著呼叫存檔宏把時間戳記下來。
<MACRO name="On_Document_Open_Complete" lang="JScript"><![CDATA[
var name = ActiveDocument.LocalFullName;
if (Application.ReadableFileExists(name)) { // 從未存檔的文件直接略過
Application.Run("On_Document_Save");
}
]]></MACRO>
關鍵在最後那一行:與其重複寫一遍取時間的邏輯,不如直接重用 On_Document_Save,這也是後面幾個宏能保持精簡的原因。
這個宏示範了如何透過 ActiveXObject 使用微軟的 FileSystemObject 腳本元件,核心目標是把磁碟上文件的當前時間寫進文件的 LastMod 屬性。
<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>
流程很直白:建立 FileSystemObject 物件 → 用 GetFile() 取得檔案 → 用 DateLastModified 讀出最後修改時間並轉成數值 → 透過 ActiveDocument.CustomDocumentProperties 建立名為 LastMod 的使用者自訂屬性。
這個宏負責真正的「查哨」工作:把磁碟上的時間和記憶體中記錄的時間比一比,若不一致就提示使用者是否重新載入。
<MACRO name="On_Document_Activate" lang="JScript" id="44"
tooltip="Hide_On_Document_Activate"
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();
}
// 不管使用者怎麼選,都重設時間戳,免得對話框反覆跳出
Application.Run("On_Document_Open_Complete");
}
}
}
}
]]></MACRO>
值得注意的細節有兩個。第一是開頭的判斷式,只對本地文件生效,網路或 UNC 路徑的檔案直接跳過。第二是最後那句「無論使用者選是或否都重設時間戳」的設計,否則同一個警示會在每次切回視窗時反覆跳出,反而變成干擾。
如果希望「只要 HoTMetaL 視窗變成使用中」就檢查,不必重寫邏輯,直接轉呼呼叫即可:
<MACRO name="On_Application_Activate" lang="JScript"><![CDATA[
Application.Run("On_Document_Activate");
]]></MACRO>
存檔為其他名稱同樣會產生新檔案,因此也要更新時間戳,做法一樣是重用:
<MACRO name="On_Document_SaveAs" lang="JScript"><![CDATA[
Application.Run("On_Document_Save");
]]></MACRO>
步驟很簡單:先在 HoTMetaL PRO 6.0 開啟一份文件,再用記事本或任何你順手的編輯器開啟同一個檔案,隨便插入一個空白字元後存檔,然後切回 HoTMetaL 視窗。如果一切正常,你應該會看到類似下圖的提示:

(圖1)