Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
resizeterm(3X)							resizeterm(3X)

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 pro-
       grams  running in an X Window terminal (e.g., xterm).  The function re-
       sizeterm	resizes	the standard and current windows to the	specified  di-
       mensions,  and  adjusts	other bookkeeping data used by the ncurses li-
       brary 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 ap-
       propriate data.

       The function attempts to	resize all windows.  However, due to the call-
       ing  convention of pads,	it is not possible to resize these without ad-
       ditional	interaction with the application.

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 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 handler, the re-
       sizeterm	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).

								resizeterm(3X)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | NOTES | SEE ALSO | AUTHOR

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=resizeterm&sektion=3x&manpath=FreeBSD+4.9-RELEASE>

home | help