X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_touch.3x.html;h=6a7ee9be6ace6e15919c625a955f507771c7e6ab;hp=52660dba30cc7920bac0e9eac374f6f7a2ae8672;hb=2a32bee362db64f5a06b2124976b928ac3faa578;hpb=55ccd2b959766810cf7db8d1c4462f338ce0afc8 diff --git a/doc/html/man/curs_touch.3x.html b/doc/html/man/curs_touch.3x.html index 52660dba..6a7ee9be 100644 --- a/doc/html/man/curs_touch.3x.html +++ b/doc/html/man/curs_touch.3x.html @@ -1,7 +1,6 @@ - +
+ +- curs_touch(3x) curs_touch(3x) --
+
touchwin, touchline, untouchwin, wtouchln, is_linetouched, is_wintouched - curses refresh control routines --
+
#include <curses.h> int touchwin(WINDOW *win); int touchline(WINDOW *win, int start, int count); @@ -62,8 +60,7 @@ bool is_wintouched(WINDOW *win); --
+
The touchwin and touchline routines throw away all opti- mization information about which parts of the window have been touched, by pretending that the entire window has @@ -79,66 +76,68 @@ The wtouchln routine makes n lines in the window, starting at line y, look as if they have (changed=1) or have not - (changed=0) been changed since the last call to wrefresh. + (changed=0) been changed since the last call to wrefresh. - The is_linetouched and is_wintouched routines return TRUE - if the specified line/window was modified since the last - call to wrefresh; otherwise they return FALSE. In addi- - tion, is_linetouched returns ERR if line is not valid for + The is_linetouched and is_wintouched routines return TRUE + if the specified line/window was modified since the last + call to wrefresh; otherwise they return FALSE. In addi- + tion, is_linetouched returns ERR if line is not valid for the given window. --
- All routines return the integer ERR upon failure and an - integer value other than ERR upon successful completion, - unless otherwise noted in the preceding routine descrip- +
+ All routines return the integer ERR upon failure and an + integer value other than ERR upon successful completion, + unless otherwise noted in the preceding routine descrip- tions. - X/Open does not define any error conditions. In this im- + X/Open does not define any error conditions. In this im- plementation is_linetouched - returns an error if the window pointer is - null, or if the line number is outside the - window. Note that ERR is distinct from TRUE - and FALSE, which are the normal return values + returns an error if the window pointer is + null, or if the line number is outside the + window. Note that ERR is distinct from TRUE + and FALSE, which are the normal return values of this function. wtouchln - returns an error if the window pointer is - null, or if the line number is outside the + returns an error if the window pointer is + null, or if the line number is outside the window. --
- The XSI Curses standard, Issue 4 describes these func- +
+ The XSI Curses standard, Issue 4 describes these func- tions. - Some historic curses implementations had, as an undocu- - mented feature, the ability to do the equivalent of - clearok(..., 1) by saying touchwin(stdscr) or clear(std- + Some historic curses implementations had, as an undocu- + mented feature, the ability to do the equivalent of + clearok(..., 1) by saying touchwin(stdscr) or clear(std- scr). This will not work under ncurses. --
+
Note that all routines except wtouchln may be macros. --
- curses(3x), curs_refresh(3x). +
+ curses(3x), curs_refresh(3x), curs_variables(3x). curs_touch(3x)-