curs_bkgd 3x

curs_bkgd(3x)                                             curs_bkgd(3x)

名前

       bkgdset,  wbkgdset,  bkgd,  wbkgd, getbkgd
        - curses ウインドウ背景操作ルーチン

書式

       #include <curses.h>

       void bkgdset(chtype ch);
       void wbkgdset(WINDOW *win, chtype ch);
       int bkgd(chtype ch);
       int wbkgd(WINDOW *win, chtype ch);
       chtype getbkgd(WINDOW *win);

説明

bkgdset

       　bkgdset と wbkgdset ルーチンは指定されたウインドウの背景を
       操作します。
       　ウインドウの背景は属性 (つまり表示様式) と文字のあらゆる
       組み合わせで構成される chtype 値です。
       　背景の属性部分は、waddch でウインドウに書き込まれたすべての
       非空白文字と組み合わされ (論理和 (OR) を取られ) ます。
       　背景の文字部分と属性部分の両方が、空白文字に
       組み合わされます。
       　背景は文字の属性となり、あらゆるスクロールや
       行/文字の挿入/削除操作を通じて文字とともに移動します。

       　背景の属性部分は画面上の文字の表示様式として、個々の端末で
       可能な限り表示されます。

bkgd

       　bkgd と wbkgd 関数は現在の、または指定のウインドウの
       背景属性をセットし、そのウインドウ内のすべての文字位置に
       この設定を適用します。

       o   画面上のすべての文字の表示様式を新しい背景表示様式に
           変更します。

       o   以前の背景文字が表示されている場所はすべて新しい
           背景文字に変更します。

getbkgd

       　getbkgd 関数は指定のウインドウの現在の背景文字と属性の組を 
       返します。

戻り値

       　bkgd と wbkgd ルーチンは整数 OK を返します。
       (訳注: wbkgd は正常終了の場合に OK を、その他の場合に ERR を
       返し、ヌル・ウインドウ・ポインタはエラーになると思われます)
       　SVr4.0 マニュアルには「または、immedok がセットされていれば
       負でない整数」と書かれていますが、これは間違いであると
       思われます。

注意

       　bkgdset, bkgd はマクロであるかもしれないことに
       注意してください。

移植性

       　これらの関数は XSI Curses standard, Issue 4 に
       記述されています。
       　そこでは bkgd と wbkgd は失敗の場合 ERR を返すと
       指定していますが、失敗の条件は与えていません。