Host Access Class Library C++

此 C++ 类库提供主机连接的完全面向对象的抽象，其中包括：读取和写入主机表示空间（屏幕），枚举屏幕上的字段，读取操作员指示符区 (OIA) 以获取状态信息，访问和更新有关可视仿真器窗口的信息，传输文件，以及执行重要事件的异步通知。类库支持 Microsoft® Visual C++® 编译器。

主机访问类库 C++ 层由按类层次结构排列的许多 C++ 类组成。 主机访问类对象 说明了主机访问类库 C++ 层的 C++ 继承层次结构。在图中，每个对象都从其正上方的类继承。

图 1. 主机访问类对象

显示主机访问类库类库对象结构。

主机访问类对象 还显示每个类的所有成员函数。请注意，除了为每个类显示的函数之外，类还继承父类的所有函数。例如，函数 IsReady() 可用于 ECLSession, ECLPS、ECLOIA、ECLWinMetrics 和 ECLXfer 类。

以下各节简要介绍了每个类。有关更多详细信息，请参阅本章中的各个类描述。

ECLSAMPS.CPP 文件中提供了本章中显示的所有示例。此文件可用于使用任何支持的编译器编译和执行任何示例。

以下是主机访问类库 C++ 类的简要概述。每个类名都以 ECL 开头，ECL 是主机访问类库的通用前缀。

  • 第 ECLBase 类 页上的 ECLBase 是所有 ECL 对象的基类。它提供一些基本的实用程序方法，如连接名称和句柄的转换。由于所有 ECL 对象都继承自此类，因此这些方法可用于任何 ECL 对象。
  • 第 ECLConnection 类 页上的 ECLConnection 表示单个 Z and I Emulator for Windows 连接，并包含连接状态、连接类型（例如 3270 或 5250）以及连接的名称和句柄等连接信息。此类也是所有特定于连接的 ECL 对象（如 ECLPS 和 ECLOIA）的基类。
  • 第 ECLConnList 类 页上的 ECLConnList 包含创建对象或上次调用 Refresh 方法时存在的所有 Z and I Emulator for Windows 连接的列表。每个连接均由一个 ECLConnection 对象表示。
  • 第 ECLConnMgr 类 页上的 ECLConnMgr 使用 ECLConnList 对象枚举所有当前正在运行的 Z and I Emulator for Windows 连接（窗口）。还提供启动新连接和停止连接的方法。
  • 第 ECLCommNotify 类 页上的 ECLCommNotify 是一个通知类，应用程序可以使用该类在断开与主机的连接或连接到主机时收到通知。它可用于监控连接状态，并在连接意外断开时采取措施。
  • 第 ECLErr 类 页上的 ECLErr 提供从主机访问类库类返回运行时错误信息的方法。
  • 第 ECLField 类 页上的 ECLField 包含有关屏幕上单个字段的信息，例如字段属性、字段颜色、屏幕上的位置或长度。还提供了更新输入字段的方法。
  • 第 ECLFieldList 类 页上的 ECLFieldList 包含 ECLField 对象的集合。调用 Refresh 方法时，将检查当前主机屏幕，抽取字段列表，并用于构建 ECLField 对象列表。应用程序可以使用此集合来管理字段，而无需构建列表本身。
  • 第 ECLKeyNotify 类 页上的 ECLKeyNotify 是一个通知类，应用程序可以使用该类来获得击键事件的通知。应用程序可以过滤（删除）击键，将其替换为其他击键，或丢弃击键。
  • 第 ECLListener 类 页上的 ECLListener 是所有新 HACL 事件侦听器对象的基类。它为所有侦听器对象提供通用功能。
  • 第 ECLOIA 类 页上的 ECLOIA 提供对操作员状态信息的访问权，例如切换指示符、禁止输入的条件和通信错误。
  • 第 ECLOIANotify 类 页上的 ECLOIANotify 是抽象基类。应用程序创建从该类派生的对象以接收 OIA 更改通知。
  • 第 ECLPS 类 页上的 ECLPS 表示单个连接的表示空间（屏幕）。它包含以数据平面的形式获取屏幕内容副本的方法。每个平面均表示相关表示空间的特定方面，例如文本、字段属性和颜色属性。还提供用于搜索表示空间中的字符串、向主机发送键、获取和设置主机光标位置以及许多其他功能的方法。还提供 ECLFieldList 对象，可用于枚举屏幕上的字段列表。
  • 第 ECLPSEvent 类 页上的 ECLPSEvent 是一个事件对象，在更新表示空间时传递给 PS 事件侦听器。它包含有关事件的信息，包括导致更新的原因和屏幕已更新的部分。
  • 第 ECLPSListener 类 页上的 ECLPSListener 是抽象基类。应用程序创建从此类派生的对象，以接收表示空间更新事件，以及由 ECLPSEvent 对象提供的所有信息。
  • 第 ECLPSNotify 类 页上的 ECLPSNotify 是抽象基类。应用程序创建派生自此类的对象，以接收信息最少的表示空间更新通知。
  • 第 ECLRecoNotify 类 页上的 ECLRecoNotify 是抽象基类。应用程序创建从此类派生的对象，以接收屏幕识别通知。
  • 第 ECLScreenDesc 类 页上的 ECLScreenDesc 是用于描述单个主机屏幕的类。然后，屏幕描述类对象用于在所描述的主机屏幕出现时触发事件，或同步等待特定的主机屏幕。
  • 第 ECLScreenReco 类 页上的 ECLScreenReco 是一个类，用于收集一组屏幕描述对象，并在集合中的任何屏幕出现在表示空间中时生成异步事件。
  • 第 ECLSession 类 页上的 ECLSession 包含所有连接特定对象的集合。ECLSession 可用于为特定连接轻松创建一组完整的对象。
  • 第 ECLStartNotify 类 页上的 ECLStartNotify 是一个通知类，应用程序可以使用该类在启动或停止连接时收到通知。它可用于监控系统状态，并在连接意外关闭时采取措施。
  • 第 ECLUpdateNotify 类 页上的ECLUpdateNotify 是一个通知类，应用程序可以使用该类在更新主机屏幕或 OIA 时收到通知。
  • 第 ECLWinMetrics 类 页上的 ECLWinMetrics 表示正在运行仿真的物理窗口。提供了获取和设置窗口状态（最小值、最大值、已恢复）、窗口大小和可见性的方法。
  • 第 ECLXfer 类 页上的 ECLXfer 通过连接启动与主机之间的文件传输。
  • 第 ECLPageSettings 类 页上的 ECLPageSettings 会控制和检索仿真器会话文件 > 页面设置对话框的设置。
  • 第 ECLPrinterSettings 类 页上的 ECLPrinterSettings 会控制并检索仿真器会话文件 > 打印机设置对话框的设置。