Name

XtAppWarningMsg — call the installed high-level warning handler. 

Synopsis

void XtAppWarningMsg(app_context, name, type, class, default, params, num_params)

    XtAppContext app_context;
    String name;
    String type;
    String class;
    String default;
    String ∗params;
    Cardinal ∗num_params;

Arguments

app_context
Specifies the application context.

nameSpecifies the general kind of error; for example, InvalidParameter. 

typeSpecifies the detailed name of the error.  This is specified using printf-like syntax, with the parameters and number of parameters specified by params and num_params. 

classSpecifies the resource class. 

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

paramsSpecifies a pointer to a list of values to be stored in the type argument when the message if generated. 

num_params
Specifies the number of values in the parameter list.

Description

Xt provides two levels of error handling:

•A high-level interface that takes an error name and class and looks the error up in an error resource database. 

•A low-level interface that takes a simple string, which is printed out as the error message. 

The high-level functions construct a string to pass to the lower-level interface.  The name and type arguments are concatenated to form the "name" that is used to look up a message in the error database.  On POSIX-based systems, the error database is usually /usr/lib/X11/XtErrorDB.  In theory, most programs should use XtAppErrorMsg (or XtErrorMsg if application contexts are not being used), not XtAppError or XtError, so that the programs can be easily customized to provide international or other custom error messages.  However, the low-level handlers are much easier to use. 

XtAppError calls the low level fatal error handler.  Fatal errors are assumed to be catastrophic and irrecoverable.  A warning error handler also exists for errors that require attention but do not preempt a program running correctly to a normal successful completion.  (XtAppWarning calls the corresponding non-fatal error handler.  XtAppErrorMsg and XtAppWarningMsg call the corresponding high-level handlers.) 

See Also

XtAppError(1), XtAppErrorMsg(1), XtAppSetErrorHandler(1), XtAppSetErrorMsgHandler(1), XtAppSetWarningHandler(1), XtAppSetWarningMsgHandler(1), XtAppWarning(1),
XtErrorHandler(2), XtErrorMsgHandler(2).