Question

使用此命令显示“修改模板”对话框。模板为预定义文本，可在稍后自动撤销并插入一个文件。可通过“模板组”下拉菜单选择哪些模板列于“模板”窗格中。

模板划分为四个组：全局、环境、语言和项目。全局模板始终可用；环境模板仅当加载了与之相关的环境时才可用；语言模板与高亮语法指定的语言有关，且当编辑文件的扩展名与该语言匹配时才可用；项目模板在加载与之相关的项目时才可用。

可以定义无限数量的模板。前 20 个全局模板的每个模板可在稍后通过热键 Alt+0 至 Alt+9 以及 Shift+Alt+0 至 Shift+Alt+9 予以调用，或任何模板可通过插入”模板“对话框或自定义热键予以调用。

每个模板可任意选择与之相关联的一个名称，如果被定义，当插入一个模板时会出现在工具栏的工具提示上和模板列表中。项目模板保存在项目设置对话框中指定的目录/文件中。

如使用默认环境，“全局”模板存储于默认目录中的 UETMPLTE.DAT 文件中，或“高级”菜单中“配置”下“目录”分支下指定的目录中。内置环境和自定义用户环境将“环境”模板保存于环境目录中与环境有关的文件中。当“语言”模板与 wordfiles 中指定的语言相关联时，被存储于默认的 wordfiles 目录中。

占位符变量 通过语法【+VariableName+】，用户可在模板中定义“占位符”变量，当插入模板时，占位符将在模板编辑模式中高亮显示，这样用户可键入占位符值来重新命名变量。该变量所有资源指引将被更新。按 TAB 键将移至下一个占位符变量。例如，如用户插入模板：

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

然后键入针对 [+function+] 变量的 “myFunc" 及针对 [+scope+] 变量的 “private"，他会看到：

// function myFunc private function myFunc () {
^ <-- caret blinking here
}

如按 ESC 或 ENTER 键，模板将被永久插入活动文档，且模板编辑模式将不再被激活。

[DATE_DMY]	转换为“日/月/年”格式的当前日期。
[DATE_MDY]	转换为“月/日/年”格式的当前日期。
[DATE_TEXT]	转换为以文本显示日期格式的当前日期。
[TIME]	转换为 24 小时制的当前时间。
^	用来指定模板插入后光标所处位置。
[FULL_FILE_NAME]	转换为活动文档的完整路径和文件名。
[FILE_PATH]	转换为活动文档的驱动器和路径。
[FILE_NAME]	转换为活动文档的根文件名。
[FILE_EXTENSION]	转换为带有“.”的活动文档的文件扩展名，如“.txt”。
[FILE_EXTENSION_NP]	转换为不带“.”的活动文档的文件扩展名，如“txt”。
[$REPLACE$]	用活动文档中选定文本替换。当用模板插入时，选区将被转换为大写字母。
[$replace$]	用活动文档中选定文本替换。当用模板插入时，将保留选区当前的大小写。

注意 - ^ 这里所涉及的字符“^”不是控制键 + 值。

另外，对于扩展的日期和时间格式，UltraEdit 支持下列增强功能:

时间

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

对于本地时间，使用下列标记:

[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':'sstt"

这些字符必须在标记之间，例如:

[TIME_USER]hh':'mm':'sstt[TIME_USER_END]

日期

在你的模板中用下列语法指定 USER DATE 格式：

对于本地日期，使用下列标记:

[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]

描述

如有必要，用户可以包括模板的描述。描述限定为 79 个字符。光标悬停在模板列表的模板名称上，将会显示工具提示，同时显示标签模板描述，后跟特定的描述内容。如果未指定描述内容，将会显示标签模板摘录，同时显示模板自身的开始部分。

插入模板

如在高级-> 配置 -> 模板下键入被激活时，选项为“自动建议”智能模板，且当用户在键入与一个定义的模板名相匹配的一个字符串时暂停，UltraEdit 会基于最后键入的内容“建议”一个模板，用户可按 TAB 键插入建议的模板。

例如，如用户有一个 C/C++ 模板命名为 “void”，且正在编辑一个 *.cpp 文件并键入 “void”，然后暂停，则 UltraEdit 会在一个特殊的“建议”模式中自动插入 “void” 模板。要完成模板的插入，用户应按 TAB 键。用户在看到建议的模板在高级 -> 配置 -> 模板下“暂停后"域中被定义之前必须等待片刻。

另外，用户在编辑时可按 Ctrl+Space 键来调用“自动完成”对话框，任何定义的其名称与插入符号后的字串符相匹配的模板将同样列在“自动完成”对话框中。如需要，用户可在这里选择一个模板并插入。