CURSES

NAME

touchwin — window refresh control function

SYNOPSIS

#include <curses.h>

int touchwin(WINDOW *win);

DESCRIPTION

The touchwin() function touches the specified window (that is, marks it as having changed more recently than the last refresh operation). 

RETURN VALUE

Upon successful completion, the this function return OK.  Otherwise, it returns ERR. 

ERRORS

No errors are defined. 

APPLICATION USAGE

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

Screens, Windows and Terminals in curs_intro, doupdate(), is_linetouched(), <curses.h>. 

CHANGE HISTORY

First released in X/Open Curses, Issue 2. 

Hewlett-Packard Company  —  HP-UX Release 10.20:  July 1996