GetScreen

GetScreen メソッドは、 アプリケーション提供のバッファーにフィールドからのデータを入れます。バッファーにコピーされるデータの型は、 オプションの Plane パラメーターを使用して選択します。デフォルトでは、テキスト・プレーン・データが戻されます。戻されるデータは、このフィールド・オブジェクトの作成時に存在していたままの フィールドです。これは、ECLFieldList::Refresh 関数の呼び出し以降に更新されている場合は 、フィールドの現在の内容を反映していません。

戻されたデータの長さが、フィールドの長さになります (GetLengthを参照してください)。TextPlane を コピーすると、最後のデータ型の後にヌル終了バイトが付加されます。したがって、アプリケーションは、テキスト・プレーンを取得するとき、 フィールド長より最低限 1 バイト大きいバッファーを用意しなければなりません。アプリケーション・バッファーが小さすぎると、戻されたデータは切り捨てられます。アプリケーション・バッファーにコピーされたバイト数が、関数の結果として 戻されます (テキスト・プレーンのヌル終了文字は含まれません)。

FieldPlane は、この関数で取得できません。ECLField::GetAttribute を使用して、 フィールド属性値を取得できます。