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 XtErrorMsgHandler(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

XtAppErrorUNIX SYSTEM V/68, XtAppErrorMsgUNIX SYSTEM V/68, XtAppGetErrorDatabaseTextUNIX SYSTEM V/68, XtAppSetErrorHandlerUNIX SYSTEM V/68, XtAppSetWarningHandlerUNIX SYSTEM V/68, XtAppSetWarningMsgHandlerUNIX SYSTEM V/68, XtAppWarningUNIX SYSTEM V/68, XtAppWarningMsgUNIX SYSTEM V/68,
XtErrorHandlerUNIX SYSTEM V/88, XtErrorMsgHandlerUNIX SYSTEM V/88.