|
curs_border(3x) -- create curses borders, horizontal and vertical lines
|
With the border, wborder and box routines, a border is drawn around the edges of the window. The argument ls is a character and attributes used for the left side of the border, rs - right side, ts - top side, bs - bottom side, tl - top left-hand corner, tr - top right-hand corner, bl - bottom left-hand corner, and br - bottom right-hand corner. If any of these arguments is zero, then the following default values (defined in curses... |
curs_clear(3x) -- clear all or part of a curses window
|
The erase and werase routines copy blanks to every position in the window. The clear and wclear routines are like erase and werase, but they also call clearok, so that the screen is cleared completely on the next call to wrefresh for that window and repainted from scratch. The clrtobot and wclrtobot rout... |
|
curs_color(3x) -- curses color manipulation routines
|
Overview curses provides routines that manipulate color on color alphanumeric terminals. To use these routines start_color must be called, usually right after initscr. Colors are always used in pairs (referred to as color-pairs). A color-pair consists of a foreground color (for characters) and a background color (for the field on which the characters are displayed). A programmer initializes a color-pair with the routine i... |
curs_delch(3x) -- delete character under cursor in a curses window
|
With these routines the character under the cursor in the window is deleted; all characters to the right of the cursor on the same line are moved to the left one position and the last character on the line is filled with a blank. The cursor position does not change (after moving to y, x, if specified). (This does not imply use of the hardware delete character feature.) |
curs_delln(3x) -- delete and insert lines in a curses window
|
With the deleteln and wdeleteln routines, the line under the cursor in the window is deleted; all lines below the current line are moved up one line. The bottom line of the window is cleared. The cursor position does not change. (This does not imply use of a hardware delete line feature.) With the insdelln and winsdelln routines, for positive n, insert n lines into the specified window above the... |
curs_getch(3x) -- get (or push back) characters from curses terminal keyboard
|
The getch, wgetch, mvgetch, and mvwgetch routines read a character from the terminal associated with the window. In no-delay mode, if no input is waiting, the value ERR is returned. In delay mode, the program waits until the system passes text through to the program. Depending on the setting of cbreak, this is after one character (cbreak mode), or after the first newline ( |
curs_getstr(3x) -- get character strings from curses terminal keyboard
|
The effect of getstr is as though a series of calls to getch were made, until a newline and carriage return is received. The resulting value is placed in the area pointed to by the character pointer str. wgetnstr reads at most n characters, thus preventing a possible overflow of the input buffer. The user's erase and kill characters are interpreted, as well as any special keys (such as function keys, ``home'' key, ``clear'' key, and s... |
curs_getwch(3x) -- get (or push back) wchar_t characters from curses terminal keyboard
|
The getwch, wgetwch, mvgetwch, and mvwgetwch routines read an EUC character from the terminal associated with the window, transform it into a wchar_t character, and return a wchar_t character. In no-delay mode, if no input is waiting, the value ERR is returned. In delay mode, the program waits until the system passes text through to the program. Depending on the ... |
curs_getwstr(3x) -- get wchar_t character strings from curses terminal keyboard
|
The effect of getwstr is as though a series of calls to getwch were made, until a newline and carriage return is received. The resulting value is placed in the area pointed to by the wchar_t pointer str. getnwstr reads at most n wchar_t characters, thus preventing a possible overflow of the input buffer. The user's erase and kill characters are interpreted, as well as any special keys (such as fun... |
curs_getyx(3x) -- get curses cursor and window coordinates
|
With the getyx macro, the cursor position of the window is placed in the two integer variables y and x. With the getparyx macro, if win is a subwindow, the beginning coordinates of the subwindow relative to the parent window are placed into two integer variables, y and x. Otherwise, -1 is placed into y and x. Like getyx, the getbegyx and getmaxyx macros store the current beginning coordina... |
curs_inch(3x) -- get a character and its attributes from a curses window
|
These routines return the character, of type chtype, at the current position in the named window. If any attributes are set for that position, their values are OR-ed into the value returned. Constants defined in curses.h can be used with the & (logical AND) operator to extract the character or attributes alone. |
curs_inchstr(3x) -- get a string of characters (and attributes) from a curses window
|
These routines return a string of type chtype, starting at the current cursor position in the named window and ending at the right margin of the window. The four functions with n as the last argument, return the string at most n characters long. Constants defined in curses.h can be used with the & (logical AND) operator to extract the character or the attribute alone from any position in the chstr [see curs_inch(3X)].... |
curs_initscr(3x) -- curses screen initialization and manipulation routines
|
initscr is almost always the first routine that should be called (the exceptions are slk_init, filter, ripoffline, use_env and, for multipleterminal applications, newterm.) This determines the terminal type and initializes all curses data structures. initscr also causes the first call to refresh to clear the s... |
curs_inopts(3x) -- curses terminal input option control routines
|
The cbreak and nocbreak routines put the terminal into and out of cbreak mode, respectively. In this mode, characters typed by the user are immediately available to the program, and erase/kill character-processing is not performed. When out of this mode, the tty driver buffers the typed characters until a newline or carriage return is typed. Interrupt and flow control characters are unaffected by this mode. Initially the terminal may or... |
curs_insch(3x) -- insert a character before the character under the cursor in a curses window
|
These routines insert the character ch before the character under the cursor. All characters to the right of the cursor are moved one space to the right, with the possibility of the rightmost character on the line being lost. The cursor position does not change (after moving to y, x, if specified). (This does not imply use of the hardware insert character feature.) |