TPDFlib

Objeto principal, creación de documentos, gestión de documentos

Descripción

TPDFlib (unidad Lib\PDFlibrary.pas) es la clase central. Una instancia aloja varios documentos: NewDocument crea, LoadFromFile carga, SelectDocument selecciona y DocumentCount cuenta. Todas las operaciones actúan sobre el seleccionado

La unidad PDFlibrary es la unidad general: al añadirla a la cláusula uses se incorpora toda la superficie pública, por lo que la mayoría de los programas solo necesitan Uses PDFlibrary;

Sintaxis

Delphi

Uses PDFlibrary;

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

Parámetros

`Create` / `Destroy`	Ciclo de vida de la instancia; al liberarla se cierran todos los documentos abiertos
`NewDocument`	Inicia un documento PDF nuevo y vacío, y lo selecciona
`LoadFromFile`	Carga un PDF existente desde el disco, opcionalmente con contraseña, y lo selecciona
`SelectDocument`	Convierte otro documento abierto en el activo
`DocumentCount`	Número de documentos abiertos actualmente en la instancia
`SaveToFile`	Escribe el documento activo en el disco (las actualizaciones incrementales mantienen intactas las firmas anteriores)
`LastErrorCode`	Código numérico del error más reciente; 0 si la última llamada tuvo éxito
`Abort` / `Aborted`	Cancela cooperativamente una operación de larga duración e indica el estado de cancelación
`OnProgress` / `OnOperationProgress`	Devoluciones de llamada de progreso generales y detalladas para operaciones prolongadas
`OnPassword`	Solicita una contraseña al anfitrión cuando un documento cifrado la necesita
`Logger`	Instancia opcional de `TPDFlibLogger` que recibe registros estructurados
`MailProvider`	`IPDFlibMailProvider` opcional utilizado por las funciones de correo

Observaciones

Las páginas de referencia de esta documentación describen los miembros uno por uno y los agrupan por tarea: gestión de documentos, diseño de página, gráficos vectoriales, fuentes y texto (incluidos relatos HTML y flujo de texto), imágenes, formularios y JavaScript, anotaciones y enlaces, esquemas y destinos, seguridad y firmas digitales, PDF etiquetado, conformidad PDF/A y PDF/UA, extracción de contenido y acceso directo, renderizado (SelectRenderer elige GDI+, Cairo o PDFium), impresión, informes de comprobación preliminar e integración con el visor mediante TPDFlibViewer

La mayoría de los miembros existen en tres variantes paralelas: como métodos de TPDFlib que reciben WideString, como puntos de entrada de DLL con prefijos DL (además de variantes ANSI con sufijo A para llamadores de cadenas estrechas; consulte SetAnsiMode) y como métodos ActiveX/COM del objeto de automatización PDFlib library. Las páginas de cada miembro muestran en paralelo la sintaxis de Delphi y DLL

Ejemplo

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

Véase también

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