RTL

This is standard error dialog in your application. Exact visual appearance depends on your application's type. For example:

VCL Forms application: exception is handled by Application.ShowException

Console application: exception is not handled. Application terminates with $0EEDFADE error code.

It's usually used when you don't want to change existing visual experience at all, but want to add EurekaLog's capabilities to your application. If you set this dialog for your application then it will perform EurekaLog's tasks like saving bug report and/or sending report to developer and then invoke default error processing as if EurekaLog isn't here.

Warning: be EXTRA careful when using the "RTL" dialog in a multi-threaded application. For example, default exception handler in a VCL Forms application is a message box. The problem is that old IDE versions call this code "as is", e.g. without any synchronization. And since VCL is generally not thread-safe - you can safely show this dialog only in a main thread of your application. It means that you can't call this code from a background thread - without having thread synchronization issues. On the other hand, modern IDE versions do schedule this code to be executed in the main thread, so it can be called from a background thread. Moral of the story: study default RTL dialog's code for your type of application. Learn if it can be called safely from a background thread. Avoid using RTL dialog if it is not thread-safe.

Note: Unlike any other dialogs, this dialog invokes EurekaLog's tasks first and only then invokes standard error dialog - that's because standard error processing may include application's termination, so reverse order will not invoke EurekaLog at all. Take this into account if you want to show messages about send status - they will be showed before error message itself.

This dialog will store an empty "steps to reproduce" text, uses default user e-mail and perform report sending (as if the user has clicked on "Send" button) and sends screenshot, if it was created (specified in send options).

Default user information is extracted via GetUserEMail, GetUserFullName and GetUserName functions. You can set default user e-mail by calling SetUserEmail function.

This dialog is not customizable. If you want a customized behaviour - you need to use one of EurekaLog's dialogs instead.

Constant: edtRTL.

See also: