TPDFlib

Kärnobjekt, dokumentskapande, dokumenthantering

Beskrivning

TPDFlib (unit Lib\PDFlibrary.pas) är den centrala klassen i PDF Library for Delphi. En enda instans rymmer ett eller flera PDF-dokument samtidigt: NewDocument startar ett tomt dokument, LoadFromFile läser in ett befintligt, SelectDocument byter aktivt dokument och DocumentCount rapporterar hur många som är öppna. Alla rit-, text-, formulär-, annoterings-, säkerhets-, signatur-, extraktions-, renderings-, utskrifts- och valideringsanrop arbetar på det för tillfället valda dokumentet

Uniten PDFlibrary är paraply-uniten: att lägga den i din uses-sats drar in hela den publika ytan, så de flesta program behöver bara Uses PDFlibrary;

Syntax

Delphi

Uses PDFlibrary;

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

Parametrar

`Create` / `Destroy`	Instansens livscykel; frigörs den stängs varje öppet dokument
`NewDocument`	Startar ett nytt, tomt PDF-dokument och väljer det
`LoadFromFile`	Läser in en befintlig PDF från disk (valfritt med lösenord) och väljer den
`SelectDocument`	Gör ett annat öppet dokument till det aktiva
`DocumentCount`	Antal dokument som för tillfället är öppna i instansen
`SaveToFile`	Skriver det aktiva dokumentet till disk (inkrementella uppdateringar behåller tidigare signaturer intakta)
`LastErrorCode`	Numerisk kod för det senaste felet; 0 när senaste anropet lyckades
`Abort` / `Aborted`	Avbryter en långvarig operation kooperativt och rapporterar avbrottsstatusen
`OnProgress` / `OnOperationProgress`	Grova och finkorniga förloppscallbacks för långa operationer
`OnPassword`	Ber värden om ett lösenord när ett krypterat dokument behöver ett
`Logger`	Optional `TPDFlibLogger` instance receiving structured log records
`MailProvider`	Valfri `IPDFlibMailProvider` som postfunktionerna använder

Anmärkningar

Referenssidorna i denna dokumentation beskriver medlemmarna en och en, grupperade per uppgift: dokumenthantering, sidlayout, vektorgrafik, typsnitt och text (inklusive HTML-stories och textflöde), bilder, formulär och JavaScript, annoteringar och länkar, outlines och destinationer, säkerhet och digitala signaturer, taggad PDF, PDF/A- och PDF/UA-conformance, innehållsextraktion och direktåtkomst, rendering (SelectRenderer väljer GDI+, Cairo eller PDFium), utskrift, preflight-rapporter och viewer-integration via TPDFlibViewer

De flesta medlemmar finns i tre parallella varianter: som TPDFlib-metoder som tar WideString, som DLL-ingångspunkter med DL-prefix (plus A-suffixerade ANSI-varianter för narrow string-anropare, se SetAnsiMode) och som ActiveX/COM-metoder på automationobjektet PDFlib library. Medlemssidorna visar Delphi- och DLL-syntax sida vid sida

Exempel

// 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 även

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