X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_pad.3x.html;h=f59a9451acb5bc28549448addedda5d5968bbc61;hp=b5aee87daada29993cdb3fdf47bd2511ad196649;hb=f344f8539c1543f8cd65a5bb142dbaf23b9421d2;hpb=6a530b46563470c2ca73579d1994a0c8e275dd98 diff --git a/doc/html/man/curs_pad.3x.html b/doc/html/man/curs_pad.3x.html index b5aee87d..f59a9451 100644 --- a/doc/html/man/curs_pad.3x.html +++ b/doc/html/man/curs_pad.3x.html @@ -1,6 +1,6 @@ @@ -45,14 +45,12 @@ - -
+
newpad, subpad, prefresh, pnoutrefresh, pechochar, pecho_wchar - create and display curses pads --
+
#include <curses.h> WINDOW *newpad(int nlines, int ncols); @@ -66,11 +64,9 @@ int pecho_wchar(WINDOW *pad, const cchar_t *wch); --
+
--
+
The newpad routine creates and returns a pointer to a new pad data structure with the given number of lines, nlines, and columns, ncols. A pad is like a window, except that @@ -87,8 +83,7 @@ to be used for the display. --
+
The subpad routine creates and returns a pointer to a sub- window within a pad with the given number of lines, nlines, and columns, ncols. Unlike subwin, which uses @@ -100,8 +95,7 @@ fore calling prefresh. --
+
The prefresh and pnoutrefresh routines are analogous to wrefresh and wnoutrefresh except that they relate to pads instead of windows. The additional parameters are needed @@ -118,12 +112,11 @@ col, sminrow, or smincol are treated as if they were zero. --
+
The pechochar routine is functionally equivalent to a call - to addch followed by a call to refresh, a call to waddch - followed by a call to wrefresh, or a call to waddch fol- - lowed by a call to prefresh. The knowledge that only a + to addch followed by a call to refresh(3x), a call to wad- + dch followed by a call to wrefresh, or a call to waddch + followed by a call to prefresh. The knowledge that only a single character is being output is taken into considera- tion and, for non-control characters, a considerable per- formance gain might be seen by using these routines in- @@ -132,16 +125,14 @@ arguments to prefresh. --
+
The pecho_wchar function is the analogous wide-character form of pechochar. It outputs one character to a pad and immediately refreshes the pad. It does this by a call to wadd_wch followed by a call to prefresh. --
+
Routines that return an integer return ERR upon failure and OK (SVr4 only specifies "an integer value other than ERR") upon successful completion. @@ -169,19 +160,16 @@ turns an error. --
+
Note that pechochar may be a macro. --
+
The XSI Curses standard, Issue 4 describes these func- tions. --
+
curses(3x), curs_refresh(3x), curs_touch(3x), curs_add- ch(3x).