翻译.txt

批处理阶段教程奥运最终版[英雄出品] exe版加了20天时间限制

cls [colors] save [ID number]
cursor [line] [+feeds] restore [ID number]
ansi? [code] font [33|25]
stdout @file[:label] pal

fix box|menu|list... (前缀: 对话框将保持可见当关闭时)

参数的细节请见下面的细节。
关于指令的功能性请参见 WBAT 浏览。
:

:wbat-batch
# W.BAT的结构 ^

为了能产生用于批处理的变量， 需要一个专门的结构。 原来那种直接在程序里设置变量的方法已经不再支持。 因为它不能在视窗 NT/2000 之下工作, 而且对 Windows 版本来说是不安全的。

当你想要 WBAT 生产“变量”时(用于 box/menu/list 指令)，

你必须用: call W.BAT <command> <parameters>
来代替 : WBAT.....

文件 W.bat 运行 WBAT.COM, 而且能很好的运用变量。
请阅读 W.bat 指令(下一页)来获得相关的重要信息。

作为一个更替，WBAT 能将设置定义写给 STDOUT，用于重定向到一个临时的批处理文件。
:

:wbat- menu [x]
[ W.BAT & command ]
[ W.BAT & details ]
[ STDOUT method ]
:

:wbat-command
# W.BAT ^

批处理文件 W.bat 传递指令参数给 WBAT.COM。最多允许9个参数，但是通常你不需要那么多。

例: call w.bat box 5,12 (+white on blue) @file.ext:label #3,5
--------1--2--3-----4----5---6----------7---------8-9

避免布局参考的空间，同时在颜色表达式中使用 "+" 代替 "明亮的"。 作为更替，整个参数字串可用双引号括起来 (不能在 DOS 6.x或更早期的版本下工作).

例子: call w.bat "box 5,12 (+white on blue) @file.ext:label #3,5"

引号内的字符串将作为单一的指令参数传递给w.bat。 WBAT.COM 将忽略引号。

注意:
“quick box”(没有布局)不能被用于 CALL W.BAT 结构。只通过 errorlevel 处理。
:

:wbat-details
# W.BAT的工作方式...

只在你感兴趣的情况下阅读这一部分。

在W.BAT的第一行运行给出参数的WBAT.COM：

WBAT $W %%1 %%2 %%3 %%4 %%5 %%6 %%7 %%8 %%9

$W 参数告诉 WBAT.COM 从它运行的位置(目录)打开批处理文件 (也就是 W.BAT，与 WBAT.COM 在同一目录)，并且从这个文件的第二行开始写设置定义，因此，他们将会在第一行执行完后被正确执行 (也就是 WBAT.COM 结束).

不要改变 W.BAT 的第一行。当每一次W.bat运行时，其它的行将被重写。

注意：万一你想重新命名 W.BAT: 只支持一字节的文件名，并且第一行的 $W 参数必须改变为文件名的名字(如T.BAT就为$T)。
:

:wbat-stdout
# 通过 STDOUT 设定变量 ^

WBAT 也支持一个更传统的方法生产变量，这在只读媒体(这时W.BAT不能运行)运行WBAT是很有用的。

当 wbat.com 发现输出重定向到一个文件时，SET 指令将写给STDOUT，文件必须是一个批处理(.BAT)文件，这样才能被调用来执行 SET 命令。

例子: wbat box :start_menu > %%temp%%\wtemp.bat
call %%temp%%\ wtemp.bat

推荐使用 %%temp%% 目录。
不要忘记删除临时文件。
::

:multiple
# 多重指令 ^

WBAT 能够在一行中接收几个命令。用感叹号(!)分开这些指令。

例子:
wbat cls ! text 2,5 @file.ext:label1 ! box continue,back
--- ------------------------------------------
wbat pal ! font ! cls
--- -------

程序名 WBAT 需在开始时写一次。

注意:

如果“box”指令 (box/menu or list) 被包括在内，则必须放置于最后一行。

在多重指令行中不能使用 CALL W.BAT 结构。
:

