GetScreen

此方法会从与 ECLPS 对象关联的连接的表示空间中检索数据。数据以字节值的线性数组的形式返回，每个表示空间字符位置一个字节。除非从 TextPlane 检索数据，否则数组不以 null 结束，在这种情况下，将追加一个 null 终止字节。

应用程序必须为返回的数据提供缓冲区，并提供缓冲区的长度。如果请求的数据不适合缓冲区，则会被截断。对于 TextPlane 数据，缓冲区必须包含至少一个以 null 结束的额外字节。该方法会返回复制到应用程序缓冲区的字节数（不包括 TextPlane 副本的终止 null 值）。

应用程序必须指定要从表示空间检索的数据字节数。如果起始位置加上此长度超过表示空间的大小，则会抛出错误。如果未指定起始位置，则从给定起始位置或第 1 行、第 1 列开始返回数据。返回的数据以线性方式从表示空间从左到右、从上到下复制，横跨多行，直至指定的长度。如果应用程序要获取屏幕矩形区域的屏幕数据，则应使用 GetScreenRect 方法。

应用程序可以指定要检索数据的任何平面。如果未指定平面，将检索 TextPlane。有关不同 ECL 平面的详细信息，请参阅 ECL 平面 - 格式和内容。