書式

Bool XFilterEvent(event, w)

      XEvent *event;

      Window w;

引き数

event

フィルタするイベントを指定する。

w

フィルタが適用されるウィンドウを指定する。

説明

ウィンドウを表す引き数が None であれば、 XFilterEvent は XEvent 構造体で指定されているウィンドウにフィルタを適用する。 引き数 window を与える目的は、Xlib より上にあってイベントの リダイレクションを行う 層がリダイレクト済みのウィンドウを指示できるよ うにすることである。

XFilterEvent が True を返した場合、何らかの入力メソッドがイベントをフィルタリングしているので、 クライアントはそのイベントを破棄すべきである。 XFilterEvent が False を返した場合、クライアントはイベントの処理を続けるべきである。

クライアントでグラブが起こり、 XFilterEvent が True を返した場合には、クライアントはキーボードのグラブを解放しなければなら ない。