XtGrabKey(3Xt)

名前
XtGrabKey, XtUngrabKey, 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 関数の呼び出しに渡す引き数を指定する。

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

•   モーダルカスケードがあり、ウィジェットがカスケードのアクティブなサブセッ トではなく、キーボードが以前にグラブされていない。

•   が を返した。

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

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

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

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

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

•   が を返した。

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

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

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

関連項目
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface