翻译.txt

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

:Start
# WBAT 对话盒工具 ^

WBAT 是一个在DOS中模拟 Windows 界面的对话框的一个批处理工具
。 当然 WBAT 也运行在纯 DOS 模式下工作。

功能:

+ 用“按钮(buttons)，输入栏(input fields)，菜单(menus)，检查框(checkboxes)，单选框(radio buttons)”来布局对话框－－所有的元件可能是自由地安排
+　“Quick Box”由于指令行的规格
+　“List box”用于选择在批处理中产生的选项
+　“Text”文本输出；“fill”填充屏幕区域,，清屏(clear)，颜色(color)
+ 　规定“字型(font)”和自定义颜色“调色板(palettes)”
+　“INI 文件(s)”用于默认值和偏爱设置
:

: 主菜单 " WBAT- Dialog Boxes for DOS " [x]

[WBAT & Tour ] 关于所有的 WBAT 功能的资讯
--------------------------------------------------------------
[Setup ] 为你自己的 WBAT 应用程序做好准备
--------------------------------------------------------------
[Layouts ] 布局设计对话框，菜单，本文
--------------------------------------------------------------
[Commands ] 指令明细对于你的整批文件
--------------------------------------------------------------
[C & ontrol ] 批处理控制: 出错码(errorlevel) 和变量(variables)
--------------------------------------------------------------
[处理 ] 使用者的鼠标和键盘
-------------------------------------------------[ 退出(exit) ]
:

:tour-menu " WBAT 浏览 "[x]

[ Quick box& ]
[ Box layout& ]
[ Buttons, Menu& ]
[ Input fields& ]
[ Checkboxes& ]
[ Radio buttons& ]
[ List box& ]
------------------
[ Text display& ]
[ Fill, CLS& ]
[ Cursor& ]
[ Screen save& ]
[ Font, &Palette& ]
[ ANSI?& ]
[ STDOUT& ]
------------------
[--- & END --- ]
::

:tour-info
“WBAT Tour”将告知你所有的 WBAT 功能而不是很详细的研究。

在你开始前请注意下面的问题:

* 按“ESC”键或单击右上角的“[x]”按钮(当可用时)将关闭当前对话框；

* 在当前对话框范围外单击鼠标右键也将关闭当前对话框(除非这一功能没有激活)；

* 要w移动一个对话框，可在对话框的上部按住鼠标键拖曳它。

:Quick-box
# Quick box ^

让我们从一个非常简单的命令开始学习:

wbat box OK

这是一个暂停的复位按钮, 提示用户继续。

在默认状况下，所有的对话框都放置在屏幕中央。
::

:Quick-pos
你也许希望可在屏幕的任何地方放置你的对话框。
对话框左上角的行、列坐标可以被定义:

wbat box 20,60 continue

如果对话框超出屏幕边缘，没关系，WBAT 会自动改正位置。

如果对话框碰巧遮住你要阅读的内容，你可用拖曳功能移开对话框。
::

:Quick-choice
# Quick choice ^

现在指定超过一个选项，而且有单一的选择:

wbat box 21,40 continue,back,tour menu

选项之间必须用“,”分开。在选项里容许用空格。

你可以使用热键进行选择 (默认是第一个字符，在这个DEMO里用红色标记). 关于热键的更多信息请参阅“Layouts”。

在批处理文件中，处理用户的输入的方式与用“CHOICE”的一样，通过出错码(errorlevel)(1 对应于第一个选项,2 对应于第二个选项经，等等)

例:
if errorlevel 3 goto TOUR-MENU
if errorlevel 2 goto T-quick
rem "continue" here

! 记住：在用 GOTO 测试出错码时必须降序排列errorlevels。
::

:Quick-prompt
# 提示文字和颜色 ^

一个可选的提示文字可以包含在双引号里，并放置于按钮选项的前面。

例子: wbat box 19,55 "Continue Tour?" ok,back

你甚至可以使用多行本文：只须在提示文本中插入一个脱字符号 (^) 作为分行标记。

提示框的颜色(box color) 可在圆刮号中被指定 (默认值颜色在 WBAT.INI 被定义)。
格式是：(提示文本颜色 on 提示框背景颜色)

例子: wbat box 19,55 (blue on light brown) "Continue Tour?" ok,back

关于彩色的语句和更多的对话框选项(选项的边框形式(item pre-set)及时间超出(time-out))，请参见“main menu”中的“Commands”。
::

:box-layout
# 对话框布局 ^

如果你需要更多的功能,你就需要布局(layout)以便你能自由地安排本文和控件的位置:

* 按钮(buttons)或菜单项目(menu items)
* 输入区域(input fields)
* 检查框(checkboxes)
* 单选按钮(radio buttons)

