翻译.txt

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

你能使用键盘选择一个行就像在 Windows 浏览器中一样:

如果你键入一个或多个的字符，标记就会跳到下一个(你键入)的这些字符或字符串处开始。 如果在下面的列表中没有找到，将从顶端重新开始搜寻。

你不能在键击之间暂停超过一秒钟的时间(否则，搜索字符串会复位)。空字符键也会重新复位。

最大的暂停时间可以在 INI 文件中[general]部分的“ListHotTicks”字段中通过调整 ticks 的值来改变(18 ticks =1 秒)，举例来说:

ListHotTicks=36 ;2 秒
:

:list-browse
# 查看本文文件 ^

你也可以使用 WBAT LIST 来查看小的文本文档。

注意：最大的文件大小是 32 Kb ，而且行宽是 76bytes (超长的部分将被删除).

下面是显示 WBAT.INI 文档的例子。

命令: wbat list WBAT.INI
:

:本文
# 本文显示装置

在屏幕上显示文本你可以用“TYPE”或“ECHO”，但是“WBAT text”指令提供一些额外的功能：

* 可在屏幕上的任何位置输出
* 本文通过标签在布局文件中读出(就象对话框一样)
* 本文中的变量 %%...%%钭被填写
* 颜色，题头，属性

默认情况下，本文将以当前的颜色显示在屏幕上。这意味着在本文输出之前你将通常要用你想要的颜色清除屏幕。
(详见 WBAT CLS)。

WBAT 从给定的布局文件中通过标签来读出，如果文件中没有标签，将读出整篇文本文档。但是，只有一个屏幕的文本被显示，多余的将不能显示，没有卷动条。

例子: WBAT list 2,4 :info
WBAT text @ file.txt
::

:text-area
# 本文区域 ^

本文在一个矩形框中被显示，这个矩形框的大小由最长的行和行的数目决定。
当你用不同的背景色显示文本时，你只需注意这一点，象这个例子。

要调整矩形框的文本，可加入空行和左边/右边的空格。

跟通常一样，左上角的位置被定义为矩形框的位置。默认值是 1,1。如果本文框超过右下角的边缘，位置将会被调整以适合大小。超过屏幕大小的本文将不能显示。

刮弧里的可选的颜色
:

:text-example

要实现这样的一个本文显示，用如下的命令格式：

wbat text 8,16 (blue on light brown) @:text2example ^

::

:text-attrib
# 本文显示的属性 ^

你能在布局中使用两种特殊的颜色来标记行或段落。这些颜色在 WBAT.INI 中定义:

TextHi 屏幕本文高亮

要使文本或段落高亮，可在文本或段落的开始及结束处插入“~”符号。 (“~”可以在 INI 文件的[general]段定义HiSymbol来改变。)

# TextTitle 屏幕本文标题 ^

放在最左一列的“#”符号标记了标题行(任何地方,不只在页的顶端)。标题颜色的宽度是整个文本的宽度。 由最长的行决定。要强制一个更长的标题，可填入空格或在结束处用“^”标记。
::

:text-quick
# Quick text ^

关于对话框命令，有一种 "快的模式(Quick text)" 显示一个简短的信息，就象定义命令参数一样。

这就非常方便用指定的颜色来显示信息或标题，象下面的例子:

wbat text 11,30 (+white on red) " Pls. ignore this message! "
::

:fill
# 用图案，字符串，颜色，CLS填充一个区域 ^

你可以用任何字符或字符串填充一个矩形框，或者只是改变颜色。一个特殊的选项容许一行一行的交替给定字串。看下面的例子。

用“FILL”命令你也可以清除屏幕的指令:

wbat fill " "

CLS 指令起到一样效果:

wbat CLS

可选择的颜色 (默认由WBAT.INI定义):

wbat CLS (white on blue)
::

:fill-syntax
# 填充语法 ^

语法: wbat FILL position (dimensions) (colors) "string" +s

为所有参数的默认解释。

position：左上角的行坐标和列坐标，默认是 1,1

dimensions：填充区域的宽和高(总是在刮弧中)。默认值: 屏幕边缘。

colors：颜色，默认值：屏幕颜色 (WBAT.INI)

string：将会在每行中被重复； " " 清除；
字串省略: 只有颜色被改变(文本保留)

+s：替换每一个随后的行

若填充区域超过屏幕边缘,将会被剪切。

