TPDFlibPrinter

Utskrift, VCL, dokumentskapande

Beskrivning

Tillhandahåller en komponentfasad med den bekanta BeginDoc-, Canvas-, NewPage-, EndDoc- och Abort-livscykeln medan en PDF skapas i stället för att skicka ett fysiskt skrivarjobb

Deklaration

Uses PDFlibPDFPrinter;

TPDFlibPrinter = Class(TComponent)

Parametrar

`BeginDoc`	Startar ett nytt PDF-dokument och exponerar första sidan via `Canvas`
`NewPage`	Committar den aktuella canvasen som en PDF-sida och öppnar nästa sidcanvas
`EndDoc`	Committar den sista sidan och skriver `FileName` när en destination tilldelats
`Abort`	Kasserar det aktiva jobbet utan att skriva dess destinationsfil och återställer komponenten till ett tomt dokument
`SetPageSize`	Sätter stående pappersdimensioner i PDF-punkter före `BeginDoc`

Egenskaper

`Canvas`	Den aktiva VCL-canvasen mellan `BeginDoc` och `EndDoc` eller `Abort`
`FileName`	Valfri PDF-utdatasökväg; ett tomt värde behåller resultatet bara i `LibraryInstance`
`Title`	Dokumenttitel som tillämpas när jobbet börjar
`DPI`	Upplösning för canvas-koordinater från 24 till 2400, standard 96
`CanvasOptions`	Canvas-importläge från -1 till 4, standard vektorläge 2
`Orientation`	`poPortrait` eller `poLandscape`; liggande växlar de konfigurerade pappersdimensionerna
`PaperWidth`, `PaperHeight`	Stående pappersdimensioner från 1 till 14400 PDF-punkter
`PageWidth`, `PageHeight`	Skrivskyddade aktiva dimensioner i canvaspixlar efter DPI- och orienteringskonvertering
`PageWidthPoints`, `PageHeightPoints`	Read-only active dimensions in PDF points
`PageNumber`	1-baserad aktuell sida under ett jobb och noll när inaktiv
`Printing`, `Aborted`	Read-only lifecycle state
`LibraryInstance`	Den ägda `TPDFlib`-instansen för inspektion eller vidare bearbetning av den fullbordade PDF:en
`LastErrorCode`	Den underliggande biblioteksfelkoden från den senaste PDF-operationen

Exempel

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;

Anmärkningar

Konfigurationsegenskaper kan inte ändras under ett aktivt dokument och livscyelfelväxning höjer EPDFlibPrinter

Komponenten äger sitt bibliotek och sin canvas, skapar ett oberoende dokument per jobb, bevarar ett fullbordat dokument för vidare API-operationer, och öppnar aldrig en utskriftsdialogruta eller rör operativsystemets spooler

Använd try/except runt ett jobb och anropa Abort bara medan jobbet förblir aktivt; misslyckade interna konverteringsoperationer avslutar jobbet och sätter Aborted

Se även

GetCanvasDC, NewPageFromCanvasDC, RenderPagesToPrintStream