manページ  — curs_pad

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 と類似していますが、ウィンドウではなくパッドに関連している 点は異なります。パッドと画面のどの部分が関連しているのかを示すために、 追加のパラメータが必要です。 pminrow と pmincol はパッド内で表示される 長方形の左上コーナーを指定します。 sminrow 、 smincol 、 smaxrow 、 smaxcol は、画面に表示される長方形のエッジを指定します。パッド内に表示される長方形の 右下コーナーは、画面座標から計算されます。長方形は同じサイズ でなければならないからです。両方の長方形が、それぞれの構造の内部に完全に 入れられる必要があります。

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

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

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

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

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