NAME    [Toc]    [Back]

       curs_touch,   is_linetouched,   is_wintouched,  touchline,
       touchwin, untouchwin, wtouchln - Curses routines that control
 refresh

SYNOPSIS    [Toc]    [Back]

       #include <curses.h>

       bool is_linetouched(
               WINDOW *win,
               int line ); bool is_wintouched(
               WINDOW *win ); int touchline(
               WINDOW *win,
               int start,
               int count ); int touchwin(
               WINDOW *win ); int untouchwin(
               WINDOW *win ); int wtouchln(
               WINDOW *win,
               int y,
               int n,
               int changed );

LIBRARY    [Toc]    [Back]

       Curses Library (libcurses)

STANDARDS    [Toc]    [Back]

       Interfaces  documented  on  this reference page conform to
       industry standards as follows:

       is_linetouched,   is_wintouched,   touchline,    touchwin,
       untouchwin, wtouchln:  XCURSES4.2

       Refer to the standards(5) reference page for more information
 about industry standards and associated tags.

DESCRIPTION    [Toc]    [Back]

       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.  It  is sometimes necessary to call these
       routines when using overlapping windows.  In this case,  a
       change  to  one  window  affects the other window, but the
       other window's records of which lines have been changed do
       not  reflect the change in the first window. The touchline
       routine 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 (if changed=1) or
       have not changed (changed=0) since the last call  to  wrefresh.


       The  is_linetouched  or is_wintouched routines return TRUE
       if the specified line or window  was  modified  since  the
       last  call  to  wrefresh;  otherwise they return FALSE. In
       addition, is_linetouched returns ERR if line is not  valid
       for the given window.

NOTES    [Toc]    [Back]

       The  header  file  <curses.h>  automatically  includes the
       header file <stdio.h>.

       Note that touchline may be a macro.

RETURN VALUES    [Toc]    [Back]

       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  descriptions.

SEE ALSO    [Toc]    [Back]

       Functions: curses(3), curs_refresh(3)

       Others: standards(5)



                                                    curs_touch(3)