X-Git-Url: https://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_border.3x.html;h=10a1b76c89138d2fc22ea00a467f348fdbac9223;hb=74433bcf4f6fe40862a28f3c00edaedcd5054b01;hp=44f6e43510d428c2b183ac131400c4dbeafd8092;hpb=b1f61d9f3aa244512045a6b02e759825d7049d34;p=ncurses.git diff --git a/doc/html/man/curs_border.3x.html b/doc/html/man/curs_border.3x.html index 44f6e435..10a1b76c 100644 --- a/doc/html/man/curs_border.3x.html +++ b/doc/html/man/curs_border.3x.html @@ -1,135 +1,161 @@ + + +
+ + +- - --
- border, wborder, box, hline, whline, vline, wvline, mvh- - line, mvwhline, mvvline, mvwvline - create curses borders, - horizontal and vertical lines - - --
- #include <curses.h> - int border(chtype ls, chtype rs, chtype ts, chtype bs, - chtype tl, chtype tr, chtype bl, chtype br); - int wborder(WINDOW *win, chtype ls, chtype rs, - chtype ts, chtype bs, chtype tl, chtype tr, - chtype bl, chtype br); - int box(WINDOW *win, chtype verch, chtype horch); - int hline(chtype ch, int n); - int whline(WINDOW *win, chtype ch, int n); - int vline(chtype ch, int n); - int wvline(WINDOW *win, chtype ch, int n); - mvhline(int y, int x, chtype ch, int n); - mvwhline(WINDOW *, int y, int x, chtype ch, int n); - int mvvline(int y, int x, chtype ch, int n); - int mvwvline(WINDOW *, int y, int x, chtype ch, int n); - - --
- The border, wborder and box routines draw a box around the - edges of a 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.h) are used instead: ACS_VLINE, - ACS_VLINE, ACS_HLINE, ACS_HLINE, ACS_ULCORNER, - ACS_URCORNER, ACS_LLCORNER, ACS_LRCORNER. - - box(win, verch, horch) is a shorthand for the following - call: wborder(win, verch, verch, horch, horch, 0, 0, 0, - 0). - - The hline and whline functions draw a horizontal (left to - right) line using ch starting at the current cursor posi- - tion in the window. The current cursor position is not - changed. The line is at most n characters long, or as - many as fit into the window. - - The vline and wvline functions draw a vertical (top to - bottom) line using ch starting at the current cursor posi- - tion in the window. The current cursor position is not - changed. The line is at most n characters long, or as - many as fit into the window. - - --
- All routines return the integer OK. The SVr4.0 manual - says "or a non-negative integer if immedok is set", but - this appears to be an error. - - --
- The borders generated by these functions are inside bor- - ders (this is also true of SVr4 curses, though the fact is - not documented). - - Note that border and box may be macros. - - --
- These functions are described in the XSI Curses standard, - Issue 4. Additional functions mvhline, mvvline, mvwhline, - and mvwvline are described there which this implementation - does not yet support. The standard specifies that they - return ERR on failure, but specifies no error conditions. - - --
- curses(3x), curs_outopts(3x). - - - - - - +curs_border(3x) curs_border(3x) +
+ border, wborder, box, hline, whline, vline, wvline, mvhline, mvwhline, + mvvline, mvwvline - create curses borders, horizontal and vertical + lines +
+ #include <curses.h> + int border(chtype ls, chtype rs, chtype ts, chtype bs, + chtype tl, chtype tr, chtype bl, chtype br); + int wborder(WINDOW *win, chtype ls, chtype rs, + chtype ts, chtype bs, chtype tl, chtype tr, + chtype bl, chtype br); + int box(WINDOW *win, chtype verch, chtype horch); + int hline(chtype ch, int n); + int whline(WINDOW *win, chtype ch, int n); + int vline(chtype ch, int n); + int wvline(WINDOW *win, chtype ch, int n); + int mvhline(int y, int x, chtype ch, int n); + int mvwhline(WINDOW *win, int y, int x, chtype ch, int n); + int mvvline(int y, int x, chtype ch, int n); + int mvwvline(WINDOW *win, int y, int x, chtype ch, int n); +
+ The border, wborder and box routines draw a box around the edges of a + window. Other than the window, each argument is a character with at- + tributes: + ls - left side, + 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 corresponding default val- + ues (defined in curses.h) are used instead: + ACS_VLINE, + ACS_VLINE, + ACS_HLINE, + ACS_HLINE, + ACS_ULCORNER, + ACS_URCORNER, + ACS_LLCORNER, + ACS_LRCORNER. + box(win, verch, horch) is a shorthand for the following call: wbor- + der(win, verch, verch, horch, horch, 0, 0, 0, 0). + The hline and whline functions draw a horizontal (left to right) line + using ch starting at the current cursor position in the window. The + current cursor position is not changed. The line is at most n charac- + ters long, or as many as fit into the window. + The vline and wvline functions draw a vertical (top to bottom) line us- + ing ch starting at the current cursor position in the window. The cur- + rent cursor position is not changed. The line is at most n characters + long, or as many as fit into the window. +
+ All routines return the integer OK. The SVr4.0 manual says "or a non- + negative integer if immedok is set", but this appears to be an error. + X/Open does not define any error conditions. This implementation re- + turns an error if the window pointer is null. + Functions with a "mv" prefix first perform a cursor movement using + wmove, and return an error if the position is outside the window, or if + the window pointer is null. +
+ The borders generated by these functions are inside borders (this is + also true of SVr4 curses, though the fact is not documented). + Note that border and box may be macros. +
+ These functions are described in the XSI Curses standard, Issue 4. The + standard specifies that they return ERR on failure, but specifies no + error conditions. +
+ curses(3x), curs_outopts(3x). + curs_border(3x)-