TPDFlibLogger
Tipos de datos, gestión de documentos
Descripción
TPDFlibLogger es la clase de registro estructurado adjunta a una instancia TPDFlib mediante su propiedad Logger. Cuando se asigna, recibe registros Debug, Info, Warn y Error, cada uno con un código numérico de la taxonomía existente LastErrorCode y un mensaje legible
El registrador pertenece al llamador y puede compartirse entre varias instancias de TPDFlib. Su valor predeterminado es nil, por lo que la ruta sin registrador no tiene coste
Sintaxis
Delphi
TPDFlibLogger = Class
Public
Constructor Create; Virtual;
Destructor Destroy; Override;
Procedure Log(Level: TPDFlibLogLevel; Code: Integer; Const Msg: WideString); Overload;
Procedure Log(Level: TPDFlibLogLevel; Code: Integer; Const Msg: WideString;
Const ExtraFieldsText: WideString); Overload;
Procedure Debug(Code: Integer; Const Msg: WideString);
Procedure Info(Code: Integer; Const Msg: WideString);
Procedure Warn(Code: Integer; Const Msg: WideString);
Procedure Error_(Code: Integer; Const Msg: WideString);
Property Level: TPDFlibLogLevel Read FLevel Write FLevel;
Property OnLog: TPDFlibLogEvent Read FOnLog Write FOnLog;
Property FileName: WideString Read FFileName Write SetFileName;
End;Parámetros
| Level | La gravedad mínima que se emitirá; los registros por debajo de este umbral se descartan silenciosamente |
|---|---|
| OnLog | Una devolución de llamada del host que se invoca por cada registro emitido y recibe el nivel, el código y el mensaje |
| FileName | Cuando se establece, los registros también se escriben en este archivo mediante un destino TStreamWriter seguro para subprocesos; bórrelo para detener el registro en archivo |
Observaciones
Los métodos auxiliares Debug, Info, Warn y Error_ llaman a Log con el nivel correspondiente
Las escrituras de archivos se serializan mediante una sección crítica, por lo que una sola instancia del registrador se puede utilizar con seguridad desde hilos de trabajo
PDFlibErrorMessage(Code) traduce un código numérico en un mensaje legible y puede llamarse independientemente del registrador