名称

XNextEvent, XPeekEvent, XWindowEvent, XCheckWindowEvent, XMaskEvent, XCheckMaskEvent, XCheckTypedEvent, XCheckTypedWindowEvent − 型によりイベントを選択する

形式

XNextEvent(display, event_return)
      Display ∗display;
      XEvent ∗event_return; XPeekEvent(display, event_return)
      Display ∗display;
      XEvent ∗event_return; XWindowEvent(display, w, event_mask, event_return)
      Display ∗display;
      Window w;
      long event_mask;
      XEvent ∗event_return; Bool XCheckWindowEvent(display, w, event_mask, event_return)
      Display ∗display;
      Window w;
      long event_mask;
      XEvent ∗event_return; XMaskEvent(display, event_mask, event_return)
      Display ∗display;
      long event_mask;
      XEvent ∗event_return; Bool XCheckMaskEvent(display, event_mask, event_return)
      Display ∗display;
      long event_mask;
      XEvent ∗event_return; Bool XCheckTypedEvent(display, event_type, event_return)
      Display ∗display;
      int event_type;
      XEvent ∗event_return; Bool XCheckTypedWindowEvent(display, w, event_type, event_return)
      Display ∗display;
      Window w;
      int event_type;
      XEvent ∗event_return;

引数

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

event_maskイベントマスクを指定します。

event_return一致したイベントの対応する構造体を返します。

event_returnキュー中の次のイベントを返します。

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

event_type比較するイベントの型を指定します。

wそのイベントの関心をもたれている ウィンドウを指定します 。

解説

XNextEvent 関数は、最初のイベントをイベントキューから指定された XEvent 構造体へコピーし、それから、キューから最初のイベントを削除します。 イベントキューが空の場合、 XNextEvent は、出力バッファをフラッシュし、イベントが受信されるまでブロックします。 XPeekEvent 関数は、最初のイベントを、イベントキューから返します。 しかし、キューからは、そのイベントは削除されません。 キューが空の場合、 XPeekEvent は、出力バッファをフラッシュし、イベントが受信されるまでブロックします。 それから XEvent は、イベントキューからイベントを削除することなしに、 イベントをクライアントが与える XEvent 構造体へコピーします。 XWindowEvent 関数は、指定されたウィンドウとイベントマスクの両方に一致するイベントを イベントキューから検索します。 その一致するイベントを発見したときは、 XWindowEvent は、そのイベントをキューから削除し、それを指定された XEvent 構造体へコピーします。 キューにストアされている他のイベントは、削除されません。 一致するイベントがキュー中にない場合は、 XWindowEvent は、出力バッファをフラッシュし、一致するイベントが受信されるまで ブロックします。 XCheckWindowEvent 関数は、イベントキューおよびサーバコネクションで利用可能なすべての イベントから、指定されたウィンドウとイベントマスクに一致する最初の イベントを検索します。 一致するイベントを発見した場合は、 XCheckWindowEvent は、そのイベントを削除し、それを指定された XEvent 構造体へコピーし、 True を返します。 そのキュー中にストアされている他のイベントは削除されません。 要求したイベントが利用できない場合は、 XCheckWindowEvent は、 False を返し、 出力バッファをフラッシュします。 XMaskEvent 関数は、指定されたマスクと対応するイベントをイベントキューから 検索します。 一致するイベントを発見した時、 XMaskEvent は、そのイベントを削除し、それを指定された XEvent 構造体へコピーします。 そのキュー中にストアされている他のイベントは削除されません。 要求したイベントが、キュー中にない場合、 XMaskEvent は、出力バッファをフラッシュし、一致するイベントが受信されるまでブロックします。 XCheckMaskEvent 関数は、イベントキューおよび、サーバコネクションで利用可能なすべての イベントから、指定されたマスクに一致する最初のイベントを検索します。 一致するイベントを発見した場合は、 XCheckMaskEvent は、そのイベントを削除し、それを指定された XEvent 構造体にコピーし、 True を返します。 そのキュー中にストアされている他のイベントは、削除されません。 要求したイベントが利用できない場合、 XCheckMaskEvent は、 False を返し、 出力バッファをフラッシュします。 XCheckTypedEvent 関数は、イベントキューおよびサーバコネクションで利用可能なすべての イベントから、指定された型に一致する最初のイベントを検索します。 一致するイベントを発見した場合は、 XCheckTypedEvent は、そのイベントを削除し、それを指定された XEvent 構造体にコピーし、 True を返します。 キュー中にある他のイベントは、削除されません。 そのイベントが利用できない場合は、 XCheckTypedEvent は False を返し、 出力バッファをフラッシュします。 XCheckTypedWindowEvent 関数は、イベントキューおよびサーバコネクションで利用可能なすべての イベントから、指定された型とウィンドウに一致する最初のイベントを検索します。 一致するイベントを発見した場合、 XCheckTypedWindowEvent は、そのイベントを、キューから削除し、それを指定された XEvent 構造体へコピーし、 True を返します。 キュー中の他のイベントは、削除されません。 イベントが利用できない場合は、 XCheckTypedWindowEvent は、 False を返し、出力バッファをフラッシュします。

関連事項

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

NEWS-OSRelease 4.2.1R