READ PICTURE FILE
READ PICTURE FILE ( fileName ; picture {; *} )
引数 | 型 | 説明 | |
---|---|---|---|
fileName | Text | → | 読み込むファイルのフルパス名, または空の文字列 |
picture | Picture | ← | ピクチャを受け取るフィールドまたは変数 |
* | 演算子 | → | 指定時 = すべてのファイルタイプを受け入れる |
説明
READ PICTURE FILE コマンドを使用してディスクファイルfileName に保存されたピクチャを開き、これをpicture 引数に指定した4Dフィールドまたは変数へロードすることができます。
fileName には読み込むファイルのフルパス名またはファイル名のみを渡すことができます。ファイル名のみを渡した場合、そのファイルはデータベースストラクチャと同階層になければなりません。Windowsではファイル拡張子が必要です。
空の文字列 ("") がfileName に渡されると、標準のファイルを開くダイアログボックスが表示され、ユーザは読み込むファイルやフォーマットを指定できます。
PICTURE CODEC LIST コマンドを使用して、利用可能なフォーマットを取得できます。
pictureには、読み込んだピクチャを受け取るピクチャ変数またはフィールドを渡します。
Note: 内部的なピクチャフォーマットは4D変数やフィールドに格納されます。
オプションの * 引数を渡すと、コマンドはすべてのタイプのファイルを受け入れます。この方法では、適切なcodecなしでもピクチャを扱うことができます (BLOB TO PICTURE コマンドの説明を参照してください)。
システム変数およびセット
コマンドが正しく実行されると、システム変数Documentには開かれたファイルのフルパスが格納され、システム変数OKは1に設定されます。そうでなければOKに0が設定されます。