XtAppErrorMsg(3)

high-level error handlers

Section 3 libxt-dev bookworm source

Description

XtAppErrorMsg, XtAppSetErrorMsgHandler, XtAppSetWarningMsgHandler, XtAppWarningMsg - high-level error handlers

#include <X11/Intrinsic.h>

	void XtAppErrorMsg(XtAppContext app_context, const char *name, const char *type, const char *class, const char *defaultMsg, String *params, Cardinal *num_params);
	XtErrorMsgHandler XtAppSetErrorMsgHandler(XtAppContext app_context, XtErrorMsgHandler msg_handler);
	XtErrorMsgHandler XtAppSetWarningMsgHandler(XtAppContext app_context, XtErrorMsgHandler msg_handler);
	void XtAppWarningMsg(XtAppContext app_context, const char *name, const char *type, const char *class, const char *defaultMsg, String *params, Cardinal *num_params);

app_context

Specifies the application context.

	class	Specifies the resource class of the error message.
	defaultMsg	Specifies the default message to use.
	name	Specifies the general kind of error.
	type	Specifies the detailed name of the error.

msg_handler

Specifies the new fatal error procedure, which should not return or the nonfatal error procedure, which usually returns.

	num_params	Specifies the number of values in the parameter list.
	params	Specifies a pointer to a list of values to be stored in the message.

The XtAppErrorMsg function calls the high-level error handler and passes the specified information.

The XtAppSetErrorMsgHandler function registers the specified procedure, which is called when a fatal error occurs.

The XtAppSetWarningMsgHandler function registers the specified procedure, which is called when a nonfatal error condition occurs.

The XtAppWarningMsg function calls the high-level error handler and passes the specified information.