イベント名 |
コンポーネント / 説明 |
---|---|
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に宣言されたかどうかは関係ありません。
onCtrlKeyイベントを受け取るのにctrlKeysプロパティでどのキーが中断させるか指定しなければなりません。
つまり、ctrlKeys プロパティ中で指定されたキーだけがサーバーに返信されます。例えば、ユーザーがAlt+C,Ctrl+A,F10,Ctrl+F3を押した場合、onCtrlKeyイベントが送信されます。
<window ctrlKeys="@c^a#10^#3"> ...
以下はctrlKeysプロパティのシンタックスです。