EN JA
curs_border_set(3X)
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>
 
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 );
 
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 );
 
int box_set(
WINDOW *win,
const cchar_t * verch,
const cchar_t * horch );
 
int hline_set(
const cchar_t * wch, int n );
 
int whline_set(
WINDOW * win,
const cchar_t * wch, int n );
 
int mvhline_set(
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 );
 
int vline_set(
const cchar_t * wch, int n );
 
int wvline_set(
WINDOW * win,
const cchar_t * wch, int n );
 
int mvvline_set(
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 );
 

解説

border_setwborder_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_setwhline_set 関数は、同じ行の最後のカラムに向かって進む線を描画します。

vline_set, mvvline_set, mvwvline_setwvline_set 関数は、ウィンドウの最後の行に向かって進む線を描画します。

 

border_set, hline_set, mvhline_set, mvvline_set, mvwhline_set, mvwvline_setvline_set は、マクロであるかもしれないことに注意してください。
 

戻り値

成功して終了すれば、これらの関数は OK を返します。そうでなければ、それらは ERR を返します。

ウィンドウのパラメータを使用する関数は、それが null であるなら、エラーを返します。

関連項目

ncurses(3X), curs_border(3X), curs_outopts(3X)