TPDFlib

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

Descripción

TPDFlib (unidad Lib\PDFlibrary.pas) es la clase central de PDF Library for Delphi. Una sola instancia alberga uno o más documentos PDF al mismo tiempo: NewDocument inicia un documento vacío, LoadFromFile carga uno existente, SelectDocument cambia el documento activo y DocumentCount informa cuántos están abiertos. Todas las llamadas de dibujo, texto, formularios, anotaciones, seguridad, firma, extracción, renderizado, impresión y validación operan en el documento seleccionado actualmente

La unidad PDFlibrary es la unidad principal: agregarla a la cláusula uses 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; liberarla cierra 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 en activo otro documento abierto
`DocumentCount`	Número de documentos abiertos actualmente en la instancia
`SaveToFile`	Escribe el documento activo en disco (las actualizaciones incrementales conservan intactas las firmas anteriores)
`LastErrorCode`	Código numérico del error más reciente; 0 cuando la última llamada se realizó correctamente
`Abort` / `Aborted`	Cancela cooperativamente una operación de larga duración e informa el estado de cancelación
`OnProgress` / `OnOperationProgress`	Devoluciones de llamada de progreso generales y detalladas para operaciones largas
`OnPassword`	Solicita al host una contraseña cuando un documento cifrado la necesita
`Logger`	Instancia opcional de `TPDFlibLogger` que recibe registros de log estructurados
`MailProvider`	`IPDFlibMailProvider` opcional que usan las funciones de correo

Observaciones

Las páginas de referencia de esta documentación describen los miembros uno por uno, agrupados 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 con PDF/A y PDF/UA, extracción de contenido y acceso directo, representación (SelectRenderer elige GDI+, Cairo o PDFium), impresión, informes de preflight e integración con el visor mediante TPDFlibViewer

La mayoría de los miembros existen en tres variantes paralelas: como métodos 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 en el objeto de automatización PDFlib library Las páginas de cada miembro muestran la sintaxis de Delphi y DLL en paralelo

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