使用 .PANEL 动词定义实际 PANEL 布局

指示面板布局开始的 .PANEL 动词跟在 .DEFINE 动词之后。

此动词还必须从第 1 列开始并大写。 指定面板定义中要显示的相同位置中的行。 在面板动词之后输入的所有文本都对面板生成器有意义,包括空白行,因此不允许注释行。 第一个字符必须是保护,跳过或取消保护控制字符。 面板定义以文件结尾或以第 1 列开始的下一个 .PANEL 动词结尾。 每个文件仅支持一个面板定义。

面板布局接近您看到的内容,但显示面板时未显示的控制字符和嵌入变量除外。 .PANEL 从第 10 列开始后的第三行上输入的字段位于终端屏幕第三行第 10 列上。

.PANEL 动词具有以下特征:
  • 它必须从第一列开始,后跟一个空格,并大写。
  • 除非它是面板指示符的结尾,否则它必须在与 .PANEL 相同的行上具有面板名称。
  • 它必须至少有一个字段,并且 .PANEL 行后的第一个字符必须是保护,跳过或取消保护控制字符。
  • 除非正在使用显式输入字段长度,否则该字段将在下一个字段开始时结束。 可以使用空字段来终止字段。
  • 要使用控制字符作为常规可显示字符,请输入两个连续的控制字符。 要显示两个连续的控制字符,请输入四个连续的控制字符。 对于显示为一个字符的每对控制字符,字段中的后续文本将显示在左侧的一个位置,除非该对控制字符后面有 7 个或更多个连续空格。
  • "保护" 或 "跳过" 字段可以具有任意数量的变量或文本,这些变量或文本将适合该字段。 受保护字段中的变量具有可供替换的区域,从变量标识控制字符开始,并在下一个控制字符或文本之前结束。
  • 变量标识控制字符与变量名之间不允许有空格。 空格会导致将变量名称解释为纯文本。
  • 取消保护字段只能有一个关联变量。
  • 不受保护的字段可以有一个明确说明字段长度的数字。 该数字必须介于 unprotect 和 variable 控制字符之间。 使用显式字段长度时,字段不需要终止。 如果显式长度字段是行的最后一个字段,那么将使用 skip 属性创建终止字段以强制字段结束。
  • 当使用显式输入字段长度时,将向左或向右调整以下字段的所有列位置以强制正确对齐,因此显式长度字段和字段紧跟在彼此之间。 该行上的其他字段保持其间距不变。 此对齐仅影响该一行; 下一行上的字段不受影响。 例如,某行具有 5 个字段,其中 1st 和 4th 字段具有显式长度和间距。 字段 1 与 2 之间为 4 , 2 与 3 之间为 5 , 3 与 4 之间为 6 , 4 与 5 之间为 7。 显示此行时,字段 2 紧跟在字段 1 之后 (无空格) ,字段 2 与 3 之间的分隔仍为 5 ,字段 3 与 4 之间的分隔仍为 6 ,字段 5 紧跟在字段 4 之后 (无空格)。 如果显式长度导致当前字段或后续字段溢出到下一个字段中,那么显示面板时会返回错误。
  • 当字段未在同一行 (例如,字段跨行) 上终止时,字段长度会随显示面板的屏幕的宽度而变化。 此外,如果最后一个字段没有终止符,那么该字段将合并屏幕,直到迂到第一个字段开始。
  • 只有包含变量的字段才能在面板输出期间动态更改其属性。
  • 如果将保护或跳过字段动态更改为不受保护的字段,那么只有该字段中的第一个变量指定了运算符输入。 分配输入字段的所有内容。
  • 面板源文件必须位于 REXX 文件系统中,然后才能将其处理到运行时面板设施所使用的中间文件 (面板对象) 中。