curs_border(3)

名称
border, wborder, box, hline, whline, vline, wvline - ncurses の境界線、水平線、垂直線を作成する

書式
#include <ncurses.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);

解説
border, wborder および box の各ルーチンは ウィンドウのエッジの回りにボックスを描画します。 引数 ls はボーダーの左側に使用される 1 つの文字および属性です。 同様に、rs - 右側、ts - 上側、bs - 下側、 tl - 左上コーナー、tr - 右上コーナー、 bl - 左下コーナー、br -右下コーナーです。 これらの引数のいずれかがゼロである場合、次のデフォルト値 (ncurses.h に定義されています) が代わりに使用されます。 ACS_VLINE, ACS_VLINE, ACS_HLINE, ACS_HLINE, ACS_ULCORNER, ACS_URCORNER, ACS_LLCORNER, ACS_LRCORNER です。 box(win, verch, horch) は、 次の呼び出しを簡単にしたものです。 wborder(win, verch, verch, horch, horch, 0, 0, 0, 0) hline 関数と whline 関数は、 ウィンドウ内の現在のカーソル位置で開始する ch を使用して 水平線 (左から右)を描画します。 カーソルの現在位置は変化しません。 線は、長くとも n 文字の長さであるか、 またはウィンドウに入るだけの長さになります。 vline 関数と wvline 関数は、 ウィンドウ内の現在のカーソル位置で開始する ch を使用して 垂直線 (上端から下端) を描画します。 カーソルの現在位置は変化しません。 線は、長くとも n 文字の長さであるか、 またはウィンドウに入るだけの長さになります。

戻り値
すべてのルーチンが整数 OK を返します。 SVr4.0 マニュアルには "or a non-negative integer if immedok is set (または、immedok が設定されている場合には、負でない整数)" と記載されていますが、これは間違いと考えられます。

注釈
これらの関数が生成するボーダーは、内側のボーダーです (これは SVr4 curses にも該当します。 ただし、このことは記載されていません)。 border と box はマクロである可能性があることに注意してください。

バグ
immedok 関数は ncurses 1.8.6 ではまだ実現されていません。

関連項目
ncurses(3), curs_outopts(3).