Vcl.Printers.SetPrinter

提供: RAD Studio API Documentation
移動先: 案内検索

Delphi

function SetPrinter(NewPrinter: TPrinter): TPrinter;

C++

extern DELPHI_PACKAGE TPrinter* __fastcall SetPrinter(TPrinter* NewPrinter);

プロパティ

種類 可視性 ソース ユニット
function public
Vcl.Printers.pas
Vcl.Printers.hpp
Vcl.Printers Vcl.Printers

説明

プリンタとの相互作用を管理する TPrinter のグローバルインスタンスを置換します。

SetPrinter 関数は,グローバルな TPrinter オブジェクトを別の TPrinter オブジェクトで置き換えます。これにより,アプリケーションでデフォルトの TPrinter オブジェクトの TPrinter の下位オブジェクトを置き換えて,印刷を処理する方法を変更することが可能になります。

NewPrinter は,現在のグローバル TPrinter オブジェクトと置換する新しい TPrinter オブジェクトです。

SetPrinter は,前のグローバル TPrinter オブジェクトを返します。

メモ:  グローバル TPrinter オブジェクトは,アプリケーションが終了すると自動的に解放されます。SetPrinter の呼び出し以後は,返されるプリンタは自動的には解放されません。呼び出し側が戻り値を解放するか,SetPrinter をもうち一度呼び出して置換し,2 回めの SetPrinter 呼び出しによって返されたかわりのプリンタを解放する必要があります。

SetPrinter は Printers ユニットで宣言されています。SetPrinter 関数を使用するには,ユニットの uses 節に Printers を追加(Delphi)するか,ソースファイルに Printers.hpp をインクルード(C++)します。

関連項目