XtSetErrorH(3x) — HP-UX 9.05

NAME

XtSetErrorHandler − set the low-level error handler procedure.

Synopsis

void XtSetErrorHandler(handler)

XtErrorHandler handler;

Inputs

handlerSpecifies the new low-level fatal error procedure, which should not return.

Availability

XtSetErrorHandler() has been superseded by XtAppSetErrorHandler().

Description

XtSetErrorHandler() registers the procedure handler as the procedure to be invoked by XtError(). It should display the string it is passed and then must terminate the application; if it returns the subsequent behavior of the Intrinsics is undefined.

Usage

XtSetErrorHandler() has been superseded by XtAppSetErrorHandler(), which performs the same function on a per-application context basis. XtSetErrorHandler() now calls XtAppSetErrorHandler() passing the default application context created by XtInitialize(). Very few programs need multiple application contexts, and you can continue to use XtSetErrorHandler() if you initialize your application with XtInitialize(). We recommend, however, that you use XtAppInitialize(), XtAppSetErrorHandler(), and the other XtApp*() application context specific functions. See XtAppSetErrorHandler() for more information.

Museum