1curs_touch(3CURSES)        Curses Library Functions        curs_touch(3CURSES)
2
3
4

NAME

6       curs_touch,  touchwin, touchline, untouchwin, wtouchln, is_linetouched,
7       is_wintouched - curses refresh control routines
8

SYNOPSIS

10       cc [ flag ... ] file ... -lcurses [ library ... ]
11       #include <curses.h>
12
13       int touchwin(WINDOW *win);
14
15
16       int touchline(WINDOW *win, int start, int count);
17
18
19       int untouchwin(WINDOW *win);
20
21
22       int wtouchln(WINDOW *win, int y, int n, int changed);
23
24
25       int is_linetouched(WINDOW *win, int line);
26
27
28       int is_wintouched(WINDOW *win);
29
30

DESCRIPTION

32       The touchwin() and touchline() routines  throw  away  all  optimization
33       information  about which parts of the window have been touched, by pre‐
34       tending that the entire window has been drawn  on.  This  is  sometimes
35       necessary  when using overlapping windows, since a change to one window
36       affects the other window, but the records  of  which  lines  have  been
37       changed  in  the  other  window  do not reflect the change. The routine
38       touchline() only pretends that count lines have been changed, beginning
39       with line start.
40
41
42       The  untouchwin()  routine  marks  all lines in the window as unchanged
43       since the last call to wrefresh().
44
45
46           The wtouchln() routine makes n lines in  the  window,  starting  at
47       line  y,  look as if they have (changed=1) or have not (changed=0) been
48       changed since the last call to wrefresh().
49
50
51       The is_linetouched() and is_wintouched() routines return  TRUE  if  the
52       specified  line/window  was modified since the last call to wrefresh();
53       otherwise they return FALSE. In addition, is_linetouched() returns  ERR
54       if line is not valid for the given window.
55

RETURN VALUES

57       All  routines  return the integer ERR upon failure and an integer value
58       other than ERR upon successful completion, unless  otherwise  noted  in
59       the preceding routine descriptions.
60

ATTRIBUTES

62       See attributes(5) for descriptions of the following attributes:
63
64
65
66
67       ┌─────────────────────────────┬─────────────────────────────┐
68       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
69       ├─────────────────────────────┼─────────────────────────────┤
70       │MT-Level                     │Unsafe                       │
71       └─────────────────────────────┴─────────────────────────────┘
72

SEE ALSO

74       curs_refresh(3CURSES), curses(3CURSES), attributes(5)
75

NOTES

77       The header <curses.h> automatically includes the headers  <stdio.h> and
78       <unctrl.h>.
79
80
81       Note that all routines except wtouchln() may be macros.
82
83
84
85SunOS 5.11                        31 Dec 1996              curs_touch(3CURSES)