is_linetouched(3curses)
is_linetouched --
window refresh control functions
Synopsis
cc [options] file -lcurses
#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);
Description
The
touchwin(3curses)
function touches the specified window (that is, marks it as having changed
more recently than the last refresh operation).
The
touchline(3curses)
function only touches count lines,
beginning with line start.
The
untouchwin(3curses)
function marks all lines in the window as unchanged since the last refresh
operation.
Calling
wtouchln(3curses),
if changed is 1, touches n lines in the specified
window, starting at line y.
If changed is 0,
wtouchln(3curses)
marks such lines as unchanged since the last refresh operation.
The
is_wintouched(3curses)
function determines whether the specified window is touched. The
is_linetouched(3curses)
function determines whether line
line
of the specified window is touched.
Return value
The
is_linetouched(3curses)
and
is_wintouched(3curses)
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.
Usage
Calling
touchwin(3curses)
or
touchline(3curses)
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.
Standards Conformance
The Single UNIX Specification, Version 2; The Open Group.
References
``Definitions'',
doupdate(3curses),
curses(4)
© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004