TPDFlibLogger
Tipos de datos, administración de documentos
Descripción
TPDFlibLogger es la clase de registro estructurado vinculada a una instancia de 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 de LastErrorCode y un mensaje legible por personas
El registrador es propiedad del llamador y puede compartirse entre varias instancias de TPDFlib. Su valor predeterminado es nil, por lo que la ruta sin registrador no tiene costo
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 invocada para cada registro emitido, que recibe el nivel, código y mensaje |
| FileName | Cuando se establece, los registros también se escriben en este archivo mediante un receptor TStreamWriter seguro para subprocesos; bórrelo para detener el registro en archivo |
Observaciones
Los métodos de conveniencia Debug, Info, Warn y Error_ llaman a Log con el nivel correspondiente
Las escrituras de archivo se serializan mediante una sección crítica, por lo que una sola instancia de registrador puede usarse de forma segura desde hilos de trabajo
PDFlibErrorMessage(Code) traduce un código numérico a un mensaje legible y puede llamarse independientemente del registrador