Index of Section 3 Manual Pages
| Interix / SUA | curs_resize.3 | Interix / SUA |
curs_resize(3) curs_resize(3)
wresize()
NAME
wresize() - resize a curses window
SYNOPSIS
#include
int wresize(WINDOW *win, int lines, int columns);
DESCRIPTION
The wresize(3) function adjusts the dimensions of an ncurses window to the
specified values, reallocating storage as necessary.
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. If the current cursor position is
outside the retained area of the window, the cursor is moved to within the
nearest window edge. Window data is otherwise preserved.
This function will fail if either of the new dimensions less than or equal
to zero, or if memory cannot be allocated or reallocated for the window.
Note that wresize(3) performs non-reentrant malloc() operations, so it
isn't advisable to resize from within an interrupt handler. Instead, have
your handler set an event flag to be interpreted next time around your
program's command loop.
PORTABILITY
This call was designed for ncurses and is not found in SVr4 curses, 4.4BSD
curses, or any other previous version of curses. It is recommended that
you conditionalize all code depending on it with the symbol NCURSES.
RETURN VALUE
The function returns the integer ERR upon failure and OK on success.