XtAppSetErrorMsgHandler() XtAppSetErrorMsgHandler()
Name
XtAppSetErrorMsgHandler - set the high-level error handler.
Synopsis
XtErrorMsgHandler XtAppSetErrorMsgHandler(app_context, msg_handler)
XtAppContext app_context;
XtErrorMsgHandler msg_handler;
Inputs
app_context
Specifies the application context.
msg_handler
Specifies the new high-level fatal error message handling procedure, which should not return.
Returns
A pointer to the previously installed high-level error handler.
Description
XtAppSetErrorMsgHandler() registers the procedure msg_handler in app_context as the procedure to be invoked by XtAppErrorMsg(). It returns
a pointer to the previously installed high-level error handler.
The default high-level fatal error handler provided by the Intrinsics is named _XtDefaultErrorMsg(). It looks up a message in the error
resource database (see XtAppGetErrorDatabaseText()), substitutes the supplied parameters into the message, and calls XtError(). See XtEr-
rorMsgHandler(2) for an explanation of how to write a customized high-level error handler.
msg_handler should generally invoke the low-level error handler to display the message and exit. Fatal error message handlers should not
return. If one does, subsequent X Toolkit behavior is undefined.
Usage
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), XtAppGetErrorDatabaseText(1), XtAppSetErrorHandler(1), XtAppSetWarningHandler(1), XtAppSetWarningMsgHan-
dler(1), XtAppWarning(1), XtAppWarningMsg(1),
XtErrorHandler(2), XtErrorMsgHandler(2).
Xt - Error Handling XtAppSetErrorMsgHandler()
