Type TELEvRaiseMeth

Code (Delphi)

TELEvRaiseMeth = procedure(

AExceptionInfo: TEurekaExceptionInfo;

var ACallNextHandler: Boolean

) of object;

Important!

Do not place exception processing code into event handler for this event. Use OnExceptionNotify event instead.

Note

OnRaise event is invoked when EurekaLog detects that a new exception is raised. Depending on project configuration and environment - it can happen before or after an exception is actually thrown by CPU. This means that not all exception information may be collected. For example, a call stack may be nil - because building call stack for the exception requires CPU context record - which is not available until exception is actually thrown by CPU.

Note

OnRaise event is wrapped into OnActionNotify events with atCollectingExceptionInfo/atCollectedExceptionInfo.

Caution!

Any event is called from the context of exception thread, which may be not the main thread of application. Thus, it's highly recommended to avoid using any global-like data and to avoid access VCL objects. If you still need to do any of that - please use proper thread synchronization for globals and Synchronize method for VCL access.

Warning

Event handlers registered via TEurekaLogEvents component will be active only when corresponding form is live (created). Such handlers will not be called before form is created or after it was destroyed. For this reason you may want to register your event handlers via code. For example, it would be a bad idea to use TEurekaLogEvents component for implementing your error dialog, because your dialog will not be displayed for exceptions outside form (e.g. initialization/finalization exceptions, as well as exceptions in form's constructor).

Code (Delphi)

raise Exception.Create('Error'); // - event will be raised here

Code (Delphi)

procedure TMyObject.OnRaise(AExceptionInfo: TEurekaExceptionInfo; var ACallNextHandler: Boolean);

begin

// Collect additional information for exception

AExceptionInfo.AdditionalInfo := 'Sample additional data';

end;