TPDFlibPrinter

Stampa, VCL, creazione dei documenti

Descrizione

Fornisce una facciata componente con ciclo BeginDoc, Canvas, NewPage, EndDoc, Abort, creando PDF anziché processi di stampa

Dichiarazione

Uses PDFlibPDFPrinter;

TPDFlibPrinter = Class(TComponent)

Parametri

BeginDocAvvia un nuovo documento PDF ed espone la prima pagina tramite Canvas
NewPageConferma il canvas corrente come pagina PDF e apre il canvas della pagina successiva
EndDocEsegue il commit della pagina finale e scrive FileName quando è stata assegnata una destinazione
AbortElimina il processo attivo senza scrivere il file di destinazione e reimposta il componente su un documento vuoto
SetPageSizeImposta le dimensioni verticali della carta in punti PDF prima di BeginDoc

Properties

CanvasIl canvas VCL attivo tra BeginDoc e EndDoc o Abort
FileNamePercorso di output PDF facoltativo; un valore vuoto conserva il risultato solo in LibraryInstance
TitleTitolo del documento applicato all'avvio del processo
DPIRisoluzione delle coordinate del canvas da 24 a 2400, con valore predefinito 96
CanvasOptionsModalità di importazione del canvas da -1 a 4, con modalità vettoriale 2 predefinita
OrientationpoPortrait o poLandscape; landscape scambia le dimensioni carta configurate
PaperWidth, PaperHeightDimensioni verticali della carta da 1 a 14400 punti PDF
PageWidth, PageHeightDimensioni attive di sola lettura in pixel del canvas dopo la conversione di DPI e orientamento
PageWidthPoints, PageHeightPointsDimensioni attive di sola lettura in punti PDF
PageNumberPagina corrente in base uno durante un processo e zero quando inattivo
Printing, AbortedStato del ciclo di vita in sola lettura
LibraryInstanceIstanza TPDFlib posseduta per esaminare o elaborare ulteriormente il PDF completato
LastErrorCodeIl codice di errore della libreria sottostante dell'operazione PDF più recente

Esempio

Printer := TPDFlibPrinter.Create(nil);
try
  Printer.FileName := 'report.pdf';
  Printer.BeginDoc;
  Printer.Canvas.TextOut(72, 72, 'First page');
  Printer.NewPage;
  Printer.Canvas.TextOut(72, 72, 'Second page');
  Printer.EndDoc;
finally
  Printer.Free;
end;

Note

Le proprietà di configurazione non possono cambiare durante un documento attivo e un uso scorretto del ciclo di vita genera EPDFlibPrinter

Il componente possiede libreria e canvas, crea un documento indipendente per ogni processo, conserva il documento completato per ulteriori operazioni API e non apre mai finestre di stampa né accede allo spooler del sistema operativo

Usare try/except attorno a un processo e chiamare Abort solo mentre il processo è ancora attivo; le operazioni di conversione interne non riuscite terminano il processo e impostano Aborted

Vedere anche

GetCanvasDC, NewPageFromCanvasDC, RenderPagesToPrintStream