other versions
- wheezy 4.1.0.20011224-6
XGrabDeviceKey(3X11) | X FUNCTIONS | XGrabDeviceKey(3X11) |
名前¶
XGrabDeviceKey, XUngrabDeviceKey - 拡張入力デバイス・キーのグラブ/グラブ解放を行なう
書式¶
XGrabDeviceKey( display, device, Key, modifiers, modifier_device, grab_window, owner_events,Display * display;
XDevice * device;
unsigned int Key;
unsigned int modifiers;
XDevice * modifier_device;
Window grab_window;
Bool owner_events;
unsigned int event_count;
XEventClass event_list;
int this_device_mode, other_devices_mode;
Display * display;
XDevice * device;
unsigned int Key;
unsigned int modifiers;
XDevice * modifier_device;
Window grab_window;
引き数¶
- display
- X サーバへの接続を指定する。
- device
- グラブあるいは解放するデバイスを指定する。
- Key
- グラブあるいは解放するデバイスのボタンを指定する。 または AnyButton を指定する。
- modifiers
- キーマスク値か AnyModifier を指定する。 マスク値は、有効なキーマスクビット値のビットごとの論理和を取ったもので ある。有効なビットは次のものである: ShiftMask, LockMask, ControlMask, Mod1Mask, Mod2Mask, Mod3Mask, Mod4Mask, Mod5Mask.
- modifier_device
- モディファイアが使用されるデバイスを指定する。modifier_device が NULL の場 合、X のキーボードが modifier_device として使用される。
- grab_window
- グラブウィンドウを指定する。
- owner_events
- デバイスのイベントを通常通り報告するか、イベントリストで選択されている ならばグラブウィンドウに関して報告するかを示す真偽値を指定する。
- event_count
- イベントリストに含まれるイベント数を指定する。
- event_list
- クライアントに報告するイベントを指定する。
- this_device_mode
- デバイスから受け取ったイベントの後処理を指定する。 GrabModeSync または GrabModeAsync を指定する。
- other_devices_mode
- 他の全てのデバイスから受け取ったイベントの後処理を指定する。 GrabModeSync または GrabModeAsync を指定する。
説明¶
XGrabDeviceKey はパッシブなグラブを確立する。 後で以下の条件が全て満たされたならば、デバイスはアクティブにグラブされ ( XGrabDevice の場合のように)、最終デバイスグラブ時刻にキーが押さ れた時刻がセットされ( DeviceKeyPress イベントで送られる)、 DeviceKeyPress イベントが報告される。- •
- 指定されたモディファイアデバイス上の指定されたモディファイアキーが論理 的に押されており、他のキーやモディファイアキーはどれも論理的に押されて いないとき、デバイスがグラブされておらず、指定されたキーが論理的に押さ れている。
- •
- grab_window がフォーカスウィンドウかその祖先ウィンドウである。あるいは、 grab_window がフォーカスウィンドウであり、このデバイスを含んでいる。
- •
- confine_window(もしあれば)が表示可能である。
- •
- 同じキー/モディファイアの組合せにおけるパッシブなグラブが、grab_window のどの祖先ウィンドウ上にも存在しない。
返り値¶
- BadDevice
- 不正なデバイスが指定された。指定されたデバイスが存在しないか、クライア ントが XOpenInputDevice を使ってオープンしていない。このエラーは 指定したデバイスが、X のキーボードデバイスや X のポインタデバイスであ る場合にも起こる。
- BadMatch
- このエラーは、キーのないデバイスを指定して XGrabDeviceKey リクエ ストを行った場合や、キーを持たないモディファイアデバイスを指定した場合 に起こる。
- BadValue
- 指定された数値に、リクエストの許容範囲を越えているものがある。引き数に対 して特定の範囲が指定されていなければ、引き数の型で定義されている全ての範 囲が許される。選択肢として定義されている引き数はこのエラーを起こすことが ある。
- BadWindow
- 引き数 Window の値が、定義されている Window を指していない。
関連項目¶
XAllowDeviceEvents(3X),Release 6.5 | X Version 11 |