本セクションに関連するものとして イベント処理 でも解説を行っているので併せてお読みください。

　今までの解説で既に、イベントをMind処理単語に結び付ける方法を書いてきました。それらのプログラムはボタンやメニュー項目を押すことで発生するイベントの登録を”ウィジェットへの属性付与”として扱っていました。つまり、
　　　”ウィジェットからのイベント発生”
を登録するものでした。
　しかし他にもキーの打鍵やマウスのクリックなど、
　　　”生のイベントそのものを扱う” 仕組みがあります。このセクションではそれについて解説します。
　キー打鍵やマウスボタン押下などの各種イベントを特定の処理に結び付けることを”バインド”と呼びます。たとえば "Esc"キー打鍵で何らかの処理を行わせたり、マウスの左クリックをMindの処理単語に関連付けたりできます。
　ダイアログ、メニュー、テキストウィジェット、キャンバスなどでバインドが使われることが多いですが統合してここで解説します。
　まずサンプル "hellowinButton.exe" を実行してみてください。

　ボタンが１つ表示されます。ここでTABキーを押すとボタンが点線で囲まれフォーカスが当たったことが分かります（これ自体はGUIエンジンが勝手にやっていることです）。

　この状態でEnterキーを押してみてください。何も起きません。つまりデフォルトではボタンにフォーカスが当たっている状態であってもEnterキーには無反応です。

注：フォーカスを当てることについては、「ウィンドウ操作」-「フォーカスを当てる」 を参照してくたさい。

　次に、サンプル "focus-and-bind.exe" を実行します。

　上でボタン１、ボタン２を押してみてください。イベントが発生しメッセージ域に、
　　　　ボタンが押されました
　　　　引数="ボタン１押下"
と表示されます。
　今度は Enterキーを押してみてください。Enterキーでイベントが発生する様子が確認できます。
　　　　ボタンが押されました
　　　　イベント名="Enter"　引数="Event-1"
と表示され、先のボタン押下とは反応が違うことが分かります。
　さらにTABキーによってフォーカスをボタン２に移動させそこでEnterキーを押すと今度は
　　　　ボタンが押されました
　　　　イベント名="Enter"　引数="Event-2"
と表示されます。
　さて、ボタンにフォーカスが当たっている状態でEnterキーを押すと、ボタン押下と同じ扱いになる・・というのはWindowsのアプリケーションとして当然だと思われるかも知れません。それはそうなのですが、それはWindows OS や本GUIエンジンが自動的にやってくれるわけではなく、アプリケーションが明にEnterキー扱いを指示する必要があります。つまり、バインドを登録する必要があります。
　さらに、"focus-and-bind.exe" で注目して欲しいのは、このアプリケーションが起動したときにボタン１にフォーカスが当たっている点です。これもプログラムで明にフォーカスを与えています。この状態でEnterキーを押すと、あらかじめ登録しておいたイベントが発生する仕組みになっています。
　TABキーを押すとフォーカスがボタン１とボタン２の間で交互に移動するので、Enterをどちらのボタンに効かせるか選ぶことができます。TABキーによるフォーカス移動については、GUIライブラリが自動的に行ってくれるのでプログラムで明に書く必要はありません。（もちろんプログラムで明にフォーカスを当てることもできます）
　さらに続けます。キーボードから Ctrl-s を打鍵してみてください。
　　　　ボタンが押されました
　　　　イベント名="Ctrl-s"　引数="Event-s"
と表示され、Ctrl-s キーの押下がイベンを引き起こしたことが分かります。これもまたそのようなバインドを登録したので起きたことです。



■キーイベントのバインドを登録
　キー押下やマウスボタンなど、生のイベントをMindの処理単語にバインドする機能です。

       プログラム例１：（focus-and-bind.src から抜粋）
