curs_bkgd 3x

curs_bkgd(3x)                                             curs_bkgd(3x)

NAME 名前

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

SYNOPSIS 書式

       #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);

DESCRIPTION 説明

bkgdset

       The bkgdset and wbkgdset  routines  manipulate  the  back-
       ground  of  the  named window.  The window background is a
       chtype consisting of any combination of attributes  (i.e.,
       rendition)  and  a  character.   The attribute part of the
       background is combined (OR'ed) with all non-blank  charac-
       ters  that  are written into the window with waddch.  Both
       the character and attribute parts of  the  background  are
       combined   with  the  blank  characters.   The  background
       becomes a property of the character  and  moves  with  the
       character   through   any   scrolling   and  insert/delete
       line/character operations.
       　bkgdset と wbkgdset ルーチンは指定されたウインドウの背景を
       操作します。
       　ウインドウの背景は属性 (つまり表示様式) と文字のあらゆる
       組み合わせで構成される chtype 値です。
       　背景の属性部分は、waddch でウインドウに書き込まれたすべての
       非空白文字と組み合わされ (論理和 (OR) を取られ) ます。
       　背景の文字部分と属性部分の両方が、空白文字に
       組み合わされます。
       　背景は文字の属性となり、あらゆるスクロールや
       行/文字の挿入/削除操作を通じて文字とともに移動します。

       To the extent  possible  on  a  particular  terminal,  the
       attribute  part  of  the  background  is  displayed as the
       graphic rendition of the character put on the screen.
       　背景の属性部分は画面上の文字の表示様式として、個々の端末で
       可能な限り表示されます。

bkgd

       The bkgd and wbkgd functions set the  background  property
       of  the  current  or  specified window and then apply this
       setting to every character position in that window:
       　bkgd と wbkgd 関数は現在の、または指定のウインドウの
       背景属性をセットし、そのウインドウ内のすべての文字位置に
       この設定を適用します。

       o   The rendition of every  character  on  the  screen  is
           changed to the new background rendition.
       o   画面上のすべての文字の表示様式を新しい背景表示様式に
           変更します。

       o   Wherever  the  former background character appears, it
           is changed to the new background character.
       o   以前の背景文字が表示されている場所はすべて新しい
           背景文字に変更します。

getbkgd

       The getbkgd function returns the  given  window's  current
       background character/attribute pair.
       　getbkgd 関数は指定のウインドウの現在の背景文字と属性の組を 
       返します。

RETURN VALUE 戻り値

       The  routines  bkgd  and wbkgd return the integer OK.  The
       SVr4.0 manual says "or a non-negative integer  if  immedok
       is set", but this appears to be an error.
       　bkgd と wbkgd ルーチンは整数 OK を返します。
       (訳注: wbkgd は正常終了の場合に OK を、その他の場合に ERR を
       返し、ヌル・ウインドウ・ポインタはエラーになると思われます)
       　SVr4.0 マニュアルには「または、immedok がセットされていれば
       負でない整数」と書かれていますが、これは間違いであると
       思われます。

NOTES 注意

       Note that bkgdset and bkgd may be macros.
       　bkgdset, bkgd はマクロであるかもしれないことに
       注意してください。

PORTABILITY 移植性

       These  functions are described in the XSI Curses standard,
       Issue 4.  It specifies that bkgd and wbkgd return  ERR  on
       failure, but gives no failure conditions.
       　これらの関数は XSI Curses standard, Issue 4 に
       記述されています。
       　そこでは bkgd と wbkgd は失敗の場合 ERR を返すと
       指定していますが、失敗の条件は与えていません。