TPDFlib

Kerneobjekt, dokumentoprettelse, dokumenthåndtering

Beskrivelse

TPDFlib (unit Lib\PDFlibrary.pas) er den centrale klasse i PDF Library for Delphi. En enkelt instans er vært for ét eller flere PDF-dokumenter samtidigt: NewDocument starter et tomt dokument, LoadFromFile indlæser et eksisterende, SelectDocument skifter det aktive dokument, og DocumentCount rapporterer, hvor mange der er åbne. Alle kald til tegning, tekst, formularer, anmærkninger, sikkerhed, signaturer, udtrækning, gengivelse, udskrivning og validering arbejder på det aktuelt valgte dokument

Unitten PDFlibrary er paraplyunitten: Når den føjes til din uses-sætning, medtages hele den offentlige overflade, så de fleste programmer kun behøver Uses PDFlibrary;

Syntaks

Delphi

Uses PDFlibrary;

Var
  PDF: TPDFlib;
Begin
  PDF:= TPDFlib.Create;
  Try
    ...
  Finally
    PDF.Free;
  End;
End;

Parametre

`Create` / `Destroy`	Instansens livscyklus; frigivelse af den lukker alle åbne dokumenter
`NewDocument`	Starter et nyt, tomt PDF-dokument og vælger det
`LoadFromFile`	Indlæser en eksisterende PDF fra disken (valgfrit med en adgangskode) og vælger den
`SelectDocument`	Gør et andet åbent dokument til det aktive dokument
`DocumentCount`	Antal dokumenter, der aktuelt er åbne i instansen
`SaveToFile`	Skriver det aktive dokument til disken (trinvise opdateringer bevarer tidligere signaturer)
`LastErrorCode`	Numerisk kode for den seneste fejl; 0, når det seneste kald lykkedes
`Abort` / `Aborted`	Annullerer en langvarig handling kooperativt og rapporterer annulleringstilstanden
`OnProgress` / `OnOperationProgress`	Grove og detaljerede fremdriftscallbacks til langvarige handlinger
`OnPassword`	Beder værten om en adgangskode, når et krypteret dokument kræver en
`Logger`	Valgfri `TPDFlibLogger`-instans, der modtager strukturerede logposter
`MailProvider`	Valgfri `IPDFlibMailProvider`, som mailfunktionerne bruger

Bemærkninger

Referencesiderne i denne dokumentation beskriver medlemmerne ét ad gangen, grupperet efter opgave: dokumenthåndtering, sidelayout, vektorgrafik, skrifttyper og tekst (herunder HTML-historier og tekstflow), billeder, formularer og JavaScript, annotationer og links, dispositioner og destinationer, sikkerhed og digitale signaturer, tagget PDF, PDF/A- og PDF/UA-overensstemmelse, indholdsudtræk og direkte adgang, rendering (SelectRenderer vælger GDI+, Cairo eller PDFium), udskrivning, preflight-rapporter og viewerintegration via TPDFlibViewer

De fleste medlemmer findes i tre parallelle varianter: som TPDFlib-metoder, der tager WideString, som DLL-indgangspunkter med DL-præfikser (plus ANSI-varianter med A-suffiks til kaldere med smalle strenge; se SetAnsiMode) og som ActiveX/COM-metoder på automatiseringsobjektet PDFlib library. Siderne for de enkelte medlemmer viser Delphi- og DLL-syntaks side om side

Eksempel

// Create a document, draw one line of text and save it
Uses PDFlibrary;

Procedure Demo;
Var
  PDF: TPDFlib;
Begin
  PDF:= TPDFlib.Create;
  Try
    PDF.NewDocument;
    PDF.AddStandardFont('Helvetica');
    PDF.PrintText(50, 750, 'Hello from PDF Library for Delphi');
    PDF.SaveToFile('hello.pdf');
  Finally
    PDF.Free;
  End;
End;

Se også

DocumentationHome, GettingStarted, NewDocument, LoadFromFile, SelectDocument, DocumentCount, LastErrorCode, SelectRenderer, TPDFlibViewer, TPDFlibLogger