curs_touch(3X)   MISCELLANEOUS LIBRARY FUNCTIONS   curs_touch(3X)



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

SYNOPSIS
     #include <curses.h>

     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 optimiza-
     tion  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 overlapping win-
     dows, 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  touch-
     line  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
     addition, islinetouched returns ERR if line  is  not  valid
     for the given window.

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

NOTES
     The header file <curses.h> automatically includes the header
     files <stdio.h> and <unctrl.h>.

     Note that all routines except wtouchln may be macros.

SEE ALSO
     curses(3X), cursrefresh(3X).






                          Last change:                          1