XtWarningMs(3x) — HP-UX ANSI C A.10.11

NAME

XtWarningMsg − call the high-level warning handler.

Synopsis

void XtWarningMsg(name, type, class, default, params, num_params)

    String name;
    String type;
    String class;
    String default;
    String *params;
    Cardinal *num_params;

Inputs

nameSpecifies the general kind of error.

typeSpecifies the detailed name of the error.

classSpecifies the resource class of the error.

defaultSpecifies the default message to use if no message is found in the database.

paramsSpecifies an array of values to be inserted into the message.

num_params
Specifies the number of elements in params.

Availability

XtWarningMsg() has been superseded by XtAppWarningMsg().

Description

XtWarningMsg() passes all of its arguments to the installed high-level warning handler. The default high-level warning handler is _XtDefaultWarningMsg(). It calls XtAppGetErrorDatabaseText() to lookup an error message of the specified name, type, and class in the error database. If no such message is found, XtAppGetErrorDatabaseText() returns the specified default message. In either case, _XtDefaultWarningMsg() does a printf-style substitution of params into the message, and passes the resulting text to the low-level warning handler by calling XtWarning().

Usage

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

Museum