NAME
clear_window -- create unit to clear a predecessor window
PROTOTYPE
unitptr clear_window( char *pcWdw, int iCtrl, unitptr uHost)
ARGUMENTS
- char *pcWdw
- specifies which window to clear: if this string can be interpreted as an integer number iPos, the iPos -th successor window (if iPos>0 ) or the -iPos -th predecessor window (if iPos<0 ) is used; otherwise, a window that has pcWdw as its title is sought.
- int iCtrl
- initial value of ctrl pin
- unitptr uHost
- host unit
RETURN VALUE:
A pointer to the created unit or NULL in the case of an error.
INTERFACE OF CREATED UNIT:
- X_in[1]:
- (input field 0) initialized with iCtrl
- CTL_in[1]:
- (control field)
EXECUTION OF CREATED UNIT:
Clears the window that is specified by pcWdw , if
values at X_in and CTL_in are equal. Does nothing otherwise.
An initial target value for CTL_in can be set when the unit
is created.
CONTROL MODES:
None.
STATUS:
Preliminary.
SEE ALSO:
FILE
/local/homes/rhaschke/nst7/man/../o.linx86_64//../nstsrc/nst_draw.c