例(演示版的蓝色区域)

wbat fill 13,32 (9,28) (+magenta on blue) "揽谫" +2
::

:cursor
# 光标与卷动栏

如果你想准备让你的屏幕输出其他程序，你需要光标指令。
对于其他程序的输出。WBAT 不使用 DOS 光标(只有 CLS 指令使光标复位到初始位置)。

举例来说，如果你文本输出到屏幕上半部分，而后续的程序和DOS命令输出到屏幕的中部，你可以将光标设置到第13行：

wbat cursor 13

你也可以从当前行或任何指定的行开始发送移行命令给屏幕，当光标到达底部时，屏幕将会卷动。

例子: wbat cursor 25+5

这将移动光标到底行, 并卷动 5个行。
:

:screen
# 屏幕保存/恢复 ^

WBAT boxes (box/menu/list) 总是出现, 意味着当对话框被关闭后背景将得以恢复。
对于嵌套菜单和对话框的特殊影响，WBAT提供了一些额外的功能。

* “FIX”前缀可使对话框固定, 也就是被关闭后仍保留在屏幕上。这样你可以打开另一个对话框，而第一个对话框保持可见。注意：固定的对话框不能在屏幕上拖动。

例子: call w.bat FIX menu :start

* WBAT save/restore 当它用于其他输出(如更多的对话框，查看文档等)时，将保存屏幕。

WBAT SAVE 拷贝屏幕映像到文件，并存放于%%TEMP%%目录里。
WBAT RESTORE 恢复屏幕，并且删除临时文件。
为了使用超过一个文件，需要指定ID号。

例子: wbat save 2
:

:palfont
# 字型和调色板,Windows 字型 ^

注意这个演示不使用由BIOS或者Windows提供的默认颜色。

WBAT 提供指令为全屏模式载入用户调色板和字体字形。

颜色也可在 Win95/98 窗口中工作，不能在Windows NT 或 2000下工作，但这些系统支持为DOS对话框设计的用户颜色。(详见NTcolors.bat调整)

对于GUI窗口，提供两种“new bitmap fonts”:

SANS16.FON 9*16 象素字型 (窗囗宽度: 720个图素)
SANS19.FON 10*19 象素字型 (窗囗宽度: 800个图素)

在GUI窗口中能被选择之前，这些字型可通过 Windows 控制板被安装。
::

:palette
# 用户定制的颜色色调色板 ^

WBAT PAL 装载由WBAT.INI指定的颜色设色板文件。

这个演示文档的调色板在文件 PAL.INI 中定义, 设计为亮的背景和暗的字符。修改颜色值请参照PAL.INI的注解。

如果没有找到调色板文件 (在 WBAT PAL 之上)，WBAT 将使用一内建的默认调色板，是相同于原始的 PAL.INI。

注意：

在一个GUI窗口中颜色不会立即改变, 而是提供给后续的输出。 因此，要在PAL命令后清除屏幕。

调色板将保留直到程序恢复到video模式。

要移除订制的调色板，运行 DOS 指令: MODE CO80
::

:font
# 完整的屏幕字型 ^

wbat FONT 载入由WBAT.INI指定的字型文件。SANSERIF.FNT被提供。

注意，字型只在全屏模式中显示, 但在GUI窗口中激活也不会有害。

可选择地，你能将屏幕设定为 33行:

wbat font 33 (重新设定: wbat font 25)

这个指令也会将GUI窗口换成 33个行,扩大窗口.(虽然字型本身被忽略)。请在 DOS 提示符下测试。

字形将保留直到程序恢复到video模式。

要移除订制的字型，请运行 DOS 指令: MODE CO80
::

:No_ansi
# ANSI控制台驱动器 ^

你当前不在运行ANSI标准驱动器。

如果你不知道ANSI驱动器是什么,只须跳过下面部分。 WBAT 不需要ANSI驱动器。

信息:

ANSI CODES用于颜色和光标，控制屏幕输出。程序通常仍然使用与它一起提供的这些编码进行ANSI仿真。

标准的 Windows 配置不载入ANSI驱动器。
:

:ansi
# ANSI控制台驱动器 ^

首先，所有的 WBAT 输出不受ANSI的影响。

然而，来自其他的程序 ( 透过标准输出) 的输出不将会在目前的屏幕上彩色显示，而是以先前已经由ANSI CODE程序通过的颜色显示。(初始：白色(前景)、黑色(背景))。

