CBL_SCR_RESTORE

CBL_SCR_SAVE call-by-nameルーチンへの呼び出しで保存されるcharacter-mode画面エリアの復旧を行う。

構文:

call NoReturnCode "CBL_SCR_RESTORE" using by value     flags
                                                       handle

パラメーター：

	呼び出しプロトタイプ使用時 ( 説明の読み方)	PIC (32 ビット システム)
flags	cblt-x4-comp5.	pic x(4) comp-5.
handle	cblt-pointer.	usage pointer.

入力パラメーター：

flags	現在の値。値は常時0。
handle	CBL_SCR_SAVE call-by-nameルーチンへの呼び出しで返された"save-handle"。handleは、呼び出しが行われない場合、ナル文字にすることができる。

出力パラメーター：

handle

未使用、無効。 CBL_SCR_SAVEルーチンをさらに呼び出して、結果として有効な"save-handle"を再配置しない場合は、CBL_SCR_RESTOREへ再度渡すことはできない。 CBL_SCR_RESTOREから返されると、直ちにポインターをナルに設定すること。返されたhandleがおこなうCBL_SCR_SAVEへの呼び出しが書き込まれたときに、画面エリアが同じ位置の画面へ保存される。

説明:

フラグのパラメーターはBY VALUEによって渡されるため、数値定数として指定される可能性がある。たとえば"BY VALUE 0 SIZE 4"。

本呼び出しは状態値を返さないため、special-namesセクションで定義された適正なcall-conversion（シンタックスの記述箇所で示したように）を使用して呼び出すこと。適正な仕様は4。

CBL_SCR_RESTOREは、直接画面エリアに書き込む方法よりも利点がある。

• プログラムの作業場所節内に割り当てられた無駄なバッファースペースは持つ必要がない。
• シングルバイト属性メソッドを使用して画面の書き込みを行う（CBL_READ_SCR_ATTRSなどのルーチン）には、一般属性システムを直接経由しない方法が求められる。これにより、現在のパレットにはないベストマッチと思われる属性が見つかる。システムの中には（UNIXなどのデフォルトのパレットがモノクロであるが、Adisの仕様によりカラー画面が可能となるシステム）、画面へ戻す属性の書き込みでは、正確な結果が出ない場合がある。この呼び出しは、実際に画面内容の内部表示を保存し、それにより情報ロスの可能性をなくすことにより、影響を最小化にとどめようとしている。
• 読み込みは非常に速度が速い。

画面のモード変更は、モードがCBL_SCR_RESTORを呼び出す前の設定へ復旧されるための CBL_SCR_SAVEによって画面エリアを保存した後には、有効である（たとえば、画面を132コラムモードに変更するなど）。これを行わないと、予測不能な結果になる。

　

　

他参照:

関連項目