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.