Name

XtAppSetErrorMsgHandler — register a procedure to be called on fatal error conditions. 

Synopsis

XtErrorMsgHandler XtAppSetErrorMsgHandler(app_context, msg_handler)

    XtAppContext app_context;
    XtErrorMsgHandler msg_handler;

Arguments

app_context
Specifies the application context.

msg_handler
Specifies the new fatal error message handling procedure, which should not return.

Description

XtAppSetErrorMsgHandler returns a pointer to the previously installed high-level fatal error handler.  The default high-level fatal error handler provided by the Intrinsics is named _XtDefaultErrorMsg.  This fatal error handler constructs a string from the error resource database (see XtAppGetErrorDatabase) and calls XtError. 

Using XtAppSetErrorMsgHandler, you can replace the default handler with one of your own.  Note that if you simply want to change the way the message is displayed (rather than the way the message database is used), you should probably replace the low-level error handler (using XtAppSetErrorHandler) instead. 

Fatal error message handlers should not return.  If one does, subsequent X Toolkit behavior is undefined.  See XtErrorMsgHandler(2) for details.  Note that application-context-specific error handling is not implemented on many systems.  Most implementations will have just one set of error handlers.  If they are set for different application contexts, the one performed last will prevail. 

See Also

XtAppError(1), XtAppErrorMsg(1), XtAppSetErrorHandler(1), XtAppSetWarningHandler(1), XtAppSetWarningMsgHandler(1), XtAppWarning(1), XtAppWarningMsg(1),
XtErrorHandler(2), XtErrorMsgHandler(2).