顯示/修改模板命令

使用此命令顯示「修改範本」對話方塊。範本是可能在稍後自動重新叫用並插入檔案中的預先定義文字。「範本群組」下拉式功能表可用於選擇在「範本」窗格中列出的範本。

 

在三個群組中組織範本：全域、環境和語言。「全域」範本一直可以使用，「環境」範本只有在載入與其關聯的環境時才能使用，「語言範本」與針對語法突顯的語言有關聯，而且只有在編輯符合該語言的檔案 (有附檔名) 時才能使用。

 

可定義不限數目的範本。在稍後使用快速鍵 Alt+0 到 Alt+9 和 Shift+Alt+0 到 Shift+Alt+9 可以重新叫用前 20 個全域範本，或使用「插入範本」對話方塊或使用者定義的快速鍵可以重新叫用任何範本。

 

每個範本可能有一個有關聯的名稱，如果已定義，在插入範本時會顯示在工具列的工具提示上和範本清單中。

 

如果使用預設環境，「全域」範本會儲存在預設目錄或「進階」功能表的「組態」下的「目錄」分支下的指定目錄中。內建環境和自訂的使用者環境將環境範本儲存在環境目錄中的環境相關檔案中。語言範本儲存在預設的文字檔案目錄中，因為他們與文字檔案中的指定語言有關聯。

 

預留位置變數

使用語法 [+VariableName+]，使用者可以定義範本中的 "placeholder" 變數，而且在插入範本時，範本編輯模式中的預留位置會反白顯示，因此使用者可以輸入預留位置值將變數重新命名。然後更新所有出現的變數。按下 TAB 會使焦點移到下一個預留位置變數。例如，如果使用者插入範本：

 

// function [+function+]
[+scope+] function [+function+] () {
^
}

 

，然後輸入 "myFunc" 用於 [+function+] 變數，輸入 "private" 用於 [+scope+] 變數，則使用者會看到：

 

// function myFunc
private function myFunc () {
^ <-- 插入號在這裏閃爍
}

 

如果按下 ESC 或 ENTER，範本會永久插入使用中文件中，而且範本編輯模式將不再作用。

 

[DATE_DMY]	轉換為「日/月/年」格式的目前日期。
[DATE_MDY]	轉換為「月/日/年」格式的目前日期。
[DATE_TEXT]	轉換為以文字顯示日期格式的目前日期。
[TIME]	轉換為 24 小時制的目前時間。
^	用來指定模板插入後游標所處位置。
[FULL_FILE_NAME]	轉換為作用中文件的完整路徑和檔案名稱。
[FILE_PATH]	轉換為作用中文件的磁碟機和路徑。
[FILE_NAME]	轉換為作用中文件的根檔案名稱。
[FILE_EXTENSION]	轉換為作用中文件的檔案副檔名。
[$REPLACE$]	用作用中文件中選定文字替換。當用模板插入時，選區將被轉換為大寫字母。
[$replace$]	用作用中文件中選定文字替換。當用模板插入時，將保留選區目前的大小寫。

 

注意 - ^ 這裡涉及的字元「^」不是控制鍵 + 值。

 

另外，對於擴展的日期和時間格式，UltraEdit 支援下列增強功能:

 

時間

用下列語法在你的模板中指定使用者時間格式:

 

對於本地時間，使用下列標記:

 

[TIME_USER]...這裡是時間格式字元...[TIME_USER_END]

 

對於本地時間，使用下列標記:

 

[TIME_USER_SYS]...這裡是時間格式字元...[TIME_USER_SYS_END]

 

時間格式字元象下面這樣定義:

如果你用空格來隔開格式字元中的元素，這些空格將在模板的同一位置出現，字母必須全部用大寫或小寫 (例如「ss」，沒有「SS」)。單引號標記內格式字串的字元將出現在模板的同一位置，不能更改。

 

字串	含義
h	沒有首位零的單數位小時，12 小時制
hh	帶首位零的單數位小時，12 小時制
H	沒有首位零的單數位小時，24 小時制
HH	帶首位零的單數位小時，24 小時制
m	不帶首位零的單數位分鐘數
mm	帶首位零的單數位分鐘數
s	不帶首位零的單數位秒數
ss	帶首位零的單數位秒數
t	單字元表示的上下午時間，像 A 或 P
tt	多字元表示的上下午時間，像 AM 或 PM

 

例如，要獲取時間字元

 

"11:29:40 PM"

 

使用下列的格式字元:

 

"hh':'mm':'ss tt"

 

這些字元必須在標記之間，例如:

 

 

[TIME_USER]hh':'mm':'ss tt[TIME_USER_END]

 

日期

在你的模板中用下列語法指定 USER TIME 格式:

 

對於本地日期，使用下列標記:

[DATE_USER]...這裡是日期格式字元...[DATE_USER_END]

 

對於系統日期，使用下列標記:

[DATE_USER_SYS]...這裡是日期格式字元...[DATE_USER_SYS_END]

 

日期格式字元定義如下:

使用下列元素組建格式字元。如果你在格式字元中用空格分隔元素，這些空格將在模板中以相同位置出現。該文字必須是與表中顯示的一樣用大寫或小寫 (例如「MM」不能是「mm」)。格式字元中的用單引號標記關閉的字串將出現在模板中相同位置，不會作任何改變。

 

字串	含義
d	不帶首位零的單數位表示的每月中的天。
dd	帶首位零的單數位表示的每月中的天。
ddd	用三個文字縮寫表示的星期中的天。
dddd	每星期中的天的全名。
M	不帶首位零的單數位表示的月份。
MM	帶首位零的單數位表示的月份。
MMM	用三個字母縮寫表示的月份。
MMMM	用全名表示的月份。
y	年份中的最後兩個數位，但年份小於 10 則不帶首位零。
yy	年份中的最後兩個數位，但年份小於 10 附帶首位零。
yyyy	完整四個數位表示的年份。

 

例如，要獲取日期字元

 

"Wed, Aug 31 94"

 

使用下列的描述字元:

 

"ddd',' MMM dd yy"

 

這些字元必須在標記之間，例如:

 

[DATE_USER]ddd',' MMM dd yy[DATE_USER_END]

 

插入範本

如果選項在「進階」->「配置」->「範本」下啟用輸入時自動建議智慧範本，而且使用者在輸入符合定義的範本名稱的字串時暫停，UltraEdit 將會根據輸入的內容「建議」範本，然後使用者可以按 TAB 插入建議的範本。

 

例如，如果使用者有名為 "void" 的 C/C++ 範本，而且正在編輯 *.cpp 檔案並在輸入 "void" 後短暫暫停，UltraEdit 將會自動在特定「建議」模式中插入 "void" 範本。若要完成插入範本，使用者應按下 TAB。使用者在看到建議的範本之前所必須等待的時間定義在「進階」->「配置」->「範本」下的「暫停時間」欄位中。

 

此外，在編輯時，使用者可以按下 Ctrl+Space 來叫用自動完成對話方塊，而且名稱符合插入號旁的任何已定義範本也會列在自動完成對話方塊中。使用者可在這裏選擇範本，如果需要請插入此範本。