ボックス・サブルーチン

オンライン編集

目的

1 バイト文字とレンディションから境界線を描画します。

ライブラリー

Curses ライブラリー (libcurses.a)

構文

#include <curses.h>
int box(WINDOW  *win,
chtype  verch,
chtype  horch);

説明

box サブルーチンは、指定されたウィンドウの端の周りにボーダーを描画します。 このサブルーチンはカーソル位置を進めません。 このサブルーチンは、特殊文字処理を実行したり、折り返しを実行したりすることはありません。

box サブルーチン (*win、 verch、 horch) には、以下と同等の効果があります。

wborder(win, verch, verch, horch, horch, 0, 0, 0, 0);

パラメーター

表 1. パラメーター
項目 説明
horch (ホック) ボックスの水平線を描画する文字を指定します。 文字は 1 桁の文字でなければなりません。
verch (verch) ボックスの縦線を描画する文字を指定します。 文字は 1 桁の文字でなければなりません。
成功 (* win) ボックスを描画するウィンドウを指定します。

戻り値

正常終了すると、 box 関数は OK を返します。 それ以外の場合は、ERR を返します。

例

  1. ユーザー定義ウィンドウの周囲にボックスを描画するには、以下のようにします。my_window、使用|(パイプ) を垂直方向の文字として使用し、-(負符号) を水平文字として入力するには、次のように入力します。
    WINDOW *my_window;
box(my_window, '|', '-');
  2. デフォルト文字 ACS_VLINE および ACS_HLINE を使用して my_window の周囲にボックスを描画するには、次のように入力します。
    WINDOW *my_window;
box(my_window, 0, 0);