VDisplayImageMessage


 
Name
  VDisplayImageMessage - displays a message in the image window.
 
Synopsis
  VDisplayImageMessage(win, msg, num_of_msg, xloc, yloc)
  Window win;
  char msg[][MSG_WIDTH];
  int num_of_msg;
  int xloc, yloc;
 
Description
  VDisplayImageMessage displays the messages, one message per line,
starting at the specified location in the image window or in one of its
subwindows. If the message is out of the window boundary, VDisplayImageMessage
truncates the message, and returns an error code.
 
Return Value
  0 - work successfully.
  6 - invalid window ID.
  223 - message displayed in the image window is covered by the dialog window.
  224 - message displayed is out of window boundary
 
Parameters
  win - the image window ID or one of its subwindows' ID.
  msg - a message to be displayed in the specified window.
  num_of_msg - number of messages to be displayed.
  xloc, yloc - the starting location for displaying the message in the
        specified window.
 
Side Effects
  None.
 
Entry Conditions
  If the value xloc, or yloc is not valid, num_of_msg is less than or equal
to zero, msg is NULL, or VCreateColormap is not called earlier, or the
whole message is out of the window boundary, VDisplayImageMessage prints an
error message to the standard error stream, produces a core dump file and
exits from the current process.
 
Related Functions
VDisplayDialogMessage, VDisplayButtonAction, VDisplayOverlayMessage, VEraseOverlayMessage.