curs_pad

Section: C Library Functions (3)
Updated:
索引 jman
 

索引

名称

newpad, subpad, prefresh, pnoutrefresh, pechochar - create and display ncurses pads  

索引

書式

#include <ncurses.h>

WINDOW *newpad(int nlines, int ncols);
WINDOW *subpad(WINDOW *orig, int nlines, int ncols,
      int begin_y, int begin_x);
int prefresh(WINDOW *pad, int pminrow, int pmincol,
      int sminrow, int smincol, int smaxrow, int smaxcol);
int pnoutrefresh(WINDOW *pad, int pminrow, int pmincol,
      int sminrow, int smincol, int smaxrow, int smaxcol);
int pechochar(WINDOW *pad, chtype ch);  

索引

解説

newpad ルーチンは、指定された数の行 nlines と列 ncols がある新しい パッドデータ構造を指すポインタを作成し返します。パッドはウィンドウに 類似していますが、画面サイズによって制限されない点、画面の特定の部分に 必ずしも対応していない点は異なります。パッドが使用できるのは、大きな ウィンドウが必要であり、一度にウィンドウの一部だけが画面に 表示されるときです。パッドの自動的なリフレッシュ ( たとえば、スクロールまたは 入力のエコーから ) は発生しません。 pad を引数として wrefresh を呼び出すのは 正しくありません。代わりに、ルーチン prefresh またはルーチン pnoutrefresh を呼び出す必要があります。表示されるパッドの一部、および表示に使用される 画面上の位置を指定する追加のパラメータがこれらのルーチンには 必要であることに注意してください。

subpad ルーチンは、パッド内の指定数の行 nlines と列 ncols があるパッド内の サブウィンドウを指すポインタを作成し返します。画面座標を使用する subwin と異なり、ウィンドウはパッド上の位置 (begin_x, begin_y) にあります。ウィンドウ はウィンドウ orig の中央に作成されるので、 1 つのウィンドウについて行われた 変更は両方のウィンドウに影響を及ぼします。このルーチンの使用の間、 prefresh を呼び出す前に orig 上で touchwin または touchline を呼び出すことがしばしば 必要になります。

prefresh ルーチンおよび pnoutrefresh ルーチンは、 wrefresh および wnoutrefresh と類似していますが、ウィンドウではなくパッドに関連している 点は異なります。パッドと画面のどの部分が関連しているのかを示すために、 追加のパラメータが必要です。 pminrowpmincol はパッド内で表示される 長方形の左上コーナーを指定します。 sminrowsmincolsmaxrowsmaxcol は、画面に表示される長方形のエッジを指定します。パッド内に表示される長方形の 右下コーナーは、画面座標から計算されます。長方形は同じサイズ でなければならないからです。両方の長方形が、それぞれの構造の内部に完全に 入れられる必要があります。

pminrowpmincolminrowsmincol の値が負の場合は、ゼロであるかのように処理されます。

pechochar ルーチンは、 addch の呼び出しの後の refresh の呼び出し、 waddch の 呼び出しの後の wrefresh の呼び出し、または waddch の呼び出しの後の prefresh の呼び出しと機能的に同等です。 1 文字しか出力されないという知識を 考慮に入れ、制御文字でないキャラクタについては、同等のルーチン ではなくこれらのルーチンを使用することによって、相当な性能の向上が見られ 可能性があります。 pechochar の場合、画面上のパッドの最後の位置が、 prefresh への引数として再使用されます。  

索引

戻り値

整数を返すルーチンは、処理失敗すると ERR を返してきます。処理が正常に 完了した場合は、 ERR 以外の整数値を返します。

ポインタを返すルーチンはエラーがあった場合は NULL を返してきます。  

索引

注釈

pechochar はマクロである可能性があることに注意してください。  

索引

関連項目

ncurses(3), curs_refresh(3), curs_touch(3), curs_addch(3)


 

索引

Index

名称
書式
解説
戻り値
注釈
関連項目

jman



Time: 07:06:44 GMT, January 12, 2009