TPDFlib

Alapobjektum, dokumentumlétrehozás, dokumentumkezelés

Leírás

A TPDFlib (Lib\PDFlibrary.pas egység) a PDF Library for Delphi központi osztálya. Egyetlen példány egyszerre egy vagy több PDF-dokumentumot kezel: az NewDocument üres dokumentumot indít, az LoadFromFile meglévőt tölt be, az SelectDocument aktív dokumentumot vált, a DocumentCount pedig jelenti, hány dokumentum van megnyitva. Minden rajzolási, szöveg-, űrlap-, annotációs, biztonsági, aláírási, kibontási, megjelenítési, nyomtatási és ellenőrzési hívás a jelenleg kiválasztott dokumentumon működik

A PDFlibrary egység gyűjtőegység: ha hozzáadja a uses záradékhoz, a teljes nyilvános felületet behúzza, így a legtöbb programnak csak Uses PDFlibrary; szükséges

Szintaxis

Delphi

Uses PDFlibrary;

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

Paraméterek

`Create` / `Destroy`	A példány életciklusa; felszabadítása minden megnyitott dokumentumot bezár
`NewDocument`	Új, üres PDF-dokumentumot indít és kiválasztja azt
`LoadFromFile`	Meglévő PDF-et tölt be lemezről (opcionálisan jelszóval), és kijelöli azt
`SelectDocument`	Egy másik megnyitott dokumentumot tesz aktívvá
`DocumentCount`	A példányban jelenleg megnyitott dokumentumok száma
`SaveToFile`	Az aktív dokumentumot lemezre írja (a növekményes frissítések érintetlenül hagyják a korábbi aláírásokat)
`LastErrorCode`	A legutóbbi hiba numerikus kódja; 0, ha az utolsó hívás sikeres volt
`Abort` / `Aborted`	Egy hosszú ideig futó műveletet együttműködően megszakít, és jelenti a megszakítás állapotát
`OnProgress` / `OnOperationProgress`	Hosszú műveletek durva és finom szemcsézettségű előrehaladási callbackjei
`OnPassword`	Jelszót kér a gazdagéptől, ha egy titkosított dokumentumhoz szükséges
`Logger`	Strukturált naplórekordokat fogadó opcionális `TPDFlibLogger` példány
`MailProvider`	A levélküldési függvények által használt opcionális `IPDFlibMailProvider`

Megjegyzések

A jelen dokumentáció hivatkozási oldalai feladatonként csoportosítva, egyenként ismertetik a tagokat: dokumentumkezelés, oldalelrendezés, vektorgrafika, betűtípusok és szöveg (beleértve a HTML story-kat és a szövegfolyamot), képek, űrlapok és JavaScript, jegyzetek és hivatkozások, vázlatok és célok, biztonság és digitális aláírások, címkézett PDF, PDF/A és PDF/UA megfelelőség, tartalomkinyerés és közvetlen hozzáférés, renderelés (a SelectRenderer a GDI+, Cairo vagy PDFium lehetőséget választja), nyomtatás, előellenőrzési jelentések és megjelenítőintegráció a TPDFlibViewer segítségével

A legtöbb tag három párhuzamos változatban érhető el: TPDFlib metódusként WideString paraméterekkel, DLL-belépési pontként DL előtaggal (valamint A utótagú ANSI-változatokkal szűk karakterláncos hívókhoz, lásd: SetAnsiMode), illetve ActiveX/COM-metódusként a PDFlib library automatizálási objektumon. Az egyes tagoldalak egymás mellett mutatják a Delphi és DLL szintaxist

Példa

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

Lásd még

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