:Position
# 位置和大小 ^

所有的对话框都能定义位置(行和列)，就跟 TEXT 和 FILL 一样。位置通常是指对话框的左上角。 本位是 1,1.

如果一个 box 或 text 输出超过正屏幕的右下角边缘，WBAT 将自动调整位置。

默认值：

boxes(box/menu/list) 放置于屏幕中央，如果只有行坐标被规定，box将放置于水平中间位置。

Text 和 Fill 将从本位开始 (1,1)
:

:Dimensions
# 大小 ^

boxes 和 text 的输出大小由layout定义(最长的行和行数)。

FILL 允许指定的行和列，用圆括号()括起来。

例子: wbat FILL 5,12 (10,30) (white on blue) "<>"

默认大小: 上至屏幕边缘。
:

:colors
# 颜色 ^

内定的颜色在 WBAT.INI 中定义。 如果 INI 文件不存在，或颜色在 INI 文件中没有定义，内建的默认值将被使用。( 相同于原始的 INI 文件)

WBAT 支持不同的颜色规格:

box/menu/list 对话框颜色
text 本文颜色
fill/cls 填充颜色

(颜色表达式总是用圆括号()括起来)

其他的颜色, 如按钮和条的颜色，能在你的处理中通过变量来改变。

注意:
默认的文本颜色是当前的屏幕的文本颜色(而不是由INI指定)
:

:color-expressions
# 彩色表达式 ^

颜色用这个格式定义: <前景> ON <背景>。单词“ON”是可选的。
在DOS对话框中，十六种颜色是可用的。 (8个正常,8 明亮的)

颜色: black,red,green,blue,brown,cyan,magenta,white

可选择的: bright 或用 “+”符号

同义字: light=bright
yellow=bright brown
grey/gray=(normal)white

例子: bright brown on blue
+brown on blue
black on +brown

注意: WBAT指令中的颜色表达式总是用圆括号()括起来。
:

:layref-menu [x]
[ default files ]
[ local batches ]
[ global batches]
[ layout in &BAT]
[ def. &extension]
:

:layref
# 布局参考 ^

box/menu/list 指令的布局由文件名和标签定义。

* 文件名前加一个前缀@ e.g. @dialog.txt
* 标签前加一个前缀: e.g. :START

例子: call w.bat box @dialog.txt:START

通常，你能依照 DOS 习惯定义文件，或者没有路径, 或者是相对路径，或者是完整的路径 (只能使用DOS 8.3 的命名规则)。
特别的， “+”前缀是指 WBAT 的 "公用" 目录。

例子: call w.bat box @+dialog.txt:START

在大多数情况下你，将可省略文件名字，因为 WBAT 提供一个容易的方法使用默认的文件。

注意: 不要漏掉布局文件的扩展名。
参见“default extension”。
:

:layref-default
# 默认的布局文件名 ^

在提供的INI文件里，默认的布局文件是WBAT.TXT，用于这个演示。建议指定默认的文件时不要用路径。 使用“WBAT.TXT”或其他任何你喜欢的名字。

如下面的例子，你可以用本地的默认名字，就跟在全局的布局文件一样：

call w.bat box :START 用于 WBAT.TXT 在当前目录
call w.bat box +:START 用于 WBAT.TXT 与WBAT.COM同一个目录

注意: 当布局参考是用“+”或“:”开始时，“@”符号并不需要。
:

:layref-local
# 调用本地布局文件的本地批处理 ^

当批处理总是在自己的目录中运行时，你可以使用本地的布局文件(在同一个目录里)，不需要指定路径。

例子: call w.bat @layout.txt:START
或 call w.bat :START (用于默认是 WBAT.TXT 的情况)

注意:

请确认：当WBAT运行时，当前驱动器和目录必须能在你的目录中被完全的选择。

要知道批处理(或在批处理中运行的程序)可能在程序返回到主菜单前改变驱动器号和/或目录。

推荐你适当的设置你的驱动器和目录(因为这种情况下你要处理其他文件)。

