1997-05-15 12:00:00 +08:00
|
|
|
<HTML>
|
1999-10-24 12:32:42 +08:00
|
|
|
<BODY>
|
1997-05-15 12:00:00 +08:00
|
|
|
<PRE>
|
|
|
|
|
<STRONG>wresize</STRONG> - resize a curses window
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>SYNOPSIS</H2><PRE>
|
1999-10-24 12:32:42 +08:00
|
|
|
<STRONG>#include</STRONG> <STRONG><curses.h></STRONG>
|
1997-05-15 12:00:00 +08:00
|
|
|
|
|
|
|
|
<STRONG>int</STRONG> <STRONG>wresize(WINDOW</STRONG> <STRONG>*win,</STRONG> <STRONG>int</STRONG> <STRONG>lines,</STRONG> <STRONG>int</STRONG> <STRONG>columns);</STRONG>
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>DESCRIPTION</H2><PRE>
|
|
|
|
|
The <STRONG>wresize</STRONG> function reallocates storage for an <STRONG>ncurses</STRONG>
|
|
|
|
|
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 <STRONG>wbkgndset</STRONG>) merged into
|
|
|
|
|
them.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>RETURN VALUE</H2><PRE>
|
|
|
|
|
The function returns the integer <STRONG>ERR</STRONG> upon failure and <STRONG>OK</STRONG>
|
|
|
|
|
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.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>NOTES</H2><PRE>
|
|
|
|
|
The only restriction placed on the dimensions is that they
|
|
|
|
|
be greater than zero. The dimensions are not compared to
|
|
|
|
|
<STRONG>curses</STRONG> screen dimensions to simplify the logic of
|
|
|
|
|
<STRONG>resizeterm</STRONG>. The caller must ensure that the window's
|
|
|
|
|
dimensions fit within the actual screen dimensions.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>SEE ALSO</H2><PRE>
|
1998-03-01 12:21:12 +08:00
|
|
|
<STRONG><A HREF="resizeterm.3x.html">resizeterm(3X)</A></STRONG>.
|
1997-05-15 12:00:00 +08:00
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
<H2>AUTHOR</H2><PRE>
|
|
|
|
|
Thomas Dickey (from an equivalent function written in 1988
|
|
|
|
|
for BSD curses).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</PRE>
|
|
|
|
|
</BODY>
|
|
|
|
|
</HTML>
|
