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=df4d29b3b62c776a211d10dc277d0cf66a85f964;hb=027d0c57c4c4d6690e8d8727888d3282dbe9aa86;hpb=71c0306f0824ef2b10c4c5813fb003db48f3012e diff --git a/doc/html/man/curs_window.3x.html b/doc/html/man/curs_window.3x.html index df4d29b3..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)-
+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); @@ -73,13 +76,19 @@-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). + 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- @@ -95,13 +104,11 @@ 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- @@ -133,7 +140,7 @@-RETURN 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. @@ -143,34 +150,54 @@ X/Open defines no error conditions. In this implementa- tion - delwin - returns an error if the window pointer is - null, or if the window is the parent of anoth- - er window. + 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. - 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.. + newwin + will fail if either of its beginning ordinates is + negative, or if either the number of lines or columns + is negative. - mvderwin - returns an error if the window pointer is - null, or if some part of the window would be - placed off-screen. + syncok + returns an error if the window pointer is null. - 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. + 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. - syncok - returns an error if the window pointer is - null. + 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
+NOTES
If many small changes are made to the window, the wsyncup option could degrade performance. @@ -178,7 +205,7 @@-BUGS
+BUGS
The subwindow functions (subwin, derwin, mvderwin, wsyn- cup, wsyncdown, wcursyncup, syncok) are flaky, incomplete- ly implemented, and not well tested. @@ -193,23 +220,31 @@-PORTABILITY
+PORTABILITY
The XSI Curses standard, Issue 4 describes these func- tions.-SEE ALSO
- curses(3x), curs_refresh(3x), curs_touch(3x) +SEE ALSO
+ curses(3x), curs_refresh(3x), curs_touch(3x), curs_vari- + ables(3x) curs_window(3x)-
- -Man(1) output converted with -man2html - +