Vcl.Printers.SetPrinter

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

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.

Siehe auch