GetScreenRect

此方法会从与 ECLPS 对象关联的连接的表示空间中检索数据。数据以字节值的线性数组的形式返回，每个表示空间字符位置一个字节。数组不是以 null 结束。

应用程序提供表示空间中的起始和结束坐标。这些坐标构成矩形区域的相对角点。矩形区域内的表示空间仅作为单个线性数组复制到应用程序缓冲区。起点和终点可以是彼此之间的任何空间关系。复制被定义为从包含最上点的行开始到包含最下点的行，以及从最左边的列开始到最右边的列。两个坐标都必须在表示空间大小的边界内，否则会抛出错误。可以根据线性位置或行号和列号来指定坐标。

提供的应用程序缓冲区必须至少大到足以包含矩形中的字节数。如果缓冲区太小，则不会复制任何数据，并返回零作为方法结果。否则，该方法将返回复制的字节数。

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