curs_bkgrnd 3x

curs_bkgrnd(3x)                                         curs_bkgrnd(3x)

NAME 名前

       bkgrnd,  wbkgrnd,  bkgrndset, wbkgrndset, getbkgrnd, wget-
       bkgrnd - curses  window  complex  background  manipulation
       routines
       bkgrnd - curses ウインドウの複合文字背景操作ルーチン

SYNOPSIS 書式

       #include <curses.h>

       int bkgrnd( const cchar_t *wch);
       int wbkgrnd( WINDOW *win, const cchar_t *wch);
       void bkgrndset(const cchar_t *wch );
       void wbkgrndset(WINDOW *win, const cchar_t *wch);
       int getbkgrnd(cchar_t *wch);
       int wgetbkgrnd(WINDOW *win, cchar_t *wch);

DESCRIPTION 説明

bkgrndset

       The bkgrndset and wbkgrndset routines manipulate the back-
       ground of the named window.  The window  background  is  a
       cchar_t consisting of any combination of attributes (i.e.,
       rendition) and a complex character.  The attribute part of
       the  background  is  combined  (OR'ed)  with all non-blank
       characters 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.
       　bkgrndset と wbkgrndset ルーチンは指定されたウインドウの
       背景を操作します。
       　ウインドウの背景は属性 (つまり表示様式) と複合文字のあらゆる
       組み合わせで構成される cchar_t 値です。
       　背景の属性部分は、waddch (訳注: wadd_wch か) で
       ウインドウに書き込まれたすべての非空白文字と組み合わされ 
       (論理和 (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.
       　背景の属性部分は画面上の文字の表示様式として、個々の端末で
       可能な限り表示されます。

bkgrnd

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

       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   以前の背景文字が表示されている場所はすべて新しい
           背景文字に変更します。

getbkgrnd

       The  getbkgrnd function returns the given window's current
       background character/attribute pair via the wch pointer.
       　getbkgrnd 関数は指定のウインドウの現在の背景文字と属性の組を 
       wch ポインタを経由して返します。
       (訳注: getbkgrnd は stdscr の…、
       wgetbkgrnd は指定のウインドウの…、と思われる)

NOTES 注意

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

RETURN VALUE 戻り値

       The bkgrndset and wbkgrndset  routines  do  not  return  a
       value.
       　bkgrndset と wbkgrndset ルーチンは値を返しません。

       Upon successful completion, the other functions return OK.
       Otherwise, they return ERR.   A  null  window  pointer  is
       treated as an error.
       　その他の関数は、正常終了の場合に OK を、その他の場合に ERR を
       返します。
       　ヌル・ウインドウ・ポインタはエラーとして扱われます。