　上記のようにキー入力に対応するイベント処理を登録します。
　上記例で最初にスタックに積んでいる文字列「Ctrl-s」はイベント名としてのキーシンボルです。（イベント名の詳細は後にまとめて解説します）
　スタックにはさらに、イベント処理語の実行情報と引数を積み、さらに動作対象となるウィジェットのＩＤを積み、最後に「キーイベントのバインドを登録」を呼び出しています。
　イベント引数は文字列で、
　　　　　「abc」を　・・ のように指定します。複数の引数は
　　　　　「abc def」を　・・ のように空白で区切って並べてください。
　引数に空白文字を含む場合には、 　　　　　「"ab c" def」を　・・
のように指定してください。
　なお、引数（群）文字列末尾に \ 記号は付けられません。また、{ } 記号は使えるものの、開きと閉じでバランスが取れている必要があります。（アンバランスで使うとエラーを検出します）
　対象ウィジェットＩＤですが、上記は「メインウィンドウ」を指定しています。”メインウィンドウのどこかにフォーカスがあれば可”という意味になります。
　次の例はどうでしょうか。
       プログラム例２：（focus-and-bind.src から抜粋）
　例１では対象ウィジェットを「メインウィンドウ」としていたのに比べ、例２では対象ウィジェットを「ボタン１」としています。Enterキーはフォーカスの当たっているウィジェットをアクティブ化する・・という使われ方が多いため、キーイベントをボタンという狭い領域に対応させます。

■キーイベントのサンプルプログラム
　キーイベントのバインド登録のサンプルプログラムとしては、
を参考にしてください。



■マウスイベントのバインドを登録
　マウス操作のイベントをMindの処理単語にバインドします。

       プログラム例３：（bind-mouse.src から抜粋）
　イベント発生時に処理単語に渡されるパラメータのうちＸ座標とＹ座標は対象ウィジェット左上隅からの相対です。さらには、その”座標”は数値ではなく数値を表す文字列なので要注意です。
　文字列としての座標値は、たとえば、
　　　　　↓文字列を　　　　　　　　　　↓数値に
　　　　　Ｘ座標列を　数値変換し　捨て　Ｘ座標に　入れ のようにして整数値を得てください。
　マウスイベントはキャンバスとの組み合わせで使われることが多いです。「キャンバス」−「図形の特定・検索」 で改めて解説します。
　イベント引数は文字列で、 　　　　　「abc」を　・・ のように指定します。複数の引数は
　　　　　「abc def」を　・・ のように空白で区切って並べてください。引数に空白文字を含む場合には
　　　　　「"ab c" def」を　・・ のように指定してください。
　なお、引数（群）文字列末尾に \ 記号は付けられません。また、{ } 記号は使えるものの、開きと閉じでバランスが取れている必要があります。（アンバランスで使うとエラーを検出します）

■マウスイベントのサンプルプログラム
　マウスイベントのバインド登録のサンプルプログラムとしては、
　　　　bind-mouse.exe 　を参考にしてください。

■マウスのイベント処理
　マウスイベントをバインドすると登録しておいた処理単語か呼び出されます。
　たとえば次のような書き方が考えられます。
       プログラム例４：
　処理単語「マウスイベント処理」が起動された段階で以下ようなスタック並びとなります。
　　　　　→ イベント名、Ｘ座標列、Ｙ座標列、３(引数個数)
　スタックパラメータのうちイベント名ですが、上記で、
　　　　　左クリックに　等しい文字列
　という記述に注目してください。上がって来るイベント名は文字列の "Button-1" なので、たとえば、
　　　　　"Button-1"に　等しい文字列
と書いても良いのですが、それではソースの意図が分かりにくいだけでなく、たとえば
　　　　　"Buttn-1"に　等しい文字列　　　←'o'が抜けている
と書いた場合にコンパイル時にも実行時にもエラーにならず動作不良の原因が分からない事態も考えられます。
　したがって、できるだけMindのシンボルとして、
　　　　　左クリックに　等しい文字列
と書くことをお勧めします。「左クリック」の綴りを間違えれば、コンパイル時に未定義語というエラー検出がされます。
　次に、座標値ですが、
　スタック奥から２番目と３番目の座標は整数ではなく、”整数を表す文字列”であることに注意します（イベント引数はすべて文字列です）。
　上記プログラム例も、一旦文字列変数に格納した後に、それを整数化して整数変数に代入しています。

