TPDFlib

Oggetto principale, creazione dei documenti, gestione dei documenti

Descrizione

TPDFlib (unità Lib\PDFlibrary.pas) è la classe centrale. Un'istanza gestisce più PDF: NewDocument crea, LoadFromFile carica, SelectDocument seleziona e DocumentCount conta. Tutte le operazioni agiscono sul documento selezionato

L'unità PDFlibrary è l'unità generale: aggiungendola alla clausola uses si include l'intera superficie pubblica, quindi per la maggior parte dei programmi è sufficiente Uses PDFlibrary;

Sintassi

Delphi

Uses PDFlibrary;

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

Parametri

`Create` / `Destroy`	Ciclo di vita dell'istanza; liberandola vengono chiusi tutti i documenti aperti
`NewDocument`	Avvia un nuovo documento PDF vuoto e lo seleziona
`LoadFromFile`	Carica un PDF esistente dal disco, facoltativamente con una password, e lo seleziona
`SelectDocument`	Rende attivo un altro documento aperto
`DocumentCount`	Numero di documenti attualmente aperti nell'istanza
`SaveToFile`	Scrive il documento attivo su disco (gli aggiornamenti incrementali mantengono intatte le firme precedenti)
`LastErrorCode`	Codice numerico dell'errore più recente; 0 quando l'ultima chiamata è riuscita
`Abort` / `Aborted`	Annulla in modo cooperativo un'operazione di lunga durata e segnala lo stato di annullamento
`OnProgress` / `OnOperationProgress`	Callback di avanzamento generici e dettagliati per operazioni lunghe
`OnPassword`	Richiede all'host una password quando ne occorre una per un documento cifrato
`Logger`	Istanza facoltativa `TPDFlibLogger` che riceve record di log strutturati
`MailProvider`	`IPDFlibMailProvider` facoltativo usato dalle funzioni di posta

Note

Le pagine di riferimento descrivono i membri per attività: documenti, layout, grafica, font e testo, immagini, moduli e JavaScript, annotazioni, segnalibri, sicurezza e firme, PDF con tag, PDF/A e PDF/UA, estrazione, Direct Access, rendering (SelectRenderer sceglie GDI+, Cairo o PDFium), stampa, preflight e integrazione viewer tramite TPDFlibViewer

La maggior parte dei membri esiste in tre varianti parallele: come metodi TPDFlib che accettano WideString, come punti di ingresso DLL con prefisso DL, oltre alle varianti ANSI con suffisso A per chiamanti che usano stringhe strette, vedere SetAnsiMode, e come metodi ActiveX/COM sull'oggetto di automazione PDFlib library. Le pagine dei singoli membri mostrano affiancate la sintassi Delphi e DLL

Esempio

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

Vedere anche

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