SET CURRENT PRINTER

SET CURRENT PRINTER ( printerName )

引数	型		説明
printerName	Text	→	使用されるプリンター名

説明

SET CURRENT PRINTER コマンドは現行の4Dアプリケーションでの印刷に使用するプリンターを指定するために使用します。

printerName に選択するプリンター名を渡します。使用できるプリンターの一覧を取得するには、このコマンドの前に PRINTERS LIST コマンドを使用します。
printerName に空の文字列を渡すと、システムに定義されたカレントプリンターが使用されます。

またPrint Options テーマ内の以下の定数を渡すことで、プラットフォームに関係なく汎用的なPDF プリンターを自動的に指定することができます:

定数	値	コメント
Generic PDF driver	_4d_pdf_printer	OS X上では、デフォルトドライバーをカレントプリンターに設定します。このドライバーは表示されず、PRINTERS LISTによって返される一覧にも含まれていません。PDF文書のパスはSET PRINT OPTIONを使って設定しなければならず、そうでない場合はエラー3107が返されます。 Windows上では、Windows PDFドライバー("Microsoft Print to PDF"という名前)をカレントプリンターに設定します。この定数はPDFオプションが有効化されているWindows 10でのみ有効です。他のバージョンのWindowsやPDFドライバーが使用できないWindowsでは、このコマンドは何もせず、OK変素は0に設定されます。

SET CURRENT PRINTER コマンドは、利用可能なオプションが選択したプリンタに対応するように、必ず SET PRINT OPTION コマンドよりも前に呼び出してください。それに対し、SET CURRENT PRINTER コマンドは、_o_PAGE SETUP コマンドの後で呼び出さなければなりません。これを行わないと、印刷設定が失われます。

このコマンドは PRINT SELECTION、PRINT RECORD、Print form、および QR REPORT コマンドと一緒に使用することができ、デザインモードを含め、4Dにおけるすべての印刷に対して適用されます。
指定した設定が失われないようにするには、必要に応じて印刷コマンドは必ず引数 > を用いて呼び出さなければなりません。

システム変数およびセット

プリンターの選択が正しく実行されると、システム変数OKに1が設定されます。そうでない場合 (例えば指定したプリンターが見つからない場合など) は、システム変数OKは0に設定され、カレントプリンターは変更されません。

例題

Windows 環境下でのPDF ドキュメントの作成は、以下のようにします:

 var $pdfpath : Text
 $pdfpath:=System folder(Desktop)+"test.pdf"
 SET CURRENT PRINTER(Generic PDF driver)
 SET PRINT OPTION(Destination option;3;$pdfpath)
 ALL RECORDS([Table_1])
 PRINT SELECTION([Table_1];*)
 SET CURRENT PRINTER("")

参照

Get current printer
PRINTERS LIST

プロパティ

コマンド番号	787
スレッドセーフである	✗
システム変数を更新する	OK