Vcl.Printers.SetPrinter
Delphi
function SetPrinter(NewPrinter: TPrinter): TPrinter;
C++
extern DELPHI_PACKAGE TPrinter* __fastcall SetPrinter(TPrinter* NewPrinter);
Propriétés
Type | Visibilité | Source | Unité | Parent |
---|---|---|---|---|
function | public | Vcl.Printers.pas Vcl.Printers.hpp |
Vcl.Printers | Vcl.Printers |
Description
Remplace l'instance globale d'un TPrinter qui gère l'interaction avec l'imprimante.
SetPrinter remplace l'objet TPrinter global par un autre objet TPrinter. Cela permet aux applications de modifier leur gestion de l'impression en substituant un descendant TPrinter à l'objet TPrinter par défaut.
NewPrinter représente le nouvel objet TPrinter qui remplace l'objet TPrinter global en cours.
SetPrinter renvoie l'objet TPrinter global antérieur.
Remarque : L'objet TPrinter global est automatiquement libéré quand l'application se termine. Une fois SetPrinter appelée, l'imprimante renvoyée n'est pas automatiquement libérée. Il appartient à l'appelant de libérer la valeur renvoyée ou de la remplacer à l'aide d'un nouvel appel de SetPrinter puis de libérer l'imprimante de substitution renvoyée par le second appel de SetPrinter.
SetPrinter est déclarée dans l'unité Printers. Pour utiliser la fonction SetPrinter, ajoutez Printers dans la clause uses de votre unité (Delphi) ou incluez Printers.hpp dans le fichier source (C++).