curs_border_set(3X) | 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 -複合文字と表現 (renditions) を使用して curses のボーダまたは行を作成する書式
#include <curses.h>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 );
WINDOW *win,
const cchar_t * verch,
const cchar_t * horch );
const cchar_t * wch, int n );
WINDOW * win,
const cchar_t * wch, int n );
int y, int x,
const cchar_t * wch, int n );
WINDOW * win,
int y, int x,
const cchar_t * wch, int n );
const cchar_t * wch, int n );
WINDOW * win,
const cchar_t * wch, int n );
int y, int x,
const cchar_t * wch, int n );
WINDOW * win,
int y, int x,
const cchar_t * wch, int n );
解説
border_set と wborder_set 関数は、現在の、または、指定されたウィンドウのエッジ (端) の周りにボーダを描画します。これらの関数は、カーソル位置を変更せず、折り返しもしません。
ウィンドウ以外の各引数は属性がある複合文字です:
ls - 左側
rs - 右側
ts - 上側
bs - 下側
tl - 左上側の角
tr - 右上側の角
bl - 左下側の角
br - 右下側の角
これらの引数のいずれかが 0 であるなら、対応するデフォルト値 ( curses.h で定義) が代わりに使用されます:
WACS_VLINE,
WACS_VLINE,
WACS_HLINE,
WACS_HLINE,
WACS_ULCORNER,
WACS_URCORNER,
WACS_LLCORNER と
WACS_LRCORNER。
box_set(win, verch, horch); は、次の呼び出しのための省略表現です:
wborder_set(win, verch, verch,
horch, horch, NULL, NULL, NULL, NULL);
*line_set 関数は、ウィンドウの現在のカーソル位置から始まる線を描画するために wch を使用します。線は、長くても n 文字、またはウィンドウに適合するだけの長さです。現在のカーソル位置をは、変更されません。
hline_set, mvhline_set, mvwhline_set と whline_set 関数は、同じ行の最後のカラムに向かって進む線を描画します。
vline_set, mvvline_set, mvwvline_set と wvline_set 関数は、ウィンドウの最後の行に向かって進む線を描画します。
注
border_set, hline_set, mvhline_set, mvvline_set, mvwhline_set, mvwvline_set と vline_set は、マクロであるかもしれないことに注意してください。戻り値
成功して終了すれば、これらの関数は OK を返します。そうでなければ、それらは ERR を返します。ウィンドウのパラメータを使用する関数は、それが null であるなら、エラーを返します。