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.
DescriptionXtAppSetErrorMsgHandler() 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 dis‐
play 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 imple‐
mented 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 AlsoXtAppError(1), XtAppErrorMsg(1), XtAppGetErrorDatabaseText(1),
XtAppSetErrorHandler(1), XtAppSetWarningHandler(1), XtAppSetWarningMs‐
gHandler(1), XtAppWarning(1), XtAppWarningMsg(1),
XtErrorHandler(2), XtErrorMsgHandler(2).
Xt - Error Handling XtAppSetErrorMsgHandler()
