TPDFlib

Kernobject, aanmaken van documenten, documentbeheer

Beschrijving

TPDFlib (unit Lib\PDFlibrary.pas) is de centrale klasse van PDF Library for Delphi. Eén instantie herbergt tegelijk een of meer PDF-documenten: NewDocument start een leeg document, LoadFromFile laadt een bestaand, SelectDocument schakelt het actieve document om en DocumentCount rapporteert hoeveel er open staan. Alle teken-, tekst-, formulier-, annotatie-, beveiligings-, handtekenings-, extractie-, render-, afdruk- en validatieaanroepen werken op het momenteel geselecteerde document

De unit PDFlibrary is de paraplu-unit: hem aan je uses-clause toevoegen trekt het hele publieke oppervlak binnen, dus de meeste programma's hebben nooit meer nodig dan Uses PDFlibrary;

Syntaxis

Delphi

Uses PDFlibrary;

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

Parameters

`Create` / `Destroy`	De levenscyclus van de instantie; vrijgeven sluit elk geopend document
`NewDocument`	Start een nieuw, leeg PDF-document en selecteert het
`LoadFromFile`	Laadt een bestaande PDF van schijf (optioneel met een wachtwoord) en selecteert die
`SelectDocument`	Maakt een ander geopend document actief
`DocumentCount`	Aantal documenten dat momenteel in de instantie open staat
`SaveToFile`	Schrijft het actieve document naar schijf (incrementele updates houden eerdere handtekeningen intact)
`LastErrorCode`	Numerieke code van de meest recente fout; 0 als de laatste aanroep slaagde
`Abort` / `Aborted`	Breekt een langlopende bewerking coöperatief af en rapporteert de annuleringsstatus
`OnProgress` / `OnOperationProgress`	Grove en fijne progressie-callbacks voor lange operaties
`OnPassword`	Vraagt de host om een wachtwoord wanneer een versleuteld document er een nodig heeft
`Logger`	Optional `TPDFlibLogger` instance receiving structured log records
`MailProvider`	Optionele `IPDFlibMailProvider` die de mailfuncties gebruiken

Opmerkingen

De referentiepagina's in deze documentatie beschrijven de leden één voor één, gegroepeerd per taak: documentbeheer, paginalayout, vectorgraphics, fonts en tekst (inclusief HTML stories en tekstflow), afbeeldingen, formulieren en JavaScript, annotaties en links, outlines en bestemmingen, beveiliging en digitale handtekeningen, tagged PDF, PDF/A- en PDF/UA-conformiteit, inhoudextractie en direct access, rendering (SelectRenderer kiest GDI+, Cairo of PDFium), afdrukken, preflight-rapporten en viewerintegratie via TPDFlibViewer

De meeste leden bestaan in drie parallelle vormen: als TPDFlib-methoden met WideString, als DLL-entrypoints met DL-prefixen (plus met A achtervoegde ANSI-varianten voor narrow-string-aanroepers, zie SetAnsiMode) en als ActiveX/COM-methoden op het PDFlib library-automatiseringsobject. De per-lid-pagina's tonen de Delphi- en DLL-syntaxis naast elkaar

Voorbeeld

// 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;

Zie ook

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