使用此功能的注意事项

可以使用“查找字段位置” (31) 和“查找字段长度”(32) 函数查找字段位置和长度信息。将字段复制到字符串函数可用于受保护或未受保护的字段，但仅限于字段格式的主机演示空间。
当遇到下列情况之一时，复制结束：
- 当到达字段末尾时
- 当超过目标字符串的长度时
当使用设置会话参数(9) 功能 EAB 选项时，可以返回 EAB。EAB 与表示空间中的每个字符相关，并在每个字符之前返回。

将字段复制到字符串函数受ATTRB / NOATTRB / NULLATTRB 、 EAB / NOEAB 、 XLATE / NOXLATE 、 DISPLAY / NODISPLAY 、 DISPLAY / NODISPLAY 会话选项。参考项目5;13和14;17 ;和sparopt.html#sparopt__opt18和sparopt.html#sparopt__opt19了解更多信息。

如前所述，各种Copy （5、8 和 34）函数返回的属性受到Set SessionParameters （9）函数的影响。所涉及的设置会话参数的作用如下：

设置会话参数: 对 COPY 功能的影响
NOEAB 和 NOEAD: 不返回属性。仅文本从表示空间复制到用户缓冲区。
EAB 和 NOXLATE: 属性按下表中的定义返回。
EAB 和 XLATE: 返回用于显示空间显示的颜色。颜色可以重新映射；因此，当 XLATE 和 EAB 同时打开时，属性颜色不是COPY函数返回的颜色。

返回的字符属性在下表中定义。属性位位置采用IBM®格式，其中位 0 是字节中最左边的位。

3270 个字符属性从主机返回到模拟器。下表适用于设置 EAB 和 NOXLATE 时。


位位置	含义
0–1	字符突出显示 00 = 正常 01 = 闪烁 10 = 反转视频 11 = 下划线
2–4	字符颜色（颜色重新映射可以覆盖此颜色定义。） 000 = 默认 001=蓝色 010=红色 011=粉色 100 = 绿色 101 = 绿松石 110 = 黄色 111 = 白色
5–6	字符属性 00 = 默认值
7	预订的

5250 个字符属性从主机返回到模拟器。下表适用于设置 EAB 和 NOXLATE 时。


位位置	含义
0	倒车影像 0 = 正常图像 1 = 反转图像
1	下划线 0 = 无下划线 1 = 下划线
2	眨 0 = 不闪烁 1 = 闪烁
3	列分隔符 0 = 无分隔符 1 = 分隔符
4–7	预订的

下表显示Z and I Emulator for Windows字符颜色属性。当设置 EAB 和 XLATE 时，下表适用。


位位置	含义
0–3	背景字符颜色 0000 = 黑色 0001 = 蓝色 0010=绿色 0011 = 青色 0100 = 红色 0101 = 洋红色 0110 = 棕色 (3270)、黄色 (5250) 0111=白色
4–7	前景字符颜色 0000 = 黑色 0001 = 蓝色 0010=绿色 0011 = 青色 0100 = 红色 0101 = 洋红色 0110 = 棕色 (3270)、黄色 (5250) 0111=白色 1000 = 灰色 1001 = 浅蓝色 1010=浅绿色 1011 = 浅青色 1100 = 浅红色 1101 = 浅洋红色 1110=黄色 1111 = 白色（高强度）

对于PS/2®单色显示器，应用程序（工作站）会话中的字符显示为各种灰色阴影。这是为用户提供重新映射的颜色所必需的EHLLAPI应用程序会话，以便他们可以获得在主机应用程序演示空间中看到的内容。

要使用此函数，请预先分配内存以接收返回的数据字符串参数。预分配此内存所需的语句根据编写应用程序所用的语言而有所不同。有关更多信息，请参阅内存分配。

Note： 5250 仿真支持 24 行 x 80 列的表示空间。在某些情况下，Communication Manager 5250 仿真显示第 25 行。当显示来自主机的错误消息或当操作员选择 SysReq 键时，会发生这种情况。Z and I Emulator for Windows状态栏显示第25行信息。通过EXTEND_PS选项，EHLLAPI应用程序可以使用相同的接口Communication ManagerEHLLAPI当这种情况发生时，有效的演示空间就会扩展。