关于更替，请参见下面。
:

:layref-global
# Global layout file ^

如果批处理是设计为在任何的目录中运行，BAT文件就必须在PATH设置的目录里。

因为没有“地方目录”那可以装载，必须告知 WBAT 源文件的位置。

为了避免定义完全路径，把布局文件在和 WBAT.COM 相同的目录里。 你总是可以用“+”前缀来指向这一目录。

举例来说: call w.bat +Xproject.txt:start
或: call w.bat +:start (对于默认的布局文件是 WBAT.TXT 的情况)

注意: 你不需要为每个项目设计一个单独的文件。只须确定文件内没有重复的标签。布局文件的大小没有限制。
::

:layref-bat
# 批处理文件中的布局源 ^

如果你喜欢把布局直接放置在批处理文件中，请确定批处理过程不会陷入布局部分，并且没有任何重复的标签。 为了指定批处理文件作为布局源，可使用“%%0 批参数。

例子: call w.bat box @%%0:Box-layout

WBAT 将会检查有效路径变量里的目录来定位文件，你不必担心布局文件的适当的目录。

这方法较适合”全局的“批处理，文件能通过路径来定位。在其他的情况下，这个方法是安全的，只要你不改变当前的目录和驱动器号(%%0包括了批处理文件的完整路径)。

注意： DOS 用命令代替了 %%0 ，就象敲入DOS命令一样。
:

:layref-extension
# 默认的扩展名 ^

实际情况下，插入DOS的指令用%%0参数替代，扩展名.BAT可以省略。

要使%%0参数工作，WBAT 假设默认的扩展名是.bat，无论何时，都可指定没有扩展名的布局文件。

基于这一个理由，不要使用真的没有扩展名的布局文件。
:

:bar-options
# Bar options ^

默认的高亮条目设置成对话框、菜单、列表的第一选项。要改变这个位置，可在选项号前加一个“#”作为最后的参数。

例子: call w.bat :main #3

条目的位置参数也接受如 a-b 或 a+b 一样的数学表达式。
这可用于菜单里预设选择下一个选项。

关于详细的信息请参见“Control”部分 (使用变量，? 变量).
:

: time-out
# time-out ^

可选的，超时设置可使用于在(设置的)秒数后自动关闭对话框，并返回预设的选项作为被选择项。

例子: call w.bat box :main #3,5

重要的：

预选项必须是一个按钮，因为当超时时 WBAT 产生一个 ENTER 键，而 ENTER 关闭对话框只能通过按钮!

当一个键被按下或鼠标被单击时，超时将被取消，但不管有没有效的输入都没有影响。

最大的超时：3,600 秒 (1 小时)

倒数计时显示装置：

你可以在对话框的任何位置显示倒数计时，在布局中用“#”表示
详情请参见“Layouts / Timer Display”
:

:layout-menu “对话框、菜单、文本布局的设计” [x]

[ General info ] 标签，大小，变量
--------------------------------------------------------------?
[ Box Style ] 框体，阴影，标题，[x] ，分割线。
--------------------------------------------------------------?
[ Control Elements] 按钮,&热键，输入和其他的元件
--------------------------------------------------------------?
[ Text Attributs ] 本文高亮和表头线
--------------------------------------------------------------?
[ Timer Display ] 倒数计时闭一个对话框
--------------------------------------------------------------?
[ Symbol Summary ] 所有的特殊符号
--------------------------------------------------------------?
[ Color Test ] 见 Colors.bat
------------------------------------------------------?[ 结束 ]
:

:layout-title
? 谀哪口口哪目? 口穆目谀哪縙
? 媚哪蠢穆馁? 吵忱 ? 滥哪?
聊哪倭 ? ? 滥哪倮哪馁 ? 滥哪?
:

:layout-general
# 一般信息 ^

一个布局可以自成一个文件，也可以跟其他的布局单元合在一起，这时每个布局都用“标签(label)”识别身份。

标签的前面有一个冒号(:)， 像批处理文件。但长度没有象DOS和Win9x 那样的 8 个字符的限制。

