首先用jEdit開啟C:\Program Files\jEdit\Macros\Text\Insert_Date.bsh,我們看到的就像是一個
標準的Java程式,先是定義了一個函數insertDate( ),最後面再叫用此函數,百分之九十五的程式都是一看就懂,在第53~55行的地方才
是我們要注意的重點:
// inserting date and internet time to textarea
textArea.setSelectedText(Calendar.getInstance().getTime().toString
() + " @" + (int)swatch + " /Internet Time/");此段程式使用系統變數textArea的
setSelectedText( ) method把目前時間插入選取文字。
jEdit有幾個預設好了的系統變數,用來表示jEdit的各項主要元件,透過這些變數就能存取jEdit的各個設定並做需要的操作:
*textArea:代表的是編輯區的文字區域
*buffer:代表了目前編輯中的檔案緩衝區
*view:代表了目前編輯中的檢視物件,UI的輸出都要透過此物件
第58~61行出現了另一個jEdit的類別Macros:
if (buffer.isReadOnly()) Macros.error(view, "Buffer is read-
only.");else insertDate();buffer.isReadOnly( )判斷目前編輯檔案是否是唯讀狀態,如果是唯讀的檔案
則不能插入時間,而以Macros.error( )於當前的view顯示錯誤對話窗。Macros類別提供了許多放的method,按F1開啟
jEdit Help找到'jEdit API Reference'裡的org.gjt.sp.jedit package,其內有包含Macros
在內的許多系統類別;Macros有幾個method經常會使用到:
*Macros.error(view, "message"): 顯示錯誤訊息窗
*Macros.message(view, "message"); 顯示訊息窗
*Macros.input(view, "message", default-value); 顯示輸入對話窗
再來看另一個巨集:C:\Program Files\jEdit\Macros\Text\Insert_Tag.bsh,這個巨集將選取文字組成
HTML標籤。重點解說如下:
行號 程式碼片段 說明
29 caret = textArea.getCaretPosition(); 取得目前游標位置
30 tag = Macros.input(view, "Enter name of tag:"); 讓使用者輸入標籤名稱
32 text = textArea.getSelectedText(); 取得選取文字
38 textArea.setSelectedText(sb.toString()); 把組好的文字寫回選取文字
我們可以注意到caret、tag、text等變數都沒有宣告型別而能直接使用,這是BeanShell和Java的一個重大差異,在
BeanShell裡的變數可以不用事先宣告且能任意變型,這個特性當然能帶來方便性,但要小心日後的維護性。