这意味着如果你想按指定的颜色输出其他的程序，你必须使用 ANSI CODES 额外的为 WBAT 提供颜色输出。

WBAT 提供了一个指令帮助你以防万一当前有一个未知的ANSI驱动器：

wbat ANSI? 如果没有ANSI驱动器发现， 返回 errorlevel 1

可选择地，你可以加入一个ANSI CODE程序，将会只被送出, 如果存在一个激活的ANSI驱动器 (因此你不会在屏幕上产生任何乱码。
:

:stdout
# Wbat STDOUT ^

既然有 Wbat TEXT 指令, 我们需要 STDOUT 做什么?
答案是：输出到 STDOUT 可重定向到一个文件。

AND 为什么不用TYPE?
有两件事TYPE不能实现：

* 读来自一个文件里的有标签的小片断
* 代替环境变量

指令: wbat STDOUT @file.txt[:label]

Wbat STDOUT 只产生一个场景用于例如重定向到一个文件、一个集合、一个从文本片断或模板来的文件。

你必须找出你自己需要的功能来使用。
:

:setup-title
谀哪柯哪目谀履口柯哪目^
滥哪棵? ?? ? 趁哪馁
滥哪倭哪馁 ? 滥哪倭
:

:setup-menu " WBAT 应用程序的安装 "[x]

[ Installation ] 储存 WBAT 运行时的文件、路径
--------------------------------------------------------------
[ INI file ] WBAT.INI，override、文件/颜色明细
--------------------------------------------------------------
[Environment ] 提供环境变量空间
--------------------------------------------------------------
[ Project editing ] 编辑器, 多重 DOS 对话框
----------------------------------------------------- [ 结束 ]
:

:install1
# WBAT 安装 ^

为了运行这个演示文档，你或许已经将 WBAT 文件解压到一个初定的文件夹。

当你要使用 WBAT 来制作你自己的批处理时， DOS 必须能从你的目录结构定位程序文件。

这通过设定路径来实现(详见autoexec.bat),就象下面的语句：
PATH C:\ WINDOWS;C:\ Windows\command;C:\ DOS\UTIL

当一个文件不在当前的目录中时，COMMAND.COM 试着定位指定文件夹的程序文件。

因为只有几个 WBAT 文件被共用，因此最好将这些文件拷贝到一个已经存在的公用文件夹里，这个文件夹是你包含在你已经指定的路径中的。当然你也可以创建新的文件夹，然后将其加入到你的PATH中。
:

:install2
# 安装 WBAT 文件 ^

注意: 最初的 WBAT 文件应该存放在一个分开的文件夹中，这样你才能在任何时候以最初的设定运行DEMO。

拷贝这些文件到“public”文件夹，并将这个路径设定到PATH中：

WBAT.COM
W.BAT
WBAT.INI

第一、二是可执行文件。 INI 文件放在与 WBAT 要运行的程序文件相同的文件夹中。

默认情况下，文件 PAL.INI 和 SANSERIF.FNT 也被放置在这个文件夹。然而，如果你不喜欢在那里有太多文件，可以放在子文件夹或磁盘上的任何其他的地方。 在这种情况下，你必须修改你的 WBAT.INI 。 详情见下面一章。

要在GUI 窗口中使用“bitmap fonts” SANS16.FON 和 SANS19.FON，必须在 Windows 控制面板中安装它们。
:

:inifile
# INI 文件 WBAT.INI ^

全局的 WBAT 设定从放在与WBAT.COM文件同一个文件夹的 WBAT.INI 中提取。

你也可以在其它目录里创建为指定项目而修改的 WBAT.INI。 WBAT 在检查它自己所在目录之前，总是在当前目录中寻找 WBAT.INI。

这个演示的配置项目在各自的章节有解释，也可参见WBAT.INI 的注解。

注意: 如果没有找到 INI 文件，WBAT 将使用内建的与初始的INI文件相同的默认值。
:

:ini- menu [x]
[ WBAT.INI ]
[ override ]
[ files ]
[ colors ]
:

:ini-override
# Override INI 文件设定 ^

所有的INI文件里的设定都可通过变量临时改变。
变量名就是INI文件里的项目名，用“W”作为前缀。

例子: SET W button=black on +cyan
SET W rightESC=0
SET W radiosymbol=254

要返回到 INI 文件设定，清除变量。

例子: set W button=

:ini-files
# WBAT.ini 的文件规格 ^

通常，你能按照DOS规范(8.3命名)在你的 WBAT.INI里指定一个文件。作为一个例外，“+”可作为一个前缀用于指向 WBAT 的目录 ( 也就是程序文件 WBAT. COM 所在目录)。

* 对于默认的源文件(布局) 文件名必须被指定，没有路径。 这样你能使用名字作为局部的默认文件，也用于WBAT目录里的全局的默认文件(只需要“+”指向).

例子: SourceFile= WBAT.TXT

* PAL.INI 和 SANSERIF.FNT必须用全路径指定，或者用“+”前缀。例：

PalFile=C:\some\where\Pal.INI
PalFile=+pal.INI (在 WBAT 的目录中)
PalFile=+data\Pal.INI (在子目录中)
:

:ini-colors
# INI 文件里的颜色设定 ^

参见 INI 文件的注解, 详细的描述请参见“layout”部分。
关于颜色解释，请参见 Commands/Colors.

一些特别的功能:

* 对于分割线和阴影的颜色被忽略。分割线的背景总是从激的对话框的颜色中提取。

* 对话框阴影可以通过设定“NONE”来关闭。

* 对于热键颜色 (在按钮中) 的背景是可选的。“NONE”将完全关闭热键功能。
:

:Environment
# 环境空间 ^

WBAT 使用环境变量报告输入的是字符串或有名字的按钮, 举例来说。

变量被储存在 COMMAND 环境空间中，要列出当前储存的所有变量，使用 DOS 命令 SET(不带参数)

既然环境空间被限制，你应该小心的处理以便有足够的空间运行你的 WBAT 批处理。 Windows 的DOS对话杠默认是384bytes。要改变其大小，请打开DOS对话框/内存的属性。

Win98 好像自动将环境空间增加到 400，这对于从一开始就提供足够的空间是一个好主意。

对于 DOS 版本为 6.x 以上的，详见文件 ESPACE.TXT 里的注释。

工具 ECHECK.bat 提供了一个是否达到最小可用空间的测试。参数可参见到这个文件里的描述。

记住清除那些不会再用于你的批处理的所有变量。
::

:project-editing
# 项目编辑 ^

如果你使用一个 Windows 编辑器，扩展的 ASCII 字符( 图形符号
或特别的欧洲字符)只有在当你选择了终端字体时才会在DOX对话框中恰当的显示。你的编辑器也可提供“bitmap fonts”给WBAT(与终端字体一样，大小 12/14)

你能开启几个 DOS 对话框测试你的批处理文件，编辑布局文件，并且运行 WBAT 演示来获得信息，所有都在同一时间进行。

当一个批处理在另一个DOS窗口运行时，不要编辑这个批处理文件。
COMMAND.COM 保留了行的物理位置以便继续，当你编辑这个文件时，这些位置可能会改变。
:

:command-menu " Command in Batch Files " [x]

[ Command & Summary ] 所有WBAT命令的列表
-------------------------------------------------------------?
[ W.BAT construct ] 生产变量，alt: STDOUT
-------------------------------------------------------------?
[ Multiple command ] 一行同时几个 WBAT 命令
-------------------------------------------------------------?
[ Position ] 输出位置，尺寸
-------------------------------------------------------------?
[Color ] 在命令，INI 文件，表达式中
-------------------------------------------------------------?
[ Layout reference ] @FILE:label, 局部的/全局的参考
-------------------------------------------------------------?
[Bar options ] 预选择，超时
-----------------------------------------------------?[ END ]
:

:command-title
谀哪口哪目谀履口穆目谀哪口目柯哪目谀哪縙
? ? 吵 ?吵 ?趁哪拇??吵忱哪目
滥哪倮哪馁? 亮亮亮滥倭哪馁滥哪?
:

:commands
# WBAT 指令,语法 ^

WBAT command [参数] (普通语法)
call W.bat command [参数] (当有变量时)

命令:
box |menu| list [position] [colors] [@file][:label] [#bar[,time-out]]
text [position] [colors] [@file][:label]

box [position] [colors] ["text"] buttons [#bar[,time-out]]
text [position] [colors] "text"
fill [position] [dimensions] [colors] ["string"] [+shift]