xtappwarnib(3) [hpux man page]

XtAppWarningMsg()														 XtAppWarningMsg()

Name
  XtAppWarningMsg - call the 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;

Inputs
  app_context
	    Specifies the application context.

  name	    Specifies the general kind of error.

  type	    Specifies the detailed name of the error.

  class     Specifies the resource class.

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

  params    Specifies an array of values to be inserted into the message.

  num_params
	    Specifies the number of elements in params.

Description
  XtAppWarningMsg() passes all of its arguments except app_context to the installed high-level warning handler.  The default high-level warn-
  ing handler is _XtDefaultWarningMsg().  It calls XtAppGetErrorDatabaseText() to lookup a 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().

  See XtAppGetErrorDatabaseText() for details on how messages are looked up in the error database.

Usage
  To report fatal error messages and exit, use XtAppErrorMsg().  To change the high-level warning handler, use XtAppSetWarningMsgHandler().

  Note that the num_params argument to this function is a Cardinal *, not a Cardinal.

  Although  the  Intrinsics interface allows separate error and warning handlers for each application context, most implementations will sup-
  port only a single set of handlers.  When a new handler is installed, it will be used in all application contexts.

Example
  The following code is from XtDisplayStringConversionWarning():

     String params[2];
     Cardinal num_params = 2;

     params[0] = (String)from;
     params[1] = (String)toType;
     XtAppWarningMsg(XtDisplayToApplicationContext(dpy),
		     XtNconversionError, "string", XtCXtToolkitError,
		     "Cannot convert string to type %s",
		     params, &num_params);

See Also
  XtAppError(1), XtAppErrorMsg(1), XtAppSetErrorHandler(1), XtAppSetErrorMsgHandler(1), XtAppSetWarningHandler(1), XtAppSetWarningMsgHan-
  dler(1), XtAppWarning(1),
  XtErrorHandler(2), XtErrorMsgHandler(2).

Xt - Error Handling														 XtAppWarningMsg()

Check Out this Related Man Page

XtAppErrorMsg(3Xt)						   XT FUNCTIONS 						XtAppErrorMsg(3Xt)

NAME

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

SYNTAX

       void XtAppErrorMsg(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;

       void XtAppSetErrorMsgHandler(app_context, msg_handler)
	     XtAppContext app_context;
	     XtErrorMsgHandler msg_handler;

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

       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.

       class	 Specifies the resource class.

       default	 Specifies the default message to use.

       name	 Specifies the general kind of error.

       type	 Specifies the detailed name of the error.  or the nonfatal error procedure, which usually returns

       msg_handler
		 Specifies the new fatal error procedure, which should not return.

       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.

DESCRIPTION

       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.

SEE ALSO

       XtAppGetErrorDatabase(3Xt), XtAppError(3Xt)
       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface

X Version 11							    Release 6.6 						XtAppErrorMsg(3Xt)

Linux and UNIX Man Pages

xtappwarnib(3) [hpux man page]

Check Out this Related Man Page