7.5.10 論理アテンション追加登録処理

【提供インタフェース】

【機能説明】: オープン処理でオープンしたウィンドウ単位に、利用者プログラムが指定した論理アテンションを完了キーとして追加登録を行います。

[形式]: PSINT PSFUNCTION ps_register_attention (
PSFILE psfile,
PSULONG atten);

[パラメタ]

psfile	:	オープン処理で獲得した表示ファイル識別子を指定します。
atten	:	登録を行うアテンションの種別を指定します。指定値は論理和で複数指定が可能です。なお、値とその意味は以下のとおりです。
		PS_RATTN_TAB	:	【TAB】キー入力完了。(XT00)
		PS_RATTN_BACKTAB	:	【TAB】+【SHIFT】キー入力完了。(XB00)
		PS_RATTN_SCLUP	:	上スクロールキー入力完了。(F091)
		PS_RATTN_SCLDOWN	:	下スクロールキー入力完了。(FO92)
		PS_RATTN_SCLLEFT	:	左スクロールキー入力完了。(F093)
		PS_RATTN_SCLRIGHT	:	右スクロールキー入力完了。(F094)
		PS_RATTN_CURUP	:	【↑】キー入力完了。(XU00)
		PS_RATTN_CURDOWN	:	【↓】キー入力完了。(XD00)
		PS_RATTN_CURLEFT	:	【←】キー入力完了。(XL00)
		PS_RATTN_CURRIGHT	:	【→】キー入力完了。(XM00)
		PS_RATTN_RETURN	:	【改行】キー入力完了。(XC00)
		PS_RATTN_PAGEUP	:	【PAGE UP】キー入力完了。(XR00)
		PS_RATTN_PAGEDOWN	:	【PAGE DOWN】キー入力完了。(XF00)
		PS_RATTN_HOME	:	【HOME】キーの入力。(XH00)
		PS_RATTN_PLUSENTER	:	【項目脱出】キー入力完了。(E010)
		PS_RATTN_DATAFULL	:	自動入力指定項目でデータフル入力での入力完了。(E100)
		また、登録アテンションの解除を指定した場合、すべての登録アテンションを解除します。なお、値とその意味は以下のとおりです。なお、この指定値は他の指定値と論理和で複数指定はしないでください。
		PS_RATTN_RESET	:	登録アテンションの解除

[診断]

正常終了時には0が返されます。エラー発生時には1または2が返されます。psfileの指定に誤りがある場合には2が、それ以外のエラーの場合には1が返されます。1が返した場合には通知コードの獲得で通知コードを獲得してエラー原因を識別できます。

処理中にオペレータがタスクリストからの終了を選択すると-1が返されます。その場合、利用者プログラムは必ず実行を終了してください。

【注意事項】

論理アテンションは、表示中の入出力ウィンドウの定義体に対してだけ有効となります。本関数を呼び出す前には、出力処理、または入力処理などの関数を呼び出し、定義体を表示してください。なお、一度登録してしまえば定義体を変更しても登録した値は有効です。

また、入出力項目が一つもない定義体では、カーソル移動キー、【改行】キー、【項目脱出】キーでアテンションがあがりません。