X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_window.3x.html;h=4159bfdde573c4b7cde790f4d3190adbd9f5f8d1;hp=0b9d2a34eeba1c054719c74316e465f17fb3b5a4;hb=db5f7f4f146a91ba8ec7f1df8e9d7f9d2d7c74fd;hpb=46722468f47c2b77b3987729b4bcf2321cccfd01 diff --git a/doc/html/man/curs_window.3x.html b/doc/html/man/curs_window.3x.html index 0b9d2a34..4159bfdd 100644 --- a/doc/html/man/curs_window.3x.html +++ b/doc/html/man/curs_window.3x.html @@ -1,7 +1,6 @@ - +
+ +- +curs_window(3x) curs_window(3x) + + +-
- newwin, delwin, mvwin, subwin, derwin, mvderwin, dupwin, - wsyncup, syncok, wcursyncup, wsyncdown - create curses +NAME
+ newwin, delwin, mvwin, subwin, derwin, mvderwin, dupwin, + wsyncup, syncok, wcursyncup, wsyncdown - create curses windows-SYNOPSIS
+SYNOPSIS
#include <curses.h> - WINDOW *newwin(int nlines, int ncols, int begin_y, - int begin_x); + WINDOW *newwin( + int nlines, int ncols, + int begin_y, int begin_x); int delwin(WINDOW *win); int mvwin(WINDOW *win, int y, int x); - WINDOW *subwin(WINDOW *orig, int nlines, int ncols, + WINDOW *subwin(WINDOW *orig, + int nlines, int ncols, int begin_y, int begin_x); - WINDOW *derwin(WINDOW *orig, int nlines, int ncols, + WINDOW *derwin(WINDOW *orig, + int nlines, int ncols, int begin_y, int begin_x); int mvderwin(WINDOW *win, int par_y, int par_x); WINDOW *dupwin(WINDOW *win); @@ -69,17 +76,23 @@-DESCRIPTION
+DESCRIPTION
Calling newwin creates and returns a pointer to a new win- dow with the given number of lines and columns. The upper - left-hand corner of the window is at line begin_y, column - begin_x. If either nlines or ncols is zero, they default - to LINES - begin_y and COLS - begin_x. A new full-screen - window is created by calling newwin(0,0,0,0). - - Calling delwin deletes the named window, freeing all mem- - ory associated with it (it does not actually erase the - window's screen image). Subwindows must be deleted before + left-hand corner of the window is at + line begin_y, + column begin_x + + If either nlines or ncols is zero, they default to + LINES - begin_y and + COLS - begin_x. + + A new full-screen window is created by calling + newwin(0,0,0,0). + + Calling delwin deletes the named window, freeing all memo- + ry associated with it (it does not actually erase the win- + dow's screen image). Subwindows must be deleted before the main window can be deleted. Calling mvwin moves the window so that the upper left-hand @@ -91,23 +104,21 @@ Calling subwin creates and returns a pointer to a new win- dow with the given number of lines, nlines, and columns, ncols. The window is at position (begin_y, begin_x) on - the screen. (This position is relative to the screen, and - not to the window orig.) The window is made in the middle - of the window orig, so that changes made to one window - will affect both windows. The subwindow shares memory - with the window orig. When using this routine, it is nec- - essary to call touchwin or touchline on orig before call- - ing wrefresh on the subwindow. + the screen. The subwindow shares memory with the window + orig, so that changes made to one window will affect both + windows. When using this routine, it is necessary to call + touchwin or touchline on orig before calling wrefresh on + the subwindow. Calling derwin is the same as calling subwin, except that begin_y and begin_x are relative to the origin of the win- dow orig rather than the screen. There is no difference between the subwindows and the derived windows. - Calling mvderwin moves a derived window (or subwindow) - inside its parent window. The screen-relative parameters - of the window are not changed. This routine is used to - display different parts of the parent window at the same + Calling mvderwin moves a derived window (or subwindow) in- + side its parent window. The screen-relative parameters of + the window are not changed. This routine is used to dis- + play different parts of the parent window at the same physical position on the screen. Calling dupwin creates an exact duplicate of the window @@ -115,8 +126,8 @@ Calling wsyncup touches all locations in ancestors of win that are changed in win. If syncok is called with second - argument TRUE then wsyncup is called automatically when- - ever there is a change in the window. + argument TRUE then wsyncup is called automatically whenev- + er there is a change in the window. The wsyncdown routine touches each location in win that has been touched in any of its ancestor windows. This @@ -129,100 +140,111 @@-RETURN VALUE
- Routines that return an integer return the integer ERR - upon failure and OK (SVr4 only specifies "an integer value +RETURN VALUE
+ Routines that return an integer return the integer ERR up- + on failure and OK (SVr4 only specifies "an integer value other than ERR") upon successful completion. - delwin returns the integer ERR upon failure and OK upon - successful completion. - Routines that return pointers return NULL on error. + X/Open defines no error conditions. In this implementa- + tion --NOTES
- If many small changes are made to the window, the wsyncup - option could degrade performance. - - Note that syncok may be a macro. - - --BUGS
- The subwindow functions (subwin, derwin, mvderwin, wsyn- - cup, wsyncdown, wcursyncup, syncok) are flaky, incom- - pletely implemented, and not well tested. - - The System V curses documentation is very unclear about - what wsyncup and wsyncdown actually do. It seems to imply - that they are only supposed to touch exactly those lines - that are affected by ancestor changes. The language here, - and the behavior of the curses implementation, is pat- - terned on the XPG4 curses standard. The weaker XPG4 spec - may result in slower updates. - - --PORTABILITY
- The XSI Curses standard, Issue 4 describes these func- - tions. - - --SEE ALSO
- curses(3x), curs_refresh(3x), curs_touch(3x) - - - - - - - - - - - - - - - - - - - - - - - - + delwin + returns an error if the window pointer is null, or if + the window is the parent of another window. + derwin + returns an error if the parent window pointer is + null, or if any of its ordinates or dimensions is + negative, or if the resulting window does not fit in- + side the parent window. + dupwin + returns an error if the window pointer is null. + This implementation also maintains a list of windows, + and checks that the pointer passed to delwin is one + that it created, returning an error if it was not.. + mvderwin + returns an error if the window pointer is null, or if + some part of the window would be placed off-screen. + mvwin + returns an error if the window pointer is null, or if + the window is really a pad, or if some part of the + window would be placed off-screen. + newwin + will fail if either of its beginning ordinates is + negative, or if either the number of lines or columns + is negative. + syncok + returns an error if the window pointer is null. + subwin + returns an error if the parent window pointer is + null, or if any of its ordinates or dimensions is + negative, or if the resulting window does not fit in- + side the parent window. + The functions which return a window pointer may also fail + if there is insufficient memory for its data structures. + Any of these functions will fail if the screen has not + been initialized, i.e., with initscr or newterm. ++NOTES
+ If many small changes are made to the window, the wsyncup + option could degrade performance. + Note that syncok may be a macro. ++BUGS
+ The subwindow functions (subwin, derwin, mvderwin, wsyn- + cup, wsyncdown, wcursyncup, syncok) are flaky, incomplete- + ly implemented, and not well tested. + The System V curses documentation is very unclear about + what wsyncup and wsyncdown actually do. It seems to imply + that they are only supposed to touch exactly those lines + that are affected by ancestor changes. The language here, + and the behavior of the curses implementation, is pat- + terned on the XPG4 curses standard. The weaker XPG4 spec + may result in slower updates. ++PORTABILITY
+ The XSI Curses standard, Issue 4 describes these func- + tions. ++SEE ALSO
+ curses(3x), curs_refresh(3x), curs_touch(3x), curs_vari- + ables(3x) + curs_window(3x)-
- -Man(1) output converted with -man2html - +