2.8.1 アプリケーションオブジェクト

アプリケーションオブジェクトのメソッドは各種ありますが、次のメソッドをあげておきます。

makeusermenus( ): アプリケーションでメニューを使う必要がある場合、このメソッドをオーバーライドします。属性 menubar にメニューを追加します。

getabouttext( ): このメソッドをオーバーライドすることで、アプリケーションの説明を記述するテキスト文字列を返します。代わりに、do_about() メソッドをオーバーライドすれば、もっと凝った``アバウト''メッセージを出す事ができます。

mainloop( [mask[, wait]])

このルーチンがメインイベントループで、作成したアプリケーションが動き出すためにはこれを呼ぶことになります。Mask は操作したいイベントを選択するマスクです。 wait は並行に動作しているアプリケーションに割り当てたいチック数(1/60秒)です(デフォルトで 0 ですが、あまり良い値ではありません)。self フラグを立ててメインループを抜ける方法はまだサポートされていますが、これはお勧めできません。代わりに self._quit()を呼んでください。

イベントループは小さなパーツに分割されていて、各々をオーバーライドできるようになっています。これらのメソッドは、デフォルトでウィンドウとダイアログや、ドラッグとリサイズの操作、 AppleEvent、非FrameWorkのウィンドウに関するウィンドウの操作などに関するイベントを分岐することなどまで面倒をみてくれます。

原則として、全てのイベントハンドラは、イベントが完全に取り扱われた場合は 1 を返さなくてはいけませんし、それ以外では 0 を返さなくてはいけません(例えば、前面のウィンドウは FrameWork ウィンドウではない場合を考えてください)。こうしなくてはいけない理由は、アップデートイベントなどが Sioux コンソールウィンドウなどの他のウィンドウにきちんと渡されるようにするためです。our_dispatch やその呼び出し元の内部から MacOS.HandleEvent() を呼んではいけません。そうしたコードが Python の内部ループのイベントハンドラを経由して呼ばれると、無限ループになりかねないからです。

asyncevents( onoff)

非同期でイベント操作をしたい場合は、非ゼロの引数でこのメソッドを呼んでください。こうすることで、イベントが生じた時に、内部のインタプリタのループで、アプリケーションイベントハンドラ async_dispatch が呼ばれることになります。すると、長時間の計算を行っている場合でも、FrameWorkウィンドウがアップデートされ、ユーザーインターフェースが動き続けるようになります。ただし、インタプリタの動作が減速し、非リエントラントのコード (例えばFrameWork自身など)に奇妙な動作が見られるかもしれません。デフォルトでは async_dispatch はすぐに our_dispatch を呼びますが、このメソッドをオーバーライドすると、特定のイベントを非同期で操作しても良くなります。処理しないイベントは Sioux などに渡されることになります。

onあるいはoff値が返されます。

_quit( ): 実行中の mainloop() 呼び出しを、次の適当なタイミングで終了させます。

do_char( c, event): ユーザーが文字 c をタイプした時に呼ばれます。イベントの全詳細は event構造体の中にあります。このメソッドはウィンドウオブジェクト内で使うためにも提供されています。このオブジェクトのウィンドウが最前面にある場合は、アプリケーション全般について本ハンドラをオーバーライドします。

do_dialogevent( event): イベントループ内部で最初に呼ばれて、モードレスダイアログイベントを処理します。デフォルトではメソッドは単にイベントを適切なダイアログに分岐するだけです(関連したダイアログウィンドウオブジェクトを経由してではありません)。特別にダイアログイベント(キーボードショートカットなど)を処理する必要がある場合にオーバーライドしてください。

idle( event): イベントが無い場合にメインイベントループから呼ばれます。 null イベントも渡されます(つまりマウス位置などを監視することができます)。

ご意見やご指摘をお寄せになりたい方は、 このドキュメントについて... をご覧ください。