NAME
resizeterm - change the curses terminal size
SYNOPSIS
#include <curses.h>
int resizeterm(int lines, int columns);
DESCRIPTION
This is an extension to the curses library. It provides
callers with a hook into the ncurses data to resize windows,
primarily for use by programs running in an X Window termi-
nal (e.g., xterm). The function resizeterm resizes the
standard and current windows to the specified dimensions,
and adjusts other bookkeeping data used by the ncurses
library that record the window dimensions.
When resizing the windows, the function blank-fills the
areas that are extended. The calling application should fill
in these areas with appropriate data.
The function attempts to resize all windows. However, due
to the calling convention of pads, it is not possible to
resize these without additional interaction with the appli-
cation.
RETURN VALUE
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 windows.
NOTES
While this function is intended to be used to support a sig-
nal handler (i.e., for SIGWINCH), care should be taken to
avoid invoking it in a context where malloc or realloc may
have been interrupted, since it uses those functions.
If ncurses is configured to supply its own SIGWINCH handler,
the resizeterm function ungetch's a KEY_RESIZE which will be
read on the next call to getch. This is used to alert an
application that the screen size has changed, and that it
should repaint special features such as pads that cannot be
done automatically.
SEE ALSO
wresize(3X).
AUTHOR
Thomas Dickey (from an equivalent function written in 1988
for BSD curses).
|
Закладки на сайте Проследить за страницей |
Created 1996-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |