名称

form_hook - アプリケーションによる自動呼び出しホックを設定する

書式

#include <form.h> int set_field_init(FORM *form, Form_Hook func); Form_Hook field_init(const FORM *form); int set_field_term(FORM *form, Form_Hook func); Form_Hook field_term(const FORM *form); int set_form_init(FORM *form, Form_Hook func); Form_Hook form_init(const FORM *form); int set_form_term(FORM *form, Form_Hook func); Form_Hook form_term(const FORM *form);

解説

これらの関数は、 form_driver によって、入力イベントコードの自動処理中の様々なポイントで呼び出されるホック関数を可能にします。

関数 set_field_init は form 記入時と (変更の後の) 選択されたフィールド変更毎に呼ばれるホックを設定します。 field_init は、もしあれば現在のフィールド初期ホック (そのようなホックがない場合、 NULL) を返します。

関数 set_field_term は form を未記入時と (変更の前の) 選択されたフィールド変更毎に呼ばれるホックを設定します。 field_term は、もしあれば現在のフィールド項目ホック (そのようなホックがない場合、 NULL) を返します。

関数 set_form_init は、form 記入時と一旦それが記入されれば、ページ変更直後に呼ばれるホックを設定します。 form_init は、もしあれば現在の form 初期ホック (そのようなホックがない場合、 NULL) を返します。

関数 set_form_term は、from 未記入時と一旦それが記入されれば、ページ変更の直前に呼ばれるホックを設定します。 form_term は、もしあれば現在の form 項目ホック (そのようなホックがない場合、 NULL) を返します。

戻り値

ポインタを返すルーチンはエラーの場合 NULL を返します。他のルーチンは次の 1 つを返します:

E_OK

ルーチンが成功した。

E_SYSTEM_ERROR

システムエラーが生じた ( errno 参照)。

関連項目

curses(3X), form(3X)

注

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

移植性

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

作者

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