Functions that accept window/screen coordinates use a "row, column" format.
-
clearok(< Boolean >clearOnRefresh) - Result - If redraw is true, the next call to refresh() will clear the screen completely and redraw the entire screen from scratch.
-
scrollok(< Boolean >scroll) - Result - Controls what happens when the cursor of a window is moved off the edge of the window or scrolling region, either as a result of a newline action on the bottom line, or typing the last character of the last row. If scroll is true, the window is scrolled up one line (Note: that in order to get the physical scrolling effect on the terminal, it is also necessary to call idlok()), otherwise the cursor is left at the bottom line.
-
idlok(< Boolean >useInsDelLine) - Result - If useInsDelTerm is true, ncurses considers using the hardware insert/delete line feature of the terminal (if available). Otherwise if useInsDelTerm is false, hardware line insertion and deletion is disabled. This option should be enabled only if the application needs insert/delete line, for example, for a screen editor. It is disabled by default because insert/delete line tends to be visually annoying when used in applications where it isn't really needed. If insert/delete line cannot be used, ncurses redraws the changed portions of all lines.
-
idcok(< Boolean >useInsDelChar) - Result - If useInsDelChar is true, ncurses considers using the hardware insert/delete character feature of the terminal (if available). Otherwise if useInsDelChar is false, ncurses no longer considers using the hardware insert/delete character feature of the terminal. Use of character insert/delete is enabled by default.
-
leaveok(< Boolean >moveCursor) - Result - Normally, the hardware cursor is left at the location of the window cursor being refreshed. If moveCursor is true, ncurses will allow the cursor to be left wherever an update happens to leave it. It is useful for applications where the cursor is not used, since it reduces the need for cursor motions. If possible, the cursor is made invisible when this function is called.
-
immedok(< Boolean >immedUpdate) - Result - If immedUpdate is true, any change in the virtual window, such as the ones caused by addch(), clrtobot(), scroll(), etc., automatically cause a call to refresh(). However, it may degrade performance considerably, due to repeated calls to refresh(). It is disabled by default.
-
standout(< Boolean >enable) - Result - If enable is true, the standout Attribute is enabled. Otherwise, it is disabled.
-
syncok(< Boolean >autoSyncUp) - Result - If autoSyncUp is true, syncup() is automatically called whenever there is a change in this window.
-
syncdown() - Result - Touches each location in the window that has been touched in any of its ancestor windows. This function is called by refresh(), so it should almost never be necessary to call it manually.
-
syncup() - Result - Touches all locations in ancestors of this window that are changed in this window.
-
cursyncup() - Result - Updates the current cursor position of all the ancestors of the window to reflect the current cursor position of the window.
-
hide() - (void) - Hides the window.
-
show() - (void) - Un-hides the window.
-
top() - (void) - Bring the window to the front.
-
bottom() - (void) - Send the window to the back (stdscr is always the bottom-most window, so this function will actually make the window the bottom-most window right above stdscr).
-
move(< Integer >row, < Integer >column) - (void) - Moves the window to the given row and column.
-
refresh() - Result - Update the physical screen to match that of the virtual screen.
-
frame([< String >header[, < String >footer]]) - (void) - Draws a frame around the window and calls label() with the optional arguments.
-
boldframe([< String >header[, < String >footer]]) - (void) - Same as frame(), except the frame is highlighted.
-
label([< String >header[, < String >footer]]) - (void) - Displays an optional centered header at the top and an optional centered footer at the bottom of the window.
-
centertext(< Integer >row, < String >text) - (void) - Display a centered string at the given row.
-
cursor(< Integer >row, < Integer >column) - Result - Moves the cursor to the given row and column.
-
insertln() - Result - Inserts an empty row above the current row.
-
insdelln([< Integer >nRows=1]) - Result - If nRows > 0, then nRows rows will be inserted above the current row. If nRows < 0, then nRows rows are deleted, beginning with the current row.
-
insstr(< String >text[, < Integer >charLimit=-1]) - Result - Insert the string into the window before the current cursor position. Insert stops at the end of the string or when charLimit has been reached. If charLimit < 0, it is ignored.
-
insstr(< Integer >row, < Integer >column, < String >text[, < Integer >charLimit=-1]) - Result - Moves the cursor to the given row and column, then calls the above version of insstr() with the rest of the arguments.
-
attron(< Attributes >attrs) - Result - Switch on the specified window attributes.
-
attroff(< Attributes >attrs) - Result - Switch off the specified window attributes.
-
attrset(< Attributes >attrs) - Result - Sets the window's attributes to be exactly that of the attributes specified.
-
attrget() - Attributes - Get the window's current set of attributes.
-
chgat(< Integer >nChars, < Attributes >attrs[, < Integer >colorPair]) - Result - Changes the attributes of the next nChars characters starting at the current cursor position to have the given attributes. colorPair specifies a color to use (defaults to the Window's current color pair).
-
chgat(< Integer >row, < Integer >column, < Integer >nChars, < Attributes >attrs[, < Integer >colorPair]) - Result - Same as the above, except the given row and column are used as the start position.
-
box([<ACS_Character>vertChar=0[, <ACS_Character>horizChar=0]]) - Result - Draws a box around the window using the optional vertical and horizontal characters. If a zero is given for any of the arguments, ncurses will use the POSIX default characters instead (See Additional notes).
-
border([<ACS_Character>leftChar=0[, <ACS_Character>rightChar=0[, <ACS_Character>topChar=0[, <ACS_Character>bottomChar=0[, <ACS_Character>topLeftChar=0[, <ACS_Character>topRightChar=0[, <ACS_Character>bottomLeftChar=0[, <ACS_Character>bottomRightChar=0]]]]]]]]) - Result - Draws a border around the window using the optionally specified left, right, top, bottom, top left, top right, bottom left, bottom right characters. If any of the characters are zero, ncurses will use the POSIX default characters instead (See Additional notes).
-
hline(< Integer >length[, <ACS_Character>lineChar=0]) - Result - Draws a horizontal line on the current row with the given length. lineChar specifies the character to be used when drawing the line. If lineChar is zero, ncurses will use the POSIX default characters instead (See Additional notes).
-
vline(< Integer >length[, <ACS_Character>lineChar=0]) - Result - Draws a vertical line on the current column with the given length. lineChar specifies the character to be used when drawing the line. If lineChar is zero, ncurses will use the POSIX default characters instead (See Additional notes).
-
erase() - Result - Copies blanks to every position in the window, clearing the screen.
-
clear() - Result - Similar to erase(), but it also calls clearok(true), so that the screen is cleared completely on the next call to refresh() for the window and is repainted from scratch.
-
clrtobot() - Result - Clears to the end of the window.
-
clrtoeol() - Result - Clears to the end of the current row.
-
delch() - Result - Deletes the character under the cursor.
-
delch(< Integer >row, < Integer >column) - Result - Moves the cursor to the given row and column and then deletes the character under the cursor.
-
deleteln() - Result - Deletes the current row.
-
scroll([< Integer >nLines=1]) - Result - Scrolls nLines lines. Positive values scroll up and negative values scroll down.
-
setscrreg(< Integer >startRow, < Integer >endRow) - Result - Sets the scrolling region of a window bounded by startRow and endRow (both inclusive).
-
touchlines(< Integer >startRow, < Integer >nRows[, < Boolean >markModified=true]) - Result - Marks nRows rows starting at startRow as having been modified if markModified is true or unmodified otherwise.
-
is_linetouched(< Integer >row) - Boolean - Indicates whether row has been marked as modified.
-
redrawln(< Integer >startRow, < Integer >nRows) - Result - Redraws nRows rows starting at startRow.
-
touch() - Result - Marks the entire window as having been modified.
-
untouch() - Result - Marks the entire window as having been unmodified.
-
resize(< Integer >rows, < Integer >columns) - Result - Resizes the window to have the given number of rows and columns.
-
print(< String >text) - Result - Writes text at the current cursor position.
-
print(< Integer >row, < Integer >column, < String >text) - Result - Moves the cursor to the given row and column and writes text.
-
addstr(< String >text[, < Integer >charLimit=-1]) - Result - Writes the specified string at the current cursor position. Writing stops at the end of the string or when charLimit has been reached. If charLimit < 0, it is ignored.
-
addstr(< Integer >row, < Integer >column, < String >text[, < Integer >charLimit=-1]) - Result - Moves the cursor to the given row and column and calls the version of addstr() above with the rest of the arguments.
-
close() - Result - Destroys the window and any of its children. Only call this once and when you are completely finished with the window.
A resize operation in X sends SIGWINCH to the running application. The ncurses library does not catch this signal, because it cannot in general know how you want the screen re-painted. You will have to write the SIGWINCH handler yourself.
Keys prefixed with 'S_' denote SHIFT + the key.