CBL_SCR_SAVE 名前呼び出しルーチンの呼び出しで以前に保存された文字表示モード画面の領域を復元します。
注: このルーチンはネイティブ COBOL でのみサポートされます。
構文:
call NoReturnCode "CBL_SCR_RESTORE" using by value flags
handle
パラメーター:
|
呼び出しプロトタイプ使用時 (「説明の読み方」を参照) |
PIC |
flags |
cblt-x4-comp5 |
pic x(4) comp-5 |
handle |
cblt-pointer |
USAGE POINTER |
入力パラメーター:
flags |
現在は常にゼロにする必要があります。 |
handle |
CBL_SCR_SAVE 名前呼び出しルーチンの呼び出しで以前に返された「保存ハンドル」。このハンドルは NULL にすることができます。その場合、呼び出しても何も実行されません。 |
出力パラメーター:
handle |
変更されませんが、無効です。CBL_SCR_SAVE ルーチンをさらに呼び出して有効な「保存ハンドル」を後で再割り当てしていない限り、CBL_SCR_RESTORE に再度渡すことはできません。CBL_SCR_RESTORE から戻った時点で直ちにこのポインターを NULL に設定することをお勧めします。handle を返した CBL_SCR_SAVE の呼び出しが行われた際に保存された画面の領域が、同じ位置で画面に書き込まれます。 |
説明:
flags パラメーターは、BY VALUE、つまり値で渡されるため、数値リテラルとして指定することもできます(「BY VALUE 0 SIZE 4」など)。
この呼び出しでは、状態値は返されません。したがって、特殊名節で定義した適切な呼び出し規約 (構文の説明で提示) を使用して呼び出す必要があります。この目的に適した規約は 4 です。
CBL_SCR_RESTORE は、画面の領域を直接書き込むよりも次の点で優れています。
CBL_SCR_RESTORE を呼び出す前にモードが以前の設定に復元される場合は、CBL_SCR_SAVE によって画面の領域を保存した後、画面のモードを変更する (たとえば、画面を 132 列モードに切り替える) ことが可能です。それ以外の場合、結果は不定になります。