X-Git-Url: http://ncurses.scripts.mit.edu/?a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_border_set.3x.html;h=8d8a204b550c5035e4482b51d622c369d488173d;hb=bd2d9c5734d2c66abe0b2ddd766695b200c154fe;hp=151d5f9bd6b5efca65af1e867ab69e60cc843eae;hpb=c6cfd97b8beaf0f6deafbf8aac7281cf6aa7f012;p=ncurses.git diff --git a/doc/html/man/curs_border_set.3x.html b/doc/html/man/curs_border_set.3x.html index 151d5f9b..8d8a204b 100644 --- a/doc/html/man/curs_border_set.3x.html +++ b/doc/html/man/curs_border_set.3x.html @@ -1,6 +1,7 @@ -
- --curs_border_set(3x) curs_border_set(3x) +curs_border_set(3x) Library calls curs_border_set(3x) --
- border_set, wborder_set, box_set, hline_set, whline_set, - mvhline_set, mvwhline_set, vline_set, wvline_set, - mvvline_set, mvwvline_set - create curses borders or lines - using complex characters and renditions +
+ border_set, wborder_set, box_set, hline_set, whline_set, mvhline_set, + mvwhline_set, vline_set, wvline_set, mvvline_set, mvwvline_set - draw + borders and lines in a curses window of wide characters --
+
#include <curses.h> int border_set( - const cchar_t *ls, const cchar_t *rs, - const cchar_t *ts, const cchar_t *bs, - const cchar_t *tl, const cchar_t *tr, - const cchar_t *bl, const cchar_t *br ); + const cchar_t *ls, const cchar_t *rs, + const cchar_t *ts, const cchar_t *bs, + const cchar_t *tl, const cchar_t *tr, + const cchar_t *bl, const cchar_t *br); int wborder_set( - WINDOW *win, - const cchar_t *ls, const cchar_t *rs, - const cchar_t *ts, const cchar_t *bs, - const cchar_t *tl, const cchar_t *tr, - const cchar_t *bl, const cchar_t *br); + WINDOW *win, + const cchar_t *ls, const cchar_t *rs, + const cchar_t *ts, const cchar_t *bs, + const cchar_t *tl, const cchar_t *tr, + const cchar_t *bl, const cchar_t *br); int box_set( - WINDOW *win, - const cchar_t *verch, + WINDOW *win, + const cchar_t *verch, const cchar_t *horch); int hline_set( - const cchar_t *wch, int n); + const cchar_t *wch, int n); int whline_set( - WINDOW *win, - const cchar_t *wch, int n); + WINDOW *win, + const cchar_t *wch, int n); int mvhline_set( - int y, int x, - const cchar_t *wch, int n); + int y, int x, + const cchar_t *wch, int n); int mvwhline_set( - WINDOW *win, - int y, int x, - const cchar_t *wch, int n); + WINDOW *win, + int y, int x, + const cchar_t *wch, int n); int vline_set( - const cchar_t *wch, int n); + const cchar_t *wch, int n); int wvline_set( - WINDOW *win, - const cchar_t *wch, int n); + WINDOW *win, + const cchar_t *wch, int n); int mvvline_set( - int y, int x, - const cchar_t *wch, int n); + int y, int x, + const cchar_t *wch, int n); int mvwvline_set( - WINDOW *win, - int y, int x, - const cchar_t *wch, int n); + WINDOW *win, + int y, int x, + const cchar_t *wch, int n); --
- The border_set and wborder_set functions draw a border - around the edges of the current or specified window. - These functions do not change the cursor position, and do - not wrap. - - Other than the window, each argument is a complex charac- - ter with attributes: +
+ The border_set and wborder_set functions draw a border around the edges + of the current or specified window. These functions do not change the + cursor position, and do not wrap. + + Other than the window, each argument is a complex character with + attributes: ls - left side, rs - right side, ts - top side, @@ -117,8 +112,8 @@ bl - bottom left-hand corner, and br - bottom right-hand corner. - If any of these arguments is zero, then the corresponding - default values (defined in curses.h) are used instead: + If any of these arguments is zero, then the corresponding default + values (defined in curses.h) are used instead: WACS_VLINE, WACS_VLINE, WACS_HLINE, @@ -128,61 +123,58 @@ WACS_LLCORNER, and WACS_LRCORNER. - box_set(win, verch, horch); is a shorthand for the follow- - ing call: + box_set(win, verch, horch); is a shorthand for the following call: wborder_set(win, verch, verch, horch, horch, NULL, NULL, NULL, NULL); - The *line_set functions use wch to draw a line starting at - the current cursor position in the window. The line is at - most n characters long or as many as fit into the window. - The current cursor position is not changed. + The *line_set functions use wch to draw a line starting at the current + cursor position in the window. The line is at most n characters long + or as many as fit into the window. The current cursor position is not + changed. - The hline_set, mvhline_set, mvwhline_set, and whline_set - functions draw a line proceeding toward the last column of - the same line. + The hline_set, mvhline_set, mvwhline_set, and whline_set functions draw + a line proceeding toward the last column of the same line. - The vline_set, mvvline_set, mvwvline_set, and wvline_set - functions draw a line proceeding toward the last line of - the window. + The vline_set, mvvline_set, mvwvline_set, and wvline_set functions draw + a line proceeding toward the last line of the window. --
- Note that border_set, hline_set, mvhline_set, mvvline_set, - mvwhline_set, mvwvline_set, and vline_set may be macros. +
+ Upon successful completion, these functions return OK. Otherwise, they + return ERR. + Functions using a window parameter return an error if it 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. --
- Upon successful completion, these functions return OK. - Otherwise, they return ERR. - Functions using a window parameter return an error if it - is null. +
+ Note that border_set, hline_set, mvhline_set, mvvline_set, + mvwhline_set, mvwvline_set, and vline_set may be macros. - Functions with a "mv" prefix first perform a cursor move- - ment using wmove, and return an error if the position is - outside the window, or if the window pointer is null. +
+ These functions are described in the XSI Curses standard, Issue 4. --
- ncurses(3x), curs_add_wch(3x), curs_border(3x), curs_out- - opts(3x) +
+ curses(3x), curs_add_wch(3x), curs_border(3x), curs_outopts(3x) - curs_border_set(3x) + +ncurses 6.4 2023-11-25 curs_border_set(3x)