Curses Library Functions                      curstouch(3CURSES)



NAME
     curstouch,  touchwin,  touchline,   untouchwin,   wtouchln,
     islinetouched,  iswintouched - curses refresh control rou-
     tines

SYNOPSIS
     cc [ flag ... ] file ... -lcurses [ library ... ]
     #include 

     int touchwin(WINDOW *win);


     int touchline(WINDOW *win, int start, int count);


     int untouchwin(WINDOW *win);


     int wtouchln(WINDOW *win, int y, int n, int changed);


     int islinetouched(WINDOW *win, int line);


     int iswintouched(WINDOW *win);


DESCRIPTION
     The touchwin()  and  touchline()  routines  throw  away  all
     optimization  information  about  which  parts of the window
     have been touched, by pretending that the entire window  has
     been  drawn on. This is sometimes necessary when using over-
     lapping windows, since a change to one  window  affects  the
     other  window,  but  the  records  of  which lines have been
     changed in the other window do not reflect the  change.  The
     routine touchline() only pretends that count lines have been
     changed, beginning with line start.


     The untouchwin() routine marks all lines in  the  window  as
     unchanged since the last call to wrefresh().


         The wtouchln() routine makes  n  lines  in  the  window,
     starting at line y, look as if they have (changed=1) or have
     not  (changed=0)  been  changed  since  the  last  call   to
     wrefresh().


     The islinetouched()  and  iswintouched()  routines  return
     TRUE  if  the  specified  line/window was modified since the
     last call to wrefresh(); otherwise  they  return  FALSE.  In



SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                      curstouch(3CURSES)



     addition,  islinetouched() returns ER if line is not valid
     for the given window.

RETURN VALUES
     All routines return the integer  ER  upon  failure  and  an
     integer  value  other  than  ER upon successful completion,
     unless otherwise noted in  the  preceding  routine  descrip-
     tions.

ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     cursrefresh(3CURSES), curses(3CURSES), attributes(5)

NOTES
     The header   automatically  includes  the  headers
      and .


     Note that all routines except wtouchln() may be macros.
























SunOS 5.11          Last change: 31 Dec 1996                    2