Vcl.Printers.SetPrinter
Delphi
function SetPrinter(NewPrinter: TPrinter): TPrinter;
C++
extern DELPHI_PACKAGE TPrinter* __fastcall SetPrinter(TPrinter* NewPrinter);
Eigenschaften
Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
---|---|---|---|---|
function | public | Vcl.Printers.pas Vcl.Printers.hpp |
Vcl.Printers | Vcl.Printers |
Beschreibung
Ersetzt die globale TPrinter-Instanz.
SetPrinter ersetzt das globale TPrinter-Objekt durch ein anderes TPrinter-Objekt. Dadurch können Anwendungen die Druckausgabe an spezielle Erfordernisse anpassen. Sie brauchen nur für das TPrinter-Standardobjekt einen anderen TPrinter-Nachkommen einzusetzen.
Das TPrinter-Objekt im Parameter NewPrinter ersetzt das aktuelle TPrinter-Objekt.
SetPrinter gibt das ursprüngliche, durch den Funktionsaufruf ersetzte TPrinter-Objekt zurück.
Anmerkung: Wenn die Anwendung beendet wird, gibt sie das globale TPrinter-Objekt automatisch frei. Nach einem Aufruf von SetPrinter wird der zurückgegebene Drucker jedoch nicht mehr automatisch freigegeben. Es liegt in der Verantwortung des Aufrufers, den Rückgabewert von SetPrinter freizugeben.
SetPrinter ist in der Unit Printers deklariert. Wenn Sie SetPrinter verwenden wollen, fügen Sie Printers zur uses-Klausel (Delphi) hinzu bzw. beziehen Sie Printers.hpp in das Quellmodul (C++) ein.