QR SET DESTINATION
QR SET DESTINATION ( area ; type {; specifics} )
| 引数 | 型 | 説明 | |
|---|---|---|---|
| area | Integer | → | エリア参照 |
| type | Integer | → | レポートの出力先 |
| specifics | Text, Variable | → | 出力先の詳細 |
このコマンドはスレッドセーフではないため、プリエンプティブなコードには使えません。
説明
QR SET DESTINATION コマンドは、area に渡された参照番号のエリア用のレポート出力タイプを設定します。
type 引数には、 QR Output Destination テーマの定数のいずれかを渡します。specifics 引数の内容はtype の値に基づきます。次の表はtype およびspecifics の両引数へ渡すことができる値を示しています:
| 定数 | 型 | 値 | コメント |
|---|---|---|---|
| qr HTML file | 倍長整数 | 5 | ファイルへのパス名 |
| qr printer | 倍長整数 | 1 | "*" を渡した場合、印刷ダイアログボックスを表示しない |
| qr text file | 倍長整数 | 2 | ファイルへのパス名 |
qr printer (1): specifics 引数にアスタリスク("*")を含む文字列を渡した場合、印刷の途中にダイアログボックスは表示されずカレントの印刷設定が自動的に使用されます。この設定は、サーバーでレポートを印刷する際に必要になります。
qr text file (2): specifics引数に空の文字列を渡した場合、ファイル保存ダイアログが表示されます。それ以外の場合、ファイルはパス名で指定された場所に保存されます。
デフォルトのフィールド区切りはタブ記号 (文字コード9) です。また、デフォルトのレコード区切りはキャリッジリターン (文字コード13) です。区切り文字用の2つのシステム変数 (FldDelimitとRecDelimit) に値を指定して、これらのデフォルト値を変更できます。Windowsにおいて、FldDelimitが13である場合、このキャリッジリターンの後にラインフィード (文字コード10) が付加されます。これらの変数は、 IMPORT TEXT などの他のコマンドでも使用される点に注意してください。クイックレポートエディタのためにこれらの変数の値を変更すると、その変更はアプリケーションのあらゆる箇所に反映されます。
qr HTML file (5): QR SET HTML TEMPLATE で設定されたテンプレートを使用して、HTMLファイルが作成されます。この変換の実行方法については、4D Design Referenceマニュアルを参照してください。
無効なarea番号を渡した場合、エラー番号-9850が生成されます。
無効な出力先typeを渡した場合、エラー番号-9852が生成されます。
例題
以下のコードは出力先をテキストファイルMydoc.txtに設定し、クイックレポートを実行します:
QR SET DESTINATION(MyArea;2;"MyDoc.txt")
QR RUN(MyArea)