X-Git-Url: http://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_border_set.3x.html;h=9c1f8459146b78d4d44d2c040184b32009ad9a29;hp=1e93b1f9956d6bf58c7f0778e86a6522ccef0e86;hb=HEAD;hpb=a8987e73ec254703634802b4f7ee30d3a485524d diff --git a/doc/html/man/curs_border_set.3x.html b/doc/html/man/curs_border_set.3x.html index 1e93b1f9..77e10da1 100644 --- a/doc/html/man/curs_border_set.3x.html +++ b/doc/html/man/curs_border_set.3x.html @@ -1,7 +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, @@ -116,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, @@ -127,50 +123,59 @@ 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, +
+ Upon successful completion, these functions return OK. Otherwise, they + return ERR. + + Functions using a window parameter return an error if it is null. + + Functions prefixed with "mv" first perform cursor movement and fail if + the position (y, x) is outside the window boundaries. + + +
+ 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. +
+ These functions are described in X/Open Curses, Issue 4. --
- ncurses(3x), curs_border(3x), curs_outopts(3x) +
+ curses(3x), curs_add_wch(3x), curs_border(3x), curs_outopts(3x) - curs_border_set(3x) +ncurses 6.4 2024-04-20 curs_border_set(3x)-