FocusOperationEventクラス

Biz/Browser 4.1.0

Biz/Browser AI 1.0.0

 

Object

 

 

 

 

 

 

 

Event

 

 

 

 

 

 

 

ForcusOperationEvent

 

 

 

FocusObjectクラスのFocusOperationイベントの通知に使用されるクラスです。

 

FocusOperationイベントは、オブジェクトがキーボードフォーカスを受けている際に、フォーカスの移動を起こす操作を行ったときに発生します。フォーカスの移動を起こす操作とは、TABキーまたはNextTabKeyPrevTabKeyプロパティに設定したキーの押下、AutoTabプロパティがあるクラスについてはAutoTabが実行される操作です。これら以外の操作ではFocusOperationイベントは発生しません。

 

FocusOperationイベントは、自動的なフォーカス移動を指示するFocusObject.AutoTabFocusプロパティの指定に従い、フォーカス移動とは排他的に発生します。AutoTabFocusプロパティが$TRUEの場合には、フォーカス移動を起こす操作でフォーカスが移動し、FocusOperationイベントは発生しません。逆に、AutoTabFocusプロパティが$FALSEの場合は、フォーカスは移動せずにFocusOperationイベントが発生します。

 

FocusObjectAutoTabFocusプロパティ、FocusOperationイベント、MoveFocusメソッド、およびFocusOperationEventオブジェクトを組み合わせて利用することにより、タブキーやEnterキーによるフォーカス移動動作に、入力値のチェックなどアプリケーション固有の動作を介入させる事ができます。以下の例のように、入力値が空の場合はフォーカス移動せずにエラーメッセージを表示し、正当な入力の場合には、次のオブジェクトにフォーカスを移すような動作です。

 

TextBox tx {
    :
    AutoTabFocus = $FALSE;
    :
    Function OnFocusOperation(e) {
        if( value == "" ) {
            BgColor = $RED;
            MessageBox("入力してください");
            return;
        }
        BgColor = $STD;
        MoveFocus(e.Direction);
    }
}

 

デフォルトプロパティとValueType

 

デフォルトプロパティはReasonです。ValueTypeの指定は無効です。

 

Mobile版でのFocusOperationイベントの取り扱いについて

 

Mobile版ではFocusOperationEventクラスは存在しませんが、EventオブジェクトにKeyおよびDirectionオブジェクトが付加されたオブジェクトとして同様に扱えるよう配慮されています。

 

 

プロパティ | メソッド | イベント

 



「オンラインマニュアル」一覧へ戻る
「Bizの宝箱」TOPへ戻る