TPDFlibPrinter
Udskrivning, VCL, dokumentoprettelse
Beskrivelse
Leverer en komponentfacade med den velkendte livscyklus BeginDoc, Canvas, NewPage, EndDoc og Abort, mens der oprettes et PDF-dokument i stedet for at sende et fysisk udskriftsjob
Deklaration
Uses PDFlibPDFPrinter;
TPDFlibPrinter = Class(TComponent)Parametre
BeginDoc | Starter et nyt PDF-dokument og eksponerer den første side gennem Canvas |
|---|---|
NewPage | Gennemfører det aktuelle canvas som en PDF-side og åbner canvaset til den næste side |
EndDoc | Bekræfter den sidste side og skriver FileName, når der er tildelt en destination |
Abort | Kasserer det aktive job uden at skrive destinationsfilen og nulstiller komponenten til et tomt dokument |
SetPageSize | Indstiller stående papirdimensioner i PDF-punkter før BeginDoc |
Properties
Canvas | Det aktive VCL-lærred mellem BeginDoc og EndDoc eller Abort |
|---|---|
FileName | Valgfri PDF-outputsti; en tom værdi bevarer kun resultatet i LibraryInstance |
Title | Dokumenttitel, der anvendes, når jobbet begynder |
DPI | Canvas-koordinatopløsning fra 24 til 2400, standard 96 |
CanvasOptions | Canvas-importtilstand fra -1 til 4 med vektortilstand 2 som standard |
Orientation | poPortrait eller poLandscape; liggende retning ombytter de konfigurerede papirdimensioner |
PaperWidth, PaperHeight | Stående papirdimensioner fra 1 til 14400 PDF-punkter |
PageWidth, PageHeight | Skrivebeskyttede aktive dimensioner i canvaspixels efter konvertering af DPI og retning |
PageWidthPoints, PageHeightPoints | Skrivebeskyttede aktive dimensioner i PDF-punkter |
PageNumber | Enbaseret aktuel side under et job og nul i inaktiv tilstand |
Printing, Aborted | Skrivebeskyttet livscyklustilstand |
LibraryInstance | Den ejede TPDFlib-instans til inspektion eller videre behandling af den færdige PDF |
LastErrorCode | Den underliggende biblioteksfejlkode fra den seneste PDF-handling |
Eksempel
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;Bemærkninger
Konfigurationsegenskaber kan ikke ændres under et aktivt dokument, og forkert brug af livscyklussen udløser EPDFlibPrinter
Komponenten ejer sit bibliotek og lærred, opretter et uafhængigt dokument for hvert job, bevarer et fuldført dokument til yderligere API-handlinger og åbner aldrig en udskriftsdialog eller tilgår operativsystemets spooler
Brug try/except omkring et job, og kald kun Abort, mens jobbet stadig er aktivt; mislykkede interne konverteringshandlinger afslutter jobbet og indstiller Aborted