TPDFlibLogger

Datatyper, dokumenthåndtering

Beskrivelse

TPDFlibLogger er den strukturerede loggerklasse, der er knyttet til en TPDFlib-instans via dens egenskab Logger. Når den er tildelt, modtager den Debug-, Info-, Warn- og Error-poster, som hver indeholder en numerisk kode fra den eksisterende LastErrorCode-taksonomi og en menneskelæselig meddelelse

Loggeren ejes af kalderen og kan deles mellem flere TPDFlib-instanser. Den er som standard nil, så forløbet uden logger ikke medfører omkostninger

Syntaks

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;

Parametre

LevelDen laveste alvorsgrad, der skal udsendes; poster under denne tærskel kasseres uden meddelelse
OnLogEn værtscallback, der kaldes for hver udsendt post og modtager niveau, kode og meddelelse
FileNameNår denne er angivet, skrives poster også til denne fil via en trådsikker TStreamWriter-modtager; ryd den for at standse fillogning

Bemærkninger

Bekvemmelighedsmetoderne Debug, Info, Warn og Error_ kalder Log med det tilsvarende niveau

Filskrivninger serialiseres med en kritisk sektion, så én loggerinstans er sikker at bruge fra arbejdstråde

PDFlibErrorMessage(Code) oversætter en numerisk kode til en læsbar meddelelse og kan kaldes uafhængigt af loggeren

Se også

Logger, OnOperationProgress, LastErrorCode