在布局中，所有的控件被[]括起来。
见下一页的例子。

一般的命令格式是: WBAT box @layout.txt:label

所有对话框的命令选项是:
方格位置(box position),颜色(color),初始化选择条位置(initial bar position),超时(time-out)。 见“Commands”(主菜单)。
::

:box-example
# 对话框布局例子 ^

这里举一个布局的例子。

注意:

对话框总是出现;
那意谓: 当对话框关闭时，背景已经被保存下来。

然而, 一个特别的 " fix " 选项可用于关闭对话框后返回屏幕。
::

:box-exm " 例子 "[x]

请输入你的名字和城市(Please enter your name and city ^

名字: [$名字,40 ]

城市: [$城市 ]

[.] 男 [.]女

[!] 超过 21

[ OK ] [ cancel ]
::

:box-lref
# 布局参考 ^

在一个文本文件(text file)里，你能有多个布局。每个布局单元都有标签(label)识别, 像在批处理文件中一样。

一个布局单元的结束是在一行的开始用冒号(:)，, 通常是下一个标签。

在你的 WBAT 命令中，你用文件名和标签来布局:

* 文件名前面用“@”标记 e.g. @dialog.txt
* 标签前用“:”标示 e.g. :START

例子: wbat BOX @dialog.txt:start

然而，在大多数情况下，你可以省略文件名，因为WBAT提供了一个简易的方法来使用默认的文件。
另一个方法是在批处理文件中有布局，并且简单地用 “@%%0:label”

详情请参阅“Commands/Layout Reference”
::

:box-other
# 对话框布局 ^

其他布局功能:

* “变量(Variables)”可用于布局, 像在批处理文件中

* 可以定义对话框的标题 (用不同的颜色显示)

* 右上角的 [x] 是可选的，用于取消或退出

* 不同颜色的“分割线”(Divider lines)

详见“Layouts”部分
控件在下面的章节中也有描述。
:

:bottons
# 对话框布局中的按钮(bottons) ^

[]号中带有选项文字的按钮可放置于对话框中的任何位置。

例子: [ ok ] [ cancel ]

用鼠标单击按钮或在高亮的按钮上按下“Enter”键，将关闭对话框，返回一个按钮的出错码。可选的，通过变量来命名。

选项文本不能以 “$”或“!”开始，
因为这些符号被保留用于识别其他的控件。

特别的：“?”用于标识“ESC”按钮,与键盘上的“ESC”键有一样的功能，而问号不会显示。

例子: [ ok ][? cancel ]

在这情况下，“cancel”按钮返回的出错码不是“2”，而是100，就和其他的ESCAPE动作一样。
errorlevel 2, 但是 100,关于任何其他的逃亡行动。
详情请参阅“Control / ESC Handling”。
::

:buttons - menu [x]
[menu ]
[ errorlevel]
[ variables ]
:

:buttons-menu
# Menu box ^

“菜单”只是垂直排列的按钮 ( 在一列或多列)。然而, 在一个对话框中按钮通常用不同的颜色显示，灰色的是这个演示的按钮.(按钮颜色在 WBAT.INI 被定义)

如果你需要一个没有可见按钮(意为没有按钮背景，移到该位置时才亮显)的一个菜单 ( 象下面的例子), 就要使用 “menu” 指令代替 “box”。 处理方法是相同的。

例: WBAT menu @layout.txt:label

你可以用详细的菜单选项来作一个大的对话框，或者用简单的关键字来做一个简单的对话框。

例子:(对于在这页上的画面)
~
:button-menu [x]
[ menu ]
[ errorlevel]
[ variables ]
:~
你可以插入空行，或添加文字。
另外，象标题、[x] 框, 分割线
请参见主菜单中的“Layouts” 。
:

:buttons-errorlevel
# 根据 errorlevel 选择 按钮/项目 ^

在你的批处理文件中，你能通过返回的 errorlevel 来处理用户的选择，就如使用“Choice” 命令一样(记住用降序排列检查 errorlevels!)

例子:
wbat menu :button-menu
if errorlevel 100 goto Main (捕捉 ESC/[x])
if errorlevel 3 goto B-variables
if errorlevel 2 goto B-errorlevel
rem here is errorlevel 1
:B-menu

注意：每个 errorlevel 值都有唯一的按钮对应，以防在你的布局里有
其他的控件。

关于详细的信息，包括 ESC 处理，请参见“Control”部分。
::

:buttons-variables
# 处理用户输入 ^

被选的按钮也能被以“名字”的方式返回值, 并分配给变量“WBAT”，默认值被赋给在菜单选项中选的(第一个)字。

简单的 “GOTO%%WBAT%%” 可以跳转到用选项命名的标签行。

注意: WBAT 只产生环境变量...

这时用命令 call W.bat ......
来替代 WBAT......

这种特殊的结构在Windows NT/2000下运行的很好，在Windows版本下运行很安全(只要DOS模式支持)

关于变量的更详细的信息请参见“Control”部分。
::

:input
# 对话框的输入栏 ^

输入栏用 “$”标记，并在$后面跟一个变量名，并将返回输入字串的字符串。

例子: [$ city ]

输入字符串的长度由[]括号所包含的的空间决定。
不同的长度 (更长或更短) 可以被指定，也可定义附加的选择项:

U 强迫大写
P 密码输入模式
! 必须输入 (除非方格被 ESC 关闭)

例子: [$ name,40,U! ] 

如果输入长度超过可见栏位大小，如果有需要的话字符串将会被替换。

注意：只做一个(没有按钮的)输入栏也是可以的。在这种情况下，按回车键将关闭对话框。
::

:input-var
# 输入变量 ^

为了处理输入，你必须告诉 WBAT 返回的变量, 使用下面的语句:
CALL W.BAT box ....

详情请见 Control 部分。

在对话框被显示之前，你可分配一个词首字母/默认值字符串给变量。如果你想要一个空的
输入栏，请确认清除变量 。

注意: WBAT 将会移除输入字符串后面冗余的空间。
::

:checkbox
# 布局里的检查框 ^

检查框用于触发选项的 ON/OFF 。要在对话框里创建一个检查框，在方括号里放置一个感叹号。

例子: ~[!] include subdirectories~

在这个例子里，只有检查框本身能被触发。要包括触发选项的关联文本，请将它包括进[]号里面。

例子: ~[! include subdirectories]~

注意：在键盘上用空格键触发检查框。

检查框被触发为“ON”的标记可在WBAT.INI定义(默认符号：“x”)。
:

:checkbox-example "Checkbox" [x]

[!] include subdirectories
[!] all uper case

[ ok ][ cancel ]
:

:checkbox-var
# 检查框变量 ^

在一个对话框里可以有 9 个检查框。 每个检查框的返回值均为 0 (off) 或 1 (on) , 并将第一个分配给变量 WCB1，第二个分配个 WCB2，如此类推。

这是一个处理返回值变量的例子:

set option=
if %%WCB1%%==1 set option=/S

注意：在对话框被显示之前，初始/默认状态被指定给变量。一个空的变量或任何无效的变量都将赋于 0 (OFF)
::

:radio
# 对话框布局中的单选框 ^

在提供的几个选择框中，但只有一个可以被选择，其他的自动关闭。

单选框用[]括号里加一个句点“[.]”表示。

例子: [.]LFN [.]short DOS name

对于单选框的提示文本，也可以包括到[]括号里去。
例子: [. left aligned ]
[. right aligned]
[. centred ]

注意: 在键盘上用空格键可将高亮的选项激活为“ON”。

“ON”的符号可在 WBAT.INI 中定义。(默认值: "*").
:

:radio-example "Radio Buttons" [x]

[. left aligned ]
[. right aligned]
[. centred ]

[ ok ]
::

:radio-var
# 单选框变量 ^

你可以定义一套多达 9 个单选按钮 (最小量是 2) 的单选框。当一个单选按钮被选择时，将返回单选按钮的号码 (1...),并赋于变量“WRB” 。

这是处理单选框返回变量的例子:

set align=left
if %%WRB%%==2 set align=right
if %%WRB%%==3 set align=center

注意：在对话框被显示之前，初始/默认值能被指定给变量。一个空的或任何无效的变量都将被赋于 1 (first)

::

:listbox
# 从列表中选择 ^

一个列表看起来像一个菜单, 但他们有一些重要的不同:

* 在布局中不须方括号[]。 (整行被使用)

* 用“卷动”功能可“达到 32Kb”被显示。

这意味着你可以很容易的在批处理过程中提出一个源文件，举例来说：

WBAT list @file.ext[:label]

你可以象任何对话框命令一样指定标签，但是如果你省略那标签，整个文件将被提出。

符号“@” (表示文件名字) 在LIST命令中并不是强制的。。
::

:list-example
# 列表例子 ^

这一个例子列出当前目录的文件。拾取一个文件......

卷动: 使用光标键(上/下)或将鼠标指针移到顶端或底端的滚动钮上并单击[或按住]鼠标左键。
单击箭头用翻页。

下面是查看列表的命令：

DIR *.* /b/a-d/one > %temp%\temp.txt
call W.BAT list 3,60 %temp%\temp.txt

wbat box 8,53 "Your selection was:^** %%wbat%% **" again,continue
del %%temp%%\temp.txt

::

:list-keys
# 用键盘选择行 ^