GetScreen

GetScreen 方法使用字段中的数据填充应用程序提供的缓冲区。复制到缓冲区的数据类型可通过可选的 Plane 参数进行选择。缺省情况下返回文本平面数据。返回的数据是创建此字段对象时就存在的字段；如果自调用 ECLFieldList::Refresh 函数以来该字段已更新，则不会反映该字段的当前内容。

所返回数据的长度是字段的长度（请参阅 GetLength）。复制 TextPlane 时，将在最后一个数据字节之后添加一个附加的以 null 结束的字节。因此，在获取文本平面时，应用程序应提供至少比字段长度多 1 个字节的缓冲区。如果应用程序缓冲区太小，返回的数据将被截断。复制到应用程序缓冲区的字节数作为函数结果返回（不包括文本平面副本的 null 终止符）。

无法使用此函数获取 FieldPlane。ECLField::GetAttribute 可用于获取字段属性值。