mirror of
https://github.com/Aigor44/ncursesw-morphos.git
synced 2024-12-21 07:39:06 +08:00
61 lines
2.8 KiB
Plaintext
61 lines
2.8 KiB
Plaintext
.\"*****************************************************************************
|
|
.\" Copyright 1996 by Thomas E. Dickey <dickey@clark.net> *
|
|
.\" All Rights Reserved. *
|
|
.\" *
|
|
.\" Permission to use, copy, modify, and distribute this software and its *
|
|
.\" documentation for any purpose and without fee is hereby granted, provided *
|
|
.\" that the above copyright notice appear in all copies and that both that *
|
|
.\" copyright notice and this permission notice appear in supporting *
|
|
.\" documentation, and that the name of the above listed copyright holder(s) *
|
|
.\" not be used in advertising or publicity pertaining to distribution of the *
|
|
.\" software without specific, written prior permission. THE ABOVE LISTED *
|
|
.\" COPYRIGHT HOLDER(S) DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, *
|
|
.\" INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO *
|
|
.\" EVENT SHALL THE ABOVE LISTED COPYRIGHT HOLDER(S) BE LIABLE FOR ANY *
|
|
.\" SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER *
|
|
.\" RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF *
|
|
.\" CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN *
|
|
.\" CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. *
|
|
.\"*****************************************************************************
|
|
.\" $Id: wresize.3x,v 1.2 1996/09/07 14:51:04 tom Exp $
|
|
.TH wresize 3X ""
|
|
.
|
|
.SH NAME
|
|
\fBwresize\fR - resize a curses window
|
|
.
|
|
.SH SYNOPSIS
|
|
\fB#include <curses.h>\fR
|
|
|
|
\fBint wresize(WINDOW *win, int lines, int columns);\fR
|
|
.
|
|
.SH DESCRIPTION
|
|
The \fBwresize\fR function reallocates storage for an \fBncurses\fR
|
|
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 \fBwbkgndset\fR) merged into them.
|
|
.
|
|
.SH RETURN VALUE
|
|
The function returns the integer \fBERR\fR upon failure and \fBOK\fR 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.
|
|
.
|
|
.SH NOTES
|
|
The only restriction placed on the dimensions is that they be greater than zero.
|
|
The dimensions are not compared to \fBcurses\fR screen dimensions to
|
|
simplify the logic of \fBresizeterm\fR.
|
|
The caller must ensure that the window's dimensions fit within the
|
|
actual screen dimensions.
|
|
.
|
|
.SH SEE ALSO
|
|
\fBresizeterm\fR(3x).
|
|
.
|
|
.SH AUTHOR
|
|
Thomas Dickey (from an equivalent function written in 1988 for BSD curses).
|
|
.\"#
|
|
.\"# The following sets edit modes for GNU EMACS
|
|
.\"# Local Variables:
|
|
.\"# mode:nroff
|
|
.\"# fill-column:79
|
|
.\"# End:
|