EN JA
form_win(3X)
form_win(3X) form_win(3X)

名称

form_win - from ウィンドウおよびサブウィンドウの組み合わせを作成するか分断する

書式

#include <form.h>
 
int set_form_win(FORM *form, WINDOW *win);
 
WINDOW *form_win(const FORM *form);
 
int set_form_sub(FORM *form, WINDOW *sub);
 
WINDOW *form_sub(const FORM *form);
 
int scale_form(const FORM *form, int *rows, int *columns);
 

解説

すべての form は関連するペアの curses ウィンドウを持っています。 from ウィンドウはウィンドウに関連させたどんなタイトルおよび境界を表示します。 form サブウィンドウは、選択に現在利用可能な from の項目を表示します。

最初の 4 つの関数はそれらのウィンドウを取得し設定します。一方のウィンドウを設定することは必要ではありません。デフォルトで、ドライバコードは両方のために stdscr を使用します

set_ 関数では、あたかもそれが stsdcr かのように、 NULL のウィンドウ引数は扱われます。 NULL の form 引数は、システムデフォルト from ウィンドウあるいはサブウィンドウを変更する要求として扱われます。

関数 scale_form は、 form のサブウィンドウのために必要になった最小サイズを返します。

戻り値

ポインタを返すルーチンは、エラーの場合 NULL を返します。整数を返すルーチンは、次のエラーコードの一つを返します。
E_OK
ルーチンが成功した。
E_SYSTEM_ERROR
システムエラーが生じた ( errno 参照)。
E_BAD_ARGUMENT
ルーチンは正しくないか範囲外の引数を検知しました。
E_POSTED
form は既に記入されています。
E_NOT_CONNECTED
アイテムは、from に接続されません。

関連項目

curses(3X), form(3X)

ヘッダファイル <form.h> は、自動的にヘッダファイル <curses.h> を含んでいます。

移植性

これらのルーチンは、System V メニューライブラリをエミュレートします。それらは、Version 7 または BSD バージョンではサポートされませんでした。

作者

Juergen Pfeifer。マニュアルページと新しい curses の適応は、Eric S. Raymond。