other versions
- wheezy 4.1.0.20011224-6
XGrabKey(3X11) | XLIB FUNCTIONS | XGrabKey(3X11) |
名前¶
XGrabKey, XUngrabKey - キーボードのキーをグラブする
書式¶
XGrabKey( display, keycode, modifiers, grab_window, owner_events, pointer_mode,keyboard_mode)
Display * display;
int keycode;
unsigned int modifiers;
Window grab_window;
Bool owner_events;
int pointer_mode, keyboard_mode; XUngrabKey( display, keycode, modifiers, grab_window)
Display * display;
int keycode;
unsigned int modifiers;
Window grab_window;
引き数¶
- display
- X サーバへの接続を指定する。
- grab_window
- グラブウィンドウを指定する。
- keyboard_mode
- キーボードイベントの後処理を指定する。 GrabModeSync あるいは GrabModeAsync を指定できる。
- keycode
- KeyCode あるいは AnyKey を指定する。
- modifiers
- キーマスクの集合か AnyModifier を指定する。 このマスクは正しいキーマスクのビット値のビットごとの論理和を取ったもの である。
- owner_events
- キーボードイベントを通常通り報告するかどうかを示す真偽値を指定する。
- pointer_mode
- ポインタイベントの後処理を指定する。 GrabModeSync あるいは GrabModeAsync を渡せる。
説明¶
関数 XGrabKey はキーボードのパッシブなグラブを確立する。 将来に以下の条件が全て真になった場合、キーボードはアクティブにグラブされ( XGrabKeyboard によって)、最終キーボードグラブ時刻にキーが押された時刻がセットされ( KeyPress イベントで送られるように)、 KeyPress イベントが報告される。- •
- 指定されたモディファイアキーが論理的に押されており、他のどのモディファ イアキーも論理的には押されていない時、キーボードがグラブされておらず、 指定したキー(それ自体はモディファイアキーでも良い)が論理的に押されてい る。
- •
- grab_window がフォーカスウィンドウの祖先ウィンドウ(あるいはフォーカス ウィンドウ)であるか、grab_window がフォーカスウィンドウの子孫ウィンド ウであり、かつポインタを含んでいる。
- •
- 同じキーの組み合わせのパッシブなグラブが、 grab_window のどの祖先ウィン ドウにも存在しない。
返り値¶
- BadAccess
- 既に他のクライアントがグラブしているキー/ボタンの組み合わせをクライアント がグラブしようとした。
- BadValue
- 指定された数値の中にリクエストの許容範囲を越えているものがある。引き数 に対して特定の範囲が指定されていなければ、引き数の型で定義されている全 ての範囲が許される。選択肢として定義されている引き数はこのエラーを起こ すことがある。
- BadWindow
- 引き数 Window の値が、定義されている Window を指していない。
関連項目¶
XAllowAccess(3X11), XGrabButton(3X11), XGrabKeyboard(3X11), XGrabPointer(3X11)Release 6.5 | X Version 11 |