布局是一个纯 ASCII 本文。用方括号[]括起来的对话框的控制元件能被放置在任何地方。布局的结束是在最左端的一列加一个冒号(:)(这个冒号也可以是下一个布局标签)

布局总是产生一个矩形的区域, 这个矩形的大小取决于最长的行和行的数目。对话框将加在一个框架(同上下左右各一条线组成)上，其它空间，将由空白空间和空行填充。

注意：为防止你的编辑器将一行后面的空白字段截去，可用脱字符(^)来标记行的结束(这将不会显示出来)。
:

:layout-variables
# 在布局中使用环境变量 ^

在批处理文件中，变量 ( 带%符号) 会被替代。
例外: 不能在控制元件中使用变量。 (如：按钮)

例子 (assuming FILE=SAMPLE.TXT)
在布局中: read %%file%% for details
在输出中: read SAMPLE.TXT for details

注意：字串的大小会影响对话框的宽度! 对话框的行数超过 78bytes 将产生错误信息。
文本超过 80bytes 将被切断。
.386
固定输出长度的变量能通过用下划线填充来完成。 这保留的“栏位”(包括变量的名字)将
填充进字串里。 根据实际的大，字串将会被填时空白空间或被切断(!)。

例子
在布局中: %%VAR%%__________ %%VAR2%% or more text ...
在输出中: actual string string2 or more text ...
:

:layout-Style
# 布局类型 ^

WBAT 从 WBAT.INI 里读取颜色和其他的设定。

你可以使用你的偏爱设置， 并将它用于你的所的对话框和其他的WBAT输出。

当然，你可以用变量来临时改写所有的 INI 文件的设定
( 变量名 =W项目名).
详见“Setup/INI file/override部分”

注意：对话框颜色也在box/menu/list指令中指定。
:

:style-menu "Box style" [x]

[ frame and shadow ]
[ title and deviders ]
[ highlighting ]
[ extra ESC button ]
::

:Style-frame
# 对话框的框架

在这个演示中使用了一个空白的框架，但是你也可以在 INI 文件中定义一个不同的图案： 在 3 点之前想像一个 3 的最小架框,
谀縹
举例来说: ~?硚 然后排成一列放 9个字符: "~ 谀砍忱馁~"
~ 滥賬
中央的字符应该是空白，因为它将填充对话框。

# 对话框阴影

当在INI文件里找到有效的阴影颜色时，一个阴影将是可见的(默认值：淡黑色)

要关掉阴影, 请设置“shadow=NONE
::

:style-title
# 对话框标题

对话框标题(替代上边框，见下述)可在布局的标签行里设置。双引号是必须的。

例子: :style-menu "Box style"
.....

标题位于中间。 颜色由 INI 文件里的BoxTitle 指定。

# 分割线

为了产生不同颜色的分割线，可使用“?”字符(ASCIII 码: 196)。这将总是显示INI文件里定义的颜色来显示分割线。只有前景颜色才有(背景规定会被忽略).
::

:style-highlighting
# 对话框的高亮文本 ^

要高亮一个单词或文本段，可在单词或文本段的开始和结束处加符号 (~)。

颜色由 WBAT.INI 里的 BoxHi 定义。

注意:
相同的功能可用以 TEXT 输出。 ( 颜色由 INI 文件里的 TextHi 定义)，“~”符号可用其他符号代替，要在 INI 文件里的“general”部分定义HiSymbol。
HiSymbol。

:

:style-extra
# 特别的 ESC 按钮

如果你希望在对话框的右上角有 Windows 风格 [x] 按钮，将它加入布局文件的标签行里。

例子: :style-menu "Box style" [x]

或: :any_box [x]

方括号[]是不可缺少的，任何符号都可用来代替“x”。

注意:

点一下 [x] 按钮有与按ESCAPE键相同的效果。
:

:Layout-control
# 布局中的控件

所有的控件都被括在方括号[]里。

第一个字符决定控件的类型: