バージョン: 20 R7 BETA

GET PICTURE RESOURCE

GET PICTURE RESOURCE ( resID ; resData {; resFile} )

引数	型		説明
resID	Integer	→	リソースID番号
resData	Field, Variable	→	ピクチャを受け取る、ピクチャフィールドまたは変数
←	PICTリソースの内容
resFile	Time	→	リソースファイル参照番号、または省略時、開かれている全てのリソースファイル

GET PICTURE RESOURCE コマンドは、resIDのIDを持つピクチャ ("PICT") リソースに格納されているピクチャをresDataのピクチャフィールドまたは変数に返します。

リソースが見つからなかった場合、resDataは変わらず、システム変数OKに0が設定されます。

resFileに有効なリソースファイル参照番号を渡すと、リソースはそのリソースファイル内でのみ検索されます。resFileを省略した場合は、リソースチェーン内で最初に見つかったリソースのオカレンスが返されます。

Note: ピクチャリソースは、少なくとも数メガバイトのサイズになる可能性があります。

RESOURCE LISTコマンドの例題参照

リソースが見つかるとOKは1に、そうでなければ0に設定されます。

ピクチャをロードするための十分なメモリがない場合、エラーが生成されます。ON ERR CALLを使ってインストールされたエラー処理メソッドでこのエラーを受け取ることができます。