TPDFlib

Kjerneobjekt, dokumentoppretting, dokumenthåndtering

Beskrivelse

TPDFlib (enhet Lib\PDFlibrary.pas) er hovedklassen i PDF Library for Delphi. En enkelt instans huser ett eller flere PDF-dokumenter samtidig: NewDocument starter et tomt dokument, LoadFromFile laster et eksisterende, SelectDocument veksler det aktive dokumentet, og DocumentCount rapporterer hvor mange som er åpne. Alle tegne-, tekst-, skjema-, annotasjons-, sikkerhets-, signatur-, uttrekks-, renderings-, utskrifts- og valideringskall opererer på det for tiden valgte dokumentet

Enheten PDFlibrary er paraplyenheten: legger du den i uses-klausulen, får du hele det offentlige grensesnittet inn, så de fleste programmer trenger bare Uses PDFlibrary;

Syntaks

Delphi

Uses PDFlibrary;

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

Parametere

Create / DestroyInstansens livssyklus; frigjøring lukker hvert åpne dokument
NewDocumentStarter et nytt, tomt PDF-dokument og velger det
LoadFromFileLaster en eksisterende PDF fra disk (eventuelt med et passord) og velger den
SelectDocumentGjør et annet åpent dokument til det aktive
DocumentCountAntall dokumenter for tiden åpne i instansen
SaveToFileSkriver det aktive dokumentet til disk (inkrementelle oppdateringer holder tidligere signaturer intakte)
LastErrorCodeNumerisk kode for den siste feilen; 0 når siste kall lyktes
Abort / AbortedAvbryter en langvarig operasjon kooperativt og rapporterer avbruddstilstanden
OnProgress / OnOperationProgressGrove og finkornede fremdrifts-callbacks for lange operasjoner
OnPasswordSpør verten om et passord når et kryptert dokument trenger et
LoggerOptional TPDFlibLogger instance receiving structured log records
MailProviderValgfri IPDFlibMailProvider brukt av postfunksjonene

Merknader

Referansesidene i denne dokumentasjonen beskriver medlemmene én etter én, gruppert etter oppgave: dokumenthåndtering, sidelayout, vektorgrafikk, skrifttyper og tekst (inkludert HTML-fortellinger og tekstflyt), bilder, skjema og JavaScript, annotasjoner og lenker, disposisjoner og destinasjoner, sikkerhet og digitale signaturer, tagget PDF, PDF/A- og PDF/UA-samsvar, innholdsuttrekk og direct access, rendering (SelectRenderer velger GDI+, Cairo eller PDFium), utskrift, preflight-rapporter og fremviserintegrasjon gjennom TPDFlibViewer

De fleste medlemmer finnes i tre parallelle varianter: som TPDFlib-metoder med WideString, som DLL-inngangspunkter med DL-prefikser (pluss A-suffiksede ANSI-varianter for smalstreng-kallere, se SetAnsiMode) og som ActiveX/COM-metoder på PDFlib library-automatiseringsobjektet. Per-medlem-sidene 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