名称

XIfEvent, XCheckIfEvent, XPeekIfEvent − 宣言した手続きでキューをチェックする

形式

XIfEvent(display, event_return, predicate, arg)
      Display ∗display;
      XEvent ∗event_return;
      Bool (∗predicate)();
      char ∗arg; Bool XCheckIfEvent(display, event_return, predicate, arg)
      Display ∗display;
      XEvent ∗event_return;
      Bool (∗predicate)();
      char ∗arg; XPeekIfEvent(display, event_return, predicate, arg)
      Display ∗display;
      XEvent ∗event_return;
      Bool (∗predicate)();
      char ∗arg;

引数

arg宣言した手続きに渡すユーザが与えた引数を指定します。

displayX サーバへのコネクションを指定します。

event_return一致したイベントに対応した構造体を返します。  一致したイベントのコピーまたは

predicateキューの次のイベントが希望するものと一致したか否か判断するため コールされる手続きを指定します。

解説

XIfEvent 関数は、キューのイベントが一致して、そのイベントについて指定された 宣言されている手続きが True を返した場合にだけ、終了します。 XIfEvent は、以後のイベントを待ってブロックする場合、出力バッファをフラッシュします。 XIfEvent は、キューから一致するイベントを削除し、 構造体をクライアントが与えた XEvent 構造体にコピーします。 宣言されている手続きが一致するものを見つけた場合、 XCheckIfEvent は一致するイベントをクライアントが与えた XEvent 構造体にコピーし、 True を返します ( このイベントは、キューから削除されます ) 。 一致するものがなければ、 XCheckIfEvent は False を返し、出力バッファはフラッシュされます。 キューにストアされた初期のすべてのイベントは削除されません。 XPeekIfEvent 関数は、指定された宣言されている手続きがそのイベントについて True を返す場合にだけ、終了します。 宣言されている手続きが一致するものを見つけた場合、 XPeekIfEvent は、キューからイベントを削除することなしに、 一致したイベントをクライアントの与えた XEvent 構造体にコピーします。 XPeekIfEvent は、以後のイベントを待ってブロックする場合、出力バッファをフラッシュ します。

関連事項

XPutBackEvent(3X11) XNextEvent(3X11), XSendEvent(3X11)
Xlib − C Language X Interface

NEWS-OSRelease 3.3