hpux man page for xtappsetwab

XtAppSetWarningMsgHandler()											       XtAppSetWarningMsgHandler()

Name
  XtAppSetWarningMsgHandler - set the high-level warning handler.

Synopsis
  XtErrorMsgHandler XtAppSetWarningMsgHandler(app_context, msg_handler)
	 XtAppContext app_context;
	 XtErrorMsgHandler msg_handler;

Inputs
  app_context
	    Specifies the application context.

  msg_handler
	    Specifies the new high-level warning handler.

Returns
  A pointer to the previously installed high-level warning handler.

Description
  XtAppSetWarningMsgHandler()  registers  the  procedure  msg_handler in app_context as the procedure to be invoked by XtAppWarningMsg().  It
  returns a pointer to the previously installed high-level warning handler.

  The default high-level warning handler provided by the Intrinsics is named _XtDefaultWarningMsg().  It looks up  a  message  in  the	error
  resource  database  (see  XtAppGetErrorDatabaseText()),  substitutes	the supplied parameters into the message, and calls XtWarning().  See
  XtWarningMsgHandler(2) for an explanation of how to write a customized high-level warning handler.

  msg_handler should generally invoke the low-level warning handler to display the message.

Usage
  Note that application-context-specific error and warning 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), XtAppSetErrorMsgHandler(1), XtAppSetWarningHan-
  dler(1), XtAppWarning(1), XtAppWarningMsg(1),
  XtErrorHandler(2), XtErrorMsgHandler(2).

Xt - Error Handling												       XtAppSetWarningMsgHandler()