is_linetouched(3X)                                       is_linetouched(3X)

NAME
     islinetouched, iswintouched, touchline, touchwin, untouchwin,
     wtouchln - window refresh control functions

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

     #include <curses.h>

     bool islinetouched(WINDOW *win, int line);

     bool iswintouched(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);

DESCRIPTION
     The touchwin() function touches the specified window (that is, marks
     it as having changed more recently than the last refresh operation).
     The touchline() function only touches count lines, beginning with line
     start.

     The untouchwin() function marks all lines in the window as unchanged
     since the last refresh operation.

     Calling wtouchln(), if changed is 1, touches n lines in the specified
     window, starting at line y. If changed is 0, wtouchln() marks such
     lines as unchanged since the last refresh operation.

     The iswintouched() function determines whether the specified window
     is touched. The islinetouched() function determines whether line line
     of the specified window is touched.

RETURN VALUE
     The islinetouched() and iswintouched() functions return TRUE if any
     of the specified lines, or the specified window, respectively, has
     been touched since the last refresh operation. Otherwise, they return
     FALSE.

     Upon successful completion, the other functions return OK. Otherwise,
     they return ERR. Exceptions to this are noted in the preceding func-
     tion descriptions.

ERRORS
     No errors are defined.





Page 1                       Reliant UNIX 5.44                Printed 11/98

is_linetouched(3X)                                       is_linetouched(3X)

NOTES
     Calling touchwin() or touchline() is sometimes necessary when using
     overlapping 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.

SEE ALSO
     curses(3X), doupdate(3X), curses(5).














































Page 2                       Reliant UNIX 5.44                Printed 11/98