Home   Single Page

Keystroke イベント

イベント名

コンポーネント / 説明

onOK

window textbox intbox longbox doublebox decimalbox datebox timebox combobox bandbox

イベント: org.zkoss.zk.ui.event.KeyEvent

ユーザーがENTERキーを押したことを意味します。

onCancel

window textbox intbox longbox doublebox decimalbox datebox timebox combobox bandbox

イベント:org.zkoss.zk.ui.event.KeyEvent

ユーザーがESCキーを押したことを意味します。

onCtrlKey

window

イベント:org.zkoss.zk.ui.event.KeyEvent

ユーザーがPgUp、Home、または、CtrlやAltと組み合わされたキーといった特別なキーがユーザによって押されたことを意味します。もっと詳しくは以下のctrlKeysPropertyセクション参照ください。

キーストロークイベントは指定されたイベントにイベントリスナを保存した一番近いウィンドウに送信されます。それはsubmit、cancel、shortcut機能を実装するためにあります。

以下に説明されたように、T1にフォーカスしていて、ユーザーがENTERを押しらDoA()は呼び出されます。T2にフォーカスしていてユーザーがENTERを押したなら、doB()が呼び出されます。

<window id="A" onOK="doA()">
    <window id="B" onOK="doB()">    
        <textbox id="T1"/>        
    </window>    
    <textbox id="T2"/>    
</window

ウィンドウはウィンドウの内側で送られるキーストロークイベントを手動でポストしない限り、受信しません。
上の例ではイベントはウィンドウAには送信されません。T1をフォーカスする場合、onOKハンドラがウィンドウBに宣言されたかどうかは関係ありません。

ctrlKeysプロパティ

onCtrlKeyイベントを受け取るのにctrlKeysプロパティでどのキーが中断させるか指定しなければなりません。
つまり、ctrlKeys プロパティ中で指定されたキーだけがサーバーに返信されます。例えば、ユーザーがAlt+C,Ctrl+A,F10,Ctrl+F3を押した場合、onCtrlKeyイベントが送信されます。

<window ctrlKeys="@c^a#10^#3">
...

以下はctrlKeysプロパティのシンタックスです。

キー

説明

  

^k

コントロールキー。i.e,Ctrl+k, k はa~z,0~9,#n か~n。.

  

@k

alt キー,i.e,Alt+k, k はa~z, 0~9, #n か ~n。

  

$k

shift キー,i.e,Shift+k,k= #n , ~n。

  

#n

特別なキー:

#home

Home

#end

End

#ins

Insert

#del

Delete

#left

#right

#up

#down

#pgup

PgUp

#pgdn

PgDn

#fn

ァンクションキー。 #f1, #f2, ... #f12 は F1, F2,... F12に対応。