下列各节描述 EGL set 语句的作用:
下表描述影响整个记录或固定记录或者记录或固定记录数组的 set 语句。
set 语句的格式 | 作用 |
---|---|
set record empty | 清空每个基本字段。对于记录,将清空每个下级记录,清空这些下级记录的每个下级记录,以此类推。对于固定记录(它本身可能在记录中),基本字段位于固定结构的最低级别。 每个基本字段的影响取决于该字段的基本类型:
|
set record initial | 将字段值复位为由 value
属性在开发时指定的值,这对于在 pageHandler 或表单中声明的记录或固定记录是可行的。由赋值设置的值永远不会复位。 如果 value 属性没有值或者如果记录不在 pageHandler 或表单中,set record initial 的效果与 set record empty 的效果相同,但以下情况例外:对于类型为 ANY 的字段,set 语句将除去 ANY 之外的所有类型说明。 |
set record position | 确定与类型为 indexedRecord 的固定记录相关联的 VSAM 文件中的位置,如稍后所述。 此 set 语句格式对数组不可用。 |
可将各种语句格式组合使用,选项间用逗号隔开。对于给定记录,选项按它们在 set 语句中的出现顺序起作用。您还可以指定多个记录,记录间用逗号隔开。
语法图如下所示:
下表描述影响整个表单的 set 语句。
set 语句的格式 | 作用 |
---|---|
set form alarm | 仅限于文本表单;当下一次 converse 语句显示表单时发出警报声。 |
set form empty | 清空表单中的每个字段的值,清除任何内容。对给定字段的影响取决于基本类型:
|
set form initial | 将每个表单字段重置为其最初定义的状态,该状态是在表单声明中指定的。程序所作的更改都将被取消。对于类型为 ANY 的字段,set 语句会除去 ANY 之外的所有类型说明。 |
set form initialAttributes | 将每个表单字段重置为其最初定义的状态,该状态是在表单声明中指定的。字段的内容不受影响,类型也不受影响(如果字段类型为 ANY 的话)。 |
可以将各种语句格式组合使用,选项(如 empty 和 alarm)间用逗号隔开。您还可以指定多个表单,表单间用逗号隔开。
语法图如下所示:
上表对这些选项作了描述。
下表描述影响任何上下文中的字段的 set 语句的格式。
set 语句的格式 | 作用 |
---|---|
set field empty | 清空字段或(对于具有子结构的固定字段)清空每个下级基本字段。 它的影响取决于字段的基本类型:
|
set field null | 使字段为 NULL(如果这样做有效的话)。有关此操作何时有效的详细信息,请参阅 itemsNullable。有关 SQL 记录中的 NULL 处理的详细信息,请参阅 SQL 项属性。 |
语法图如下所示:
您可以选择一个或另一个选项,每个选项在上表中作了描述。
下表描述影响文本表单中的字段或字段数组的 set 语句。给定的 set 语句只能按一组特定的方式来组合选项,如稍后所述。
set 语句的格式 | 作用 |
---|---|
set field blink | 导致文本重复地闪烁。此选项仅在 COBOL 程序中可用。 |
set field bold | 使文本以粗体字显示。 |
set field cursor | 将游标定位在指定的字段中。 如果字段标识了数组,并且没有 occurs 值,则缺省情况下游标定位在第一个数组元素上。 如果程序运行多个具有 set field cursor 格式的语句,则最后一个语句在 converse 语句运行时起作用。 |
set field defaultColor | 将特定于字段的 color 属性设置为 defaultColor,这表示显示的颜色由其它条件确定。有关详细信息,请参阅字段显示属性。 |
set field dim | 导致字段以低于正常的密度显示。使用此效果来淡化字段内容。 |
set field empty | 初始化字段的值,并清除任何内容。对给定字段的作用取决于基本类型,如数据初始化中所述。 |
set field full | 在显示表单之前,将空的、空白的或 NULL 字段设置为一系列完全相同的字符:
仅当针对该字段的已修正数据标记被设置好时,才将表单上的字符返回给程序,如已修正数据标记和 modified 属性中所述。更改字段的用户必须除去字段中的所有字符才能避免将它们返回给程序。 仅当表单组是使用构建描述符选项 setFormItemFull 生成时,set field full 的使用才起作用。 如果 MBCHAR 类型的字段只包含单字节空格,则认为它是空的。对于这样的字段,set field full 指定一系列单字节字符。 |
set field initial | 将字段重置为其最初定义的状态,和程序所作的任何更改无关 |
set field initialAttributes | 将字段重置为其最初定义的状态,而不使用 value 属性(该属性指定字段的当前内容) |
set field invisible | 使字段文本不可见 |
set field masked | 适用于密码字段。如果文本表单是由 Java™ 程序提供的,将显示星号而不是用户在输入字段中输入的任何非空白字符。 |
set field modified | 设置已修正数据标记,如已修正数据标记和 modified 属性中所述。 |
set field noHighlight | 消除闪烁、反转和下划线等特殊效果。 |
set field normal | 重置字段,如下列格式所述:
有关详细信息,请参阅下表。 |
set field normalIntensity | 将字段设置为可视,并且没有粗体字效果。 |
set field protect | 设置字段,使用户不能覆盖其中的值。另请参阅 set field skip。 |
set field reverse | 反转文本和背景色,举例来说,如果显示器是黑底白字的,则背景变为白色的,而文本变为黑色的。 |
set field selectedColor | 将特定于字段的 color 属性设置为指定的值。selectedColor 的有效值如下所示:
|
set field skip | 设置字段,使用户不能覆盖其中的值。另外,在下列任何一种情况下,光标将跳过该字段:
|
set field underline | 在字段底部放置一条下划线。 |
set field unprotect | 设置字段,使用户可以覆盖其中的值。 |
语法图如下所示:
上表对这些选项作了描述。
相关概念
表单部件
已修正数据标记和 modified 属性
语法图