is_linetouched.3x (2010 09)

i
is_linetouched(3X) is_linetouched(3X)
(ENHANCED CURSES)
NAME
is_linetouched, is_wintouched, touchline, untouchwin, wtouchln — window refresh control functions
SYNOPSIS
#include <curses.h>
bool is_linetouched(WINDOW *win, int line);
bool is_wintouched(WINDOW *win);
int touchline(WINDOW *win, int start, int count);
int untouchwin(WINDOW *win);
int wtouchln(WINDOW *win, int y, int n, int changed);
DESCRIPTION
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 opera-
tion.
Calling
wtouchln(),ifchanged 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
is_wintouched() function determines whether the specified window is touched. The
is_linetouched() function determines whether line line of the specified window is touched.
RETURN VALUE
The
is_linetouched()
and is_wintouched() 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 function descriptions.
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
doupdate(3X), touchwin(3X), curses_intro(3X), see Screens, Windows and Terminals, <curses.h>.
CHANGE HISTORY
First released in X/Open Curses, Issue 4.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1