VDisplayErrorMessage


 
Name
  VDisplayErrorMessage - displays an error message in the dialog window.
 
Synopsis
  VDisplayErrorMessage(msg)
  char *msg;
 
Description
  VDisplayErrorMessage displays an error message in the dialog window in
a different color that VDisplayDialogMessage. VDisplayErrorMessage checks if 
the dialog window is in front of image message. If it is, VDisplayErrorMessage
displays the error message in the dialog window, else it puts it in the 
pixmap. The maximum lines reserved for the error message is two lines. If the 
error message is too long for one line, VDisplayErrorMessage places the rest 
of the message in the second line. If the error message is too long, 
VDisplayErrorMessage truncates the message and returns an error code.
 
Return Value
  0 - work successfully.
  1 - memory allocation fault.
  224 - message displayed is out of window boundary.
  258 - pixmap of the dialog window is NULL and image window is in
        front of the dialog window.
 
Parameters
  msg - specifies a string of message to be displayed in the dialog window.
 
Side Effects
  None.
 
Entry Conditions
  If msg is NULL, or VCreateColormap is not called earlier,
VDisplayErrorMessage prints an error message to the standard error stream,
produces a core dump file and exits from the current process.
 
Related Functions
VDisplayImageMessage, VDisplayButtonAction, VDisplayDialogMessage.