■独特のマウスイベントについて
　以下はサンプルプログラム "bind-mouse.exe" を試しながらお読みください。



■マウスイベントを適用するウィジェット
　マウスでオブジェクトを操作するという意味で、キャンバスウィジェット内で利用することが多いかと思います。しかし、マウスイベントの適用先として、キャンバスウィジェットに限らず、ラベルウィジェットやテキストウィジェットなど何にでも適用できます。
　テキストウィジェット中でマウスを操作することはよくあることなのですが、テキストウィジェット自体がデフォルトで持つマウス処理で間に合ってしまうため、プログラマが明にマウスイベントを扱う必要はほとんどありません。
　たとえば、テキストウィジェット中の数文字をマウスでドラッグして反転させ、Delキーを押すとその文字群を削除できます。しかしそれについてユーザプログラムとして何も書く必要は無く、テキストウィジェットのデフォルトの動作として自動的に実現されます。逆に言えば、それだけテキストウィジェットが提供するサービスは大きいと言えます。
　一方、キャンバスウィジェットについてはマウスへの自動処理はまったくありません。マウスで図形を操作するにはマウスイベント扱いをすべてユーザプログラムで組む必要があります。（キャンバスウィジェットの章を参照してください）



　キー押下でもなくマウス操作でもないその他のイベントをMindの処理単語にバインドします。

■汎用イベントのバインドを登録

この機能はテキストウィジェットやキャンバスウィジェットでよく使われるものです。以下ではテキストウィジェットでの利用を例に説明しているので、テキストウィジェットの解説を読み終わってから本項を読まれるのも良い方法です。

　キー打鍵など、あるイベントに対して既に特定の処理が定義されているか、あるいはウィジェット自身が持つデフォルト処理として対応が存在する場合、プログラムからそのイベントを強制発生することでその処理を行わせることができます。
　たとえば、テキストウィジェットにおいて、Delキー打鍵によりキャレットのある１文字が削除されます(これはウィジェット自身が持つデフォルト編集機能なのでMindで書く必要はありません)。
　一方、たとえば Ctrl-g 打鍵でも同じ動作をさせたいとします。そのとき、
　　　　　キャレットのある１文字を削除する
ような具体的な処理をあえて書かず、Delキーのイベントを強制発生させることで簡単に済ませることができます。
       プログラム例１：
       プログラム例２：
　上の例２は、サンプルプログラム "text-edit.src" の中で書かれているものです。
　メニューバーの「編集」−「やり直し」が押された時に「やり直し処理」に飛んで来ますが、そこでイベント「Ctrl-z」を発生させることで処理を簡単に済ませています。（Ctrl-z 対応はGUIエンジンのデフォルト編集機能であるためMindで書かれたコードは書かなくて済み、この手法が生きます）



　ボタンなどのウィジェットに対してイベントを登録する時はウィジェット名を対象として行いましたが、本章で解説するものは”イベント名”と呼ぶものをイベント発生の元として指定します。
　最初にキー打鍵のイベント名について解説します。

■キーシンボルによるイベント名
　キー打鍵のイベントでバインドを登録する際のイベント名を解説します。
　上記で「その他のキー」に分類されるものは技術情報やキーボード刻印での表記がまちまちです。
　たとえば Esc／Escape、Ins／Insert のような表記揺れがありますが、本ライブラリは短形式に統一します。したがって、たとえば「Esc」が正く、「Escape」は誤りです。また、「F1」と書くべきところ「f1」と書くものもエラーになります。
　　　（Mindの単語認識とは異なり、全角・半角・大文字・小文字は区別されます）

