EN JA
form_field_opts(3X)
form_field_opts(3X) form_field_opts(3X)

名称

form_field_opts - フィールドオプションを設定するか取得する

書式

#include <form.h>
 
int set_field_opts(FIELD *field, Field_Options opts);
 
int field_opts_on(FIELD *field, Field_Options opts);
 
int field_opts_off(FIELD *field, Field_Options opts);
 
Field_Options field_opts(const FIELD *field);
 

解説

関数 set_field_opts はすべての与えられたフィールドのオプションビット (フィールドオプションビットは共に論理和(OR)されます) を設定します。

関数 field_opts_on は与えられたオプションビットをオンにして、他のものはそのままにします。

関数 field_opts_off は与えられたオプションビットをオフにし、他のものはそのままにします。

関数 field_opts はフィールドの現在のオプションビットを返します。

次のオプションが定義されています(デフォルトでは全てオンです)。

O_VISIBLE
フィールドが表示されます。このオプションがオフである場合、フィールドの表示を抑制します。
O_ACTIVE
フィールドは処理中に訪れられます。このオプションがオフである場合、フィールドはナビゲーション(操縦)キーで到達できないでしょう。目に見えないフィールドがさらに不活発に見えることに注意してください。
O_PUBLIC
データが入力されるとともに、フィールド内容が表示されます。
O_EDIT
フィールドは編集できます。
O_WRAP
フィットしない言葉は次の行に折り返しされます。言葉は空白 (ブランク) 分離されます。
O_BLANK
文字が最初の位置で入力される場合は常に、フィールドはクリアされます。
O_AUTOSKIP
これが満たされた場合、次のフィールドへスキップします。
O_NULLOK
空白 (ブランク) のフィールドを許可します。
O_STATIC
フィールドバッファはフィールドの元のサイズに固定されます。動的なフィールドを作成するためには、このオプションをオフにします。
O_PASSOK
ユーザによって修正されればフィールドのみを有効にします。

戻り値

field_opts を除いて、各ルーチンは次の 1 つを返します:
E_OK
ルーチンが成功した。
E_BAD_ARGUMENT
ルーチンは正しくないか範囲外の引数を検知しました。
E_CURRENT
フィールドは現在のフィールドです。
E_SYSTEM_ERROR
システムエラーが生じた ( errno 参照)。

関連項目

curses(3X), form(3X)

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

移植性

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

作者

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