X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fwresize.3x.html;h=8ddc39bb1fd549372722e76bdebfa838b1061c7d;hp=3e4ed35a2f5e13050e3815c209cf7d9ed8390ab6;hb=HEAD;hpb=027ae42953e3186daed8f3882da73de48291b606;ds=sidebyside diff --git a/doc/html/man/wresize.3x.html b/doc/html/man/wresize.3x.html index 3e4ed35a..b224fd39 100644 --- a/doc/html/man/wresize.3x.html +++ b/doc/html/man/wresize.3x.html @@ -1,7 +1,7 @@ - - +
-- -wresize(3x) wresize(3x) +wresize(3x) Library calls wresize(3x) --
- wresize - resize a curses window +
+ wresize - resize a curses window --
+
#include <curses.h> - int wresize(WINDOW *win, int lines, int columns); + int wresize(WINDOW *win, int lines, int columns); --
- The wresize function reallocates storage for an ncurses - window to adjust its dimensions to the specified values. - If either dimension is larger than the current values, the - window's data is filled with blanks that have the current - background rendition (as set by wbkgndset) merged into - them. +
+ This ncurses extension to standard curses reallocates storage for a + curses window to adjust its dimensions to the specified values. If + either dimension is larger than its current value, the expanded part of + the window is filled with blanks merged with current background + rendition (as set by wbkgdset(3x)). --
- The function returns the integer ERR upon failure and OK - on success. It will fail if either of the dimensions less - than or equal to zero, or if an error occurs while - (re)allocating memory for the window. +
+ wresize returns ERR upon failure and OK on success. It will fail if + either of the dimensions is less than or equal to zero, or if an error + occurs while (re)allocating memory for the window. --
- The only restriction placed on the dimensions is that they - be greater than zero. The dimensions are not compared to - curses screen dimensions to simplify the logic of - resizeterm. The caller must ensure that the window's - dimensions fit within the actual screen dimensions. +
+ The only restriction placed on the dimensions is that they be greater + than zero. They are not compared to the curses screen dimensions; this + keeps the logic of resizeterm(3x) simple. The caller must ensure that + the window's dimensions fit within the actual screen dimensions. --
- resizeterm(3x). +
+ It is not possible to resize windows with SVr4 curses. + ncurses introduced this extension in mid-1995. NetBSD curses adopted + it in 2001, and PDCurses in 2003. --
- Thomas Dickey (from an equivalent function written in 1988 - for BSD curses). + +
+ Thomas Dickey (from an equivalent function written in 1988 for BSD + curses). + + +
+ resizeterm(3x) - wresize(3x) +ncurses 6.5 2024-03-16 wresize(3x)-