X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fresizeterm.3x.html;h=b28f64263fc36083dd5b44cf6bd25b82b79e6b90;hp=712dee101e660535121587e5d9374643759159d9;hb=761e4f0825b330e970558e82a4bd638383914429;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34 diff --git a/doc/html/man/resizeterm.3x.html b/doc/html/man/resizeterm.3x.html index 712dee10..b28f6426 100644 --- a/doc/html/man/resizeterm.3x.html +++ b/doc/html/man/resizeterm.3x.html @@ -1,66 +1,124 @@ + + +
++resizeterm(3x) resizeterm(3x) + + +
- resizeterm - change the curses terminal size + is_term_resized, resize_term, resizeterm - change the + curses terminal size
- #include <curses.h> + #include <curses.h> - int resizeterm(int lines, int columns); + bool is_term_resized(int lines, int columns); + int resize_term(int lines, int columns); + int resizeterm(int lines, int columns);
- This is an extension to the curses library. It provides - callers with a hook into the ncurses data to resize win- + This is an extension to the curses library. It provides + callers with a hook into the ncurses data to resize win- dows, primarily for use by programs running in an X Window - terminal (e.g., xterm). The function resizeterm resizes - the standard and current windows to the specified dimen- - sions, 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 - application. + terminal (e.g., xterm). The function resizeterm resizes + the standard and current windows to the specified dimen- + sions, and adjusts other bookkeeping data used by the + ncurses library that record the window dimensions. + + Most of the work is done by the inner function + resize_term. The outer function resizeterm adds bookkeep- + ing for the SIGWINCH handler. When resizing the windows, + resize_term blank-fills the areas that are extended. The + calling application should fill in these areas with appro- + priate data. The resize_term function attempts to resize + all windows. However, due to the calling convention of + pads, it is not possible to resize these without addi- + tional interaction with the application. + + A support function is_term_resized is provided so that + applications can check if the resize_term function would + modify the window structures. It returns TRUE if the win- + dows would be modified, and FALSE otherwise.
- 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. + Except as notes, these function return the integer ERR + upon failure and OK on success. They will fail if either + of the dimensions are less than or equal to zero, or if an + error occurs while (re)allocating memory for the windows.
- While this function is intended to be used to support a - signal 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 han- - dler, the resizeterm function ungetch's a KEY_RESIZE which - will be read on the next call to getch. This is used to + While these functions are intended to be used to support a + signal handler (i.e., for SIGWINCH), care should be taken + to avoid invoking them in a context where malloc or real- + loc may have been interrupted, since it uses those func- + tions. + + If ncurses is configured to supply its own SIGWINCH han- + dler, 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 + that it should repaint special features such as pads that cannot be done automatically. + If the environment variables LINES or COLUMNS are set, + this overrides the library's use of the window size + obtained from the operating system. Thus, even if a SIG- + WINCH is received, no screen size change may be recorded. +
- wresize(3x). + curs_variables(3x), wresize(3x).@@ -70,6 +128,7 @@ + resizeterm(3x)