FMX.Printer.SetPrinter

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function SetPrinter(const NewPrinter: TPrinter): TPrinter;

C++

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

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
FMX.Printer.pas
FMX.Printer.hpp
FMX.Printer FMX.Printer

Beschreibung

Ersetzt die globale Instanz von TPrinter, die Interaktionen mit dem Drucker verwaltet.

SetPrinter ersetzt das globale TPrinter-Objekt durch ein anderes TPrinter-Objekt. Dadurch können Anwendungen die Druckausgabe an spezielle Erfordernisse anpassen. Dazu muss nur für das TPrinter-Standardobjekt ein anderer TPrinter-Nachkomme angegeben werden.

NewPrinter ist das neue TPrinter-Objekt, das das aktuelle globale TPrinter-Objekt ersetzt.

SetPrinter gibt das vorherige globale TPrinter-Objekt zurück.

Hinweis: Das globale TPrinter-Objekt wird automatisch beim Beenden der Anwendung freigegeben. Nach einem Aufruf von SetPrinter wird der zurückgegebene Drucker nicht mehr automatisch freigegeben. Es liegt in der Zuständigkeit des Aufrufers, den Rückgabewert freizugeben oder ihn durch einen Aufruf von SetPrinter zu ersetzen und den Ersatzdrucker, den der zweite SetPrinter-Aufruf zurückgibt, freizugeben.

Siehe auch