注：本ライブラリが内部的に利用しているGUIエンジン（Tcl/Tk）ネイティブのキーシンボルと本ライブラリのMindのソースコードでのキーシンボルは異なります。

■記号あるいは１文字を超えるキーシンボル
　'A'など英字１文字で表せるキーはそれ自体がイベント名となるので問題ないのですが、それ以外のキー、たとえば「Esc」など数文字のキーシンボルや記号１字のキーシンボルは書き方が指定されるのでここにまとめます。
　キーシンボルは文字列定数として記述するため、ソースコード上は下記のように " " または 「 」 で囲むことになります。

　　「Esc」
　　「Tab」
　　「BS」
　　「Enter」
　　「Print」
　　「Pause」
　　「Ins」
　　「Del」
　　「Home」
　　「End」
　　「Pgup」
　　「Pgdow」
　　「Left」
　　「Up」
　　「Right」
　　「Down」
　　「(」
　　「)」
　　「=」
　　「-」
　　「~」
　　「^」
　　「|」
　　「\」
　　「`」
　　「@」
　　「{」
　　「[」
　　「+」
　　「;」
　　「*」
　　「:」
　　「}」
　　「]」
　　「<」
　　「,」
　　「>」
　　「.」
　　「?」
　　「/」
　　「_」　（underscore）

■キーの修飾
　たとえば「Ctrl-c」という表現は文字キー「c」を「Ctrl」で修飾しています。
　修飾子とキーシンボルはハイフン「-」でつなぎます（+ ではありません）。
　このような修飾には以下のものがありますがこの通りに記述してください。
　修飾は重複使用できます。
　以下に注意願います。

• Alt と Ctrl 併用は Alt を先に書いてください
• Alt と Shift 併用は効かないことがあります
• 数字キーの 1〜5 は 何を修飾しても効きません
• 英大文字・小文字（例: s と S）は別のキーシンボルです
• キーの刻印に下段と上段があるものについては、上段のキー刻印を書いてください。誤と書いてあるものが実際は使えるケースもあります。正の側を推奨すると理解してください。

　　　（例）
　　　　　Shift-@　　　（誤）
　　　　　`      　　　（正）

　　　　　Shift-s　　　（誤）
　　　　　S      　　　（正）

　　　　　Shift-9　　　（誤）
　　　　　Shift-)　　　（正）

　　　　　Ctrl-Shift-9　（誤）
　　　　　Ctrl-Shift-)　（正）

　　　　　Ctrl-Shift-; （誤）
　　　　　Ctrl-Shift-+ （正）

　　　（補足：「Shiftキーを押しながらの @」はもともと「`」を生成する
　　　　　　　ものなのでキーシンボル「`」だけを指定してください）

　
• 挙動で注意が必要なもの
　　　　−−−−−−−−−−−−−−−−−−−−−−−−−
　　　　キーシンボル　　注意
　　　　−−−−−−−−−−−−−−−−−−−−−−−−−
　　　　Ctrl-Shift-BS 　 　　Ctrlは無視される
　　　　Ctrl-Shift-0(ゼロ) 　無視される
　　　　*-Alt-F4　　　　 　 　OSにより強制終了するので使えない
　　　　Shift-Tab 　　　 　　無視される
　　　　1 〜 5 　 　　　　　　いかなる修飾も効かず

　　　　　　（注：このほかにも修飾が無視されるものが
　　　　　　　あるかも知れませんが実動の通りとします）
　　　　−−−−−−−−−−−−−−−−−−−−−−−−−
　
• キーと修飾との組み合わせは無数にあり、その中には上記ルールから逸脱したものもありますが、GUIエンジンの特性であり、バグではなく現状通りとします。

　子ウィンドウが閉じるときにイベントを発生させられます。
　ウィンドウ操作関連として、「ウィンドウ操作」−「子ウィンドウが閉じる時の制御」 にて解説しているのでそちらをご覧ください。

• 
• 　　　　　　　　　　　　　　　　
• 　　

---