VClearWindow

 
Name
  VClearWindow - clears a region in the specified window.
 
Synopsis
  VClearWindow(win, xloc, yloc, width, height)
  Window win;
  int xloc, yloc;
  int width, height;
 
Description
  VClearWindow clears a region in the specified window. If the window is
dialog window, VClearWindow clears the window or the pixmap depending on
whether the dialog window is in front or back of the image window.
If the window is the image window or one of its subwindows, then VClearWindow 
clears the window itself. If the window is the button window, VClearWindow 
clears the window itself. If the width and height are equal to 0, VClearWindow
clears the whole window from the location (xloc, yloc).
 
Return Value
  0 - work successfully.
  6 - invalid window ID.
  258 - pixmap of the dialog window is NULL and the image window is in
        front of the dialog window.
 
Parameters
  win - specifies the ID of the window to be cleared.
  xloc, yloc - specifies x and y coordinates of the upper left corner of the
        rectangle, relative to the origin of the image window.
  width, height - specifies the width and height of the window to be cleared.
 
Side Effects
  None.
 
Entry Conditions
  If xloc, yloc, width, or height is not valid, or VCreateWindows is not
called earlier, VClearWindow prints an error message to the standard error 
stream, produces a core dump file and exits from the current process.
 
Related Functions