XtUngrabKey(3) グラブを管理する

Other Alias

XtGrabKey, XtGrabKeyboard, XtUngrabKeyboard, XtGrabButton, XtUngrabButton, XtGrabPointer, XtUngrabPointer

書式

void XtGrabKey(widget, keycode, modifiers, owner_events, pointer_mode, keyboard_mode)

      Widget widget;

      KeyCode keycode;

      Modifiers modifiers;

      Boolean owner_events;

      int pointer_mode;

      int keyboard_mode;

void XtUngrabKey(widget, keycode, modifiers)

      Widget widget;

      KeyCode keycode;

      Modifiers modifiers;

int XtGrabKeyboard(widget, owner_events, pointer_mode, keyboard_mode, time)

      Widget widget;

      Boolean owner_events;

      int pointer_mode;

      int keyboard_mode;

      Time time;

void XtUngrabKeyboard(widget, time)

      Widget widget;

      Time time;

void XtGrabButton(widget, button, modifiers, owner_events, event_mask, pointer_mode, keyboard_mode, confine_to, cursor)

      Widget widget;

      int button;

      Modifiers modifiers;

      Boolean owner_events;

      unsigned int event_mask;

      int pointer_mode;

      int keyboard_mode;

      Window confine_to;

      Cursor cursor;

void XtUngrabButton(widget, button, modifiers)

      Widget widget;

      KeyCode button;

      Modifiers modifiers;

int XtGrabPointer(widget, owner_events, event_mask, pointer_mode, keyboard_mode, confine_to, cursor, time)

      Widget widget;

      Boolean owner_events;

      unsigned int event_mask;

      int pointer_mode;

      int keyboard_mode;

      Window confine_to;

      Cursor cursor;

      Time time;

void XtUngrabPointer(widget, time)

      Widget widget;

      Time time;

引き数

widget
グラブが起こるウィンドウを持つウィジェットを指定する。 Core クラスかそのサブクラスでなければならない。

keycode

modifiers

owner_events

pointer_mode

keyboard_mode

time

button

confine_to

cursor
対応する Xlib 関数の呼び出しに渡す引き数を指定する。

説明

XtGrabKey は、ウィジェットがリアライズされているならば、そのウィジェットのウィン ドウをグラブウィンドウに指定して XGrabKey を呼び出す。残りの引き数については、 XGrabKey と全く同じである。 ウィジェットがリアライズされていない場合、または後でリアライズ解除され た場合、(再び)ウィジェットがリアライズされ、そのウィンドウがマップされ たときに XGrabKey が呼び出される。後で 指定したキーコードとモディファイアにマッチする(キーコードは AnyKey ,モディファイアは AnyModifier でも良い) KeyPress を使って XtDispatchEvent が呼び出された場合、以下の条件のいずれかが成り立つならば、イントリンシ クスは KeyPress イベントから得たタイムスタンプを使って XtUngrabKeyboard を呼び出す:
  • モーダルカスケードがあり、ウィジェットがカスケードのアクティブなサブセッ トではなく、キーボードが以前にグラブされていない。
  • XFilterEventTrue を返した。

XtUngrabKey は、指定したウィジェットがリアライズされていれば、そのウィンドウをグラ ブ解除ウィンドウに指定して XUngrabKey を呼び出す。残りの引き数については、 XUngrabKey と全く同じである。 ウィジェットがリアライズされていない場合、 指定されたウィジェット、キーコード、モディファイアに対して 保留されている XtGrabKey リクエストがあれば、 XtUngrabKey はこれを削除する。

指定したウィジェットがリアライズされていれば、 XtGrabKeyboard はこのウィジェットのウィンドウをグラブウィンドウに指定して XGrabKeyboard を呼び出す。残りの引き数と返り値については XGrabKeyboard と全く同じである。 このウィジェットがリアライズされていない場合、 XtGrabKeyboard は即座に GrabNotViewable を返す。 XtGrabKeyboard は将来のグラブ解除を指定しない。

XtUngrabKeyboard は、指定した時刻を使って XUngrabKeyboard を呼び出す。

XtGrabButton は、指定したウィンドウがリアライズされていれば、このウィンドウをグラブ ウィンドウに指定して XGrabButton を呼び出す。残りの引き数については XGrabButton と全く同じである。 ウィジェットがリアライズされていない場合、または後でリアライズ解除され た場合、(再び)ウィジェットがリアライズされ、そのウィンドウがマップされ たときに XGrabButton が呼び出される。後で 指定したボタンとモディファイアにマッチする(ボタンは AnyButton ,モディファイアは AnyModifier でも良い) ButtonPress を使って XtDispatchEvent が呼び出された場合、以下の条件のいずれかが成り立つならば、イントリンシ クスは KeyPress イベントから得たタイムスタンプを使って XtUngrabPointer を呼び出す:

  • モーダルカスケードがあり、ウィジェットがカスケードのアクティブなサブセッ トではなく、ポインタが以前にグラブされていない。
  • XFilterEventTrue を返した。

XtUngrabButton は、指定したウィジェットがリアライズされていれば、そのウィンドウをグラ ブ解除ウィンドウに指定して XUngrabButton を呼び出す。残りの引き数については、 XUngrabButton と全く同じである。 ウィジェットがリアライズされていない場合、 指定されたウィジェット、ボタン、モディファイアに対して 保留されている XtGrabButton リクエストがあれば、 XtUngrabButton はこれを削除する。

指定したウィジェットがリアライズされていれば、 XtGrabPointer はこのウィジェットのウィンドウをグラブウィンドウに指定して XGrabPointer を呼び出す。残りの引き数と返り値については XGrabKeyboard と全く同じである。 このウィジェットがリアライズされていない場合、 XtGrabPointer は即座に GrabNotViewable を返す。 XtGrabPointer は将来のグラブ解除を指定しない。

XtUngrabPointer は、指定した時刻を使って XUngrabPointer を呼び出す。