名称

XtGrabKeyboard — メインキーボードの制御を能動的に占有する関数

形式

#include <X11/PassivGrab.h> int XtGrabKeyboard (widget, owner_events, pointer_mode, keyboard_mode, time )
Widgetwidget ;
Booleanowner_events ;
intpointer_mode ;
intkeyboard_mode ;
Timetime ;

解説

XtGrabKeyboard は、メインキーボードの制御を能動的に占有します。 占有が成功した場合、定数 GrabSuccess を返します。 それ以降のキーイベントはグラブ widget に報告されます。

widgetXtGrabKeyboard 呼び出しに対するルート widget を指定します。 他のサブウィンドウにディスパッチされていた全てのキーイベントは、owner events に従って、ディスパッチされるようになります。

owner_eventsマウスポインタイベントが通常に報告されるか (True を渡す)、あるいはグラブウィンドウに関してはイベントマスクによって選択されるか (False を渡す) を指定します。

pointer_modeマウスポインタイベントをさらに処理することを指定します。 GrabModeSync あるいは GrabModeAsync を渡すことができます。

keyboard_modeキーボードイベントをさらに処理することを指定します。 GrabModeSync あるいは GrabModeAsync を渡すことができます。

time時間を指定します。 ミリ秒単位のタイムスタンプ、あるいは CurrentTime のいずれかを渡すことができます。

リターン値

定数 GrabSuccess を返します。

関連事項

XtUngrabKeyboard(3XM)

NEWS-OSRelease 4.1C