EN JA
form_field(3X)
form_field(3X) form_field(3X)

名称

form_field - フィールドと form の関係の作成と破壊

書式

#include <form.h>
 
int set_form_fields(FORM *form, FIELD **fields);
 
FIELD **form_fields(const FORM *form);
 
int field_count(const FORM *form);
 
int move_field(FIELD *field, int frow, int fcol);
 

解説

関数 set_form_fields は、与えられた form のフィールドポインタの配列を変更します。配列は、 NULL で終了しなければなりません。

関数 form_fields は、与えられた form のフィールド配列を返します。

関数 field_count は、 form 中のフィールドを数えた数を返します。

関数 move_field は、画面上の指定された位置に与えられたフィールド (それは分離されるに違いない) を移動させます。

戻り値

関数 form_fields は、エラーの場合 NULL を返します。

関数 field_count は、 form パラメータが NULL であるなら ERR を返します。

関数 set_form_fieldsmove_field は、エラーの場合、次のコードの 1 つを返します:

E_OK
ルーチンが成功した。
E_BAD_ARGUMENT
ルーチンは正しくないか範囲外の引数を検知しました。
E_CONNECTED
フィールドは、既に form に接続されています。
E_POSTED
form は既に記入されています。
E_SYSTEM_ERROR
システムエラーが生じた ( errno 参照)。

関連項目

curses(3X), form(3X)

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

移植性

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

SVr4 form ライブラリドキュメンテーションは、 field_count のエラー値として -1 ( ERR の値) を仕様化しています。

作者

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