Sign in Join
Wiki copytemporary

Main Loop Hooks/ja: what changed

Revision 0 to 1. Removed lines have a minus sign; added lines have a plus sign.

Title: Main Loop Hooks/ja

OldNewLine
1+## 問題について
2+
3+プログラムの中で何らかのイヴェント（あるいはソケットやパイプなど）を待たなければならなくなったとします。しかし、これをメイン (GUI) スレッドの中で行い、しかも GUI ブロックせずまたマルチスレッドにもしたくないとしたらどうしたらいいでしょうか。解決策は、新たな「ハンドル」を追加し、それをメインイヴェントループで監視することです。
4+
5+## 解決法の詳細
6+
7+ユニット [[doc:lcl/lclintf|LCLIntf]] にこれを果たすための三つの関数が追加されています。それらは:
8+
9+``` pascal
10+AddEventHandler(AHandle: THandle; AFlags: dword;
11+ AEventHandler: TWaitHandleEvent; AData: PtrInt): PEventHandler;
12+RemoveEventHandler(var AHandler: PEventHandler);
13+SetEventHandlerFlags(AHandler: PEventHandler; NewFlags: dword);
14+```
15+
16+[[doc:lcl/interfacebase/twaithandleevent.html|TWaitHandleEvent]] 型は、ユニット InterfaceBase の中でこう宣言されています:
17+
18+``` pascal
19+TWaitHandleEvent = procedure(AData: PtrInt; AFlags: dword) of object;
20+```
21+
22+[[doc:lcl/lclintf/addeventhandler.html|AddEventHandler]] は、メインイヴェントループで監視できるようにハンドルを追加します。ハンドルが「シグナル」されると、AEventHandler として渡された手続きが呼び出されます。このとき、イヴェントハンドラが登録される時に渡された AData と、OS 依存の AFlags が渡されます。AddEventHandler に渡したフラグは SetEventHandlerFlags によって変更することができます。AddEventHandlerが返すハンドラ（ポインタ）は保存しておき、RemoveEventHandler によってイヴェントの監視を終了する際に同関数に渡さなければなりません。フラグが用意されている主な理由は、様々な種類のイヴェントを切り替えながら監視するための手段としてです（読む、書く、エラー）。
23+
24+[[doc:lcl/lclintf/removeeventhandler.html|RemoveEventHandler]] は、指定のハンドルの監視を停止します。引数として AHandler をとり、これには AddEventHandler が返したポインタを渡します。RemoveEventHandler は制御を返す前に AHandler を nil に設定します。
25+
26+[[doc:lcl/lclintf/seteventhandlerflags.html|SetEventHandlerFlags]] は、アクティヴなイヴェントハンドラへのフラグを変更します。現在の所、Windows では無効です（下記）が、他のプラットフォームでは利用されており、監視すべきイヴェントの種類を ON/OFF するための手段を提供しています。
27+
28+### Windows
29+
30+現在の実装では AddEventHandler の引数 AFlags は無視され、TWaitHandleEvent の AFlags の値は 0 になります。
31+
32+Win32 は次の種類のハンドルをサポートします。基本的に、MsgWaitForMultipleObjects がサポートするものです:
33+
34+- 変更通知 (ファイルとディレクトリの)
35+- コンソール入力
36+- イヴェント: SetEvent WinAPI 関数でシグナルされる
37+- ミューテックス: 所有されなくなるとシグナルされる
38+- プロセス: 終了するとシグナルされる
39+- セマフォ: *カウント*が 0 を超えるとシグナルされる
40+- スレッド: 終了するとシグナルされる
41+- タイマ: 指定時間経過後シグナルされる
42+
43+### Gtk/Unix
44+
45+AddEventHandler に渡される AFlags は、ハンドルがシグナルされるべき条件を指定します。指定可能な値は [glib](http://developer.gimp.org/api/2.0/glib/glib-IO-Channels.html#GIOCondition) 中の GIOCondition 型を参照のこと。
46+
47+コールバック関数（訳注: イヴェントハンドラ）側では、AFlags は上記の GIOCondition 型の中で満たされた条件を持ちます。
48+
49+GTK/UNIX は次の種類のハンドルをサポートします:
50+
51+- ファイル
52+- ソケット
53+- パイプ
54+
55+Win32 はソケットとパイプをサポートしないことに注意してください（少なくとも、MSDN の中で「推奨されない」利用法です）。提案: WSAEventSelect を使ってソケット関係のイヴェントを生成し、イヴェントハンドラに渡します。
56+
57+### Qt4
58+
59+Qt4 インターフェースは、内部的に Gtk や Win32 と異なっていますが、可能な限り GTK と同様に見えるように LCL 内でエミュレートされています。関数に渡すフラグもまた共通化されています (GIO_IN、GIO_OUT、GIO_ERR)。ユーザから見た事実上唯一の相違点は、同一のソケットにおいて、複数の種類のイヴェントが「同時に」生起しうることです。この場合、フラグを OR した一回の呼出しが行われるのではなく、複数回の呼出しが起こります。これは Qt4 の限界であり、READ や WRITE に先んじて EXCEPTION イヴェントが呼ばれてしまうのは避け難いと思われます。Qt4 インターフェースは Lazarus v0.9.29 で加えられました。
60+
61+### フラグ
62+
63+いまのところ、引数 AFlags はウィジェットセット依存です。上記のように、Windows ではこの引数は全く用いられていませんが、Gtk や Qt などほかのプラットフォームでは、監視すべきイヴェントの種類を指定するために用いられています。
64+
65+### パイプとプロセス終了
66+
67+クロスプラットフォームなソリューションのために、パイプ（Win32 のサポートが弱い）とプロセス（Gtk/Unix のサポートが弱い）について、追加の関数が用意されています:
68+
69+``` pascal
70+TChildExitReason = (cerExit, cerSignal);
71+TPipeReason = (prDataAvailable, prBroken, prCanWrite);
72+TPipeReasons = set of TPipeReason;
73+
74+TChildExitEvent = procedure(AData: PtrInt; AReason: TChildExitReason; AInfo: dword) of object;
75+TPipeEvent = procedure(AData: PtrInt; AReasons: TPipeReasons) of object;
76+
77+function AddProcessEventHandler(AHandle: THandle;
78+ AEventHandler: TChildExitEvent; AData: PtrInt): PProcessEventHandler;
79+procedure RemoveProcessEventHandler(var AHandler: PProcessEventHandler);
80+
81+function AddPipeEventHandler(AHandle: THandle;
82+ AEventHandler: TPipeEvent; AData: PtrInt): PPipeEventHandler;
83+procedure RemovePipeEventHandler(var AHandler: PPipeEventHandler);
84+```
85+
86+プロセスが終了すると、指定のイヴェントハンドラが呼ばれます。AReason が cerExit ならば、AInfo は終了コードを持っています。AReason が cerSignal なら、AInfo は終了シグナルです（UNIX に限る）。Gtk/Unix では、AHandle として監視対象の PID を用いてください。内部的に、SIGCHLD シグナルを捕捉するためのシグナルハンドラが導入されます。Win32 では、AddEventHandler がプロセス終了を監視するのに用いられます。
87+
88+パイプからの入力を監視する場合は、処理を行うためのイヴェントハンドラを AEventHandler に、ファイル識別子 (UNIX) あるいはパイプの read-end ハンドルを AHandler にして、AddPipeEventHandler に渡してください。Gtk/Unix では、AddEventHandler が呼び出され、ファイル識別子でのトラヒックを監視します。Win32 では、100 ミリ秒毎にメッセージループがタイムアウトして、監視対象のパイプを全て検査し、読み出せるデータがないか調べます。データがあれば、イヴェントハンドラが呼ばれます。
89+
90+## 関連項目
91+
92+- [[Asynchronous Calls/ja]]
93+- [[Multithreaded Application Tutorial/ja]]
94+
95+---
96+*From the Free Pascal wiki, page "Main Loop Hooks/ja", as it stood on 2020-02-19 after a change by Trev, out of the wiki's dump of 2024-05-26. Copyright stays with the author who wrote it, according to the old wiki's [[Licensing]] page. If you have concerns about this material, [message the admin](/wiki-contact).*

Back to history