XSelectInput

Section: XLIB FUNCTIONS (3X11)
Updated: Release 6.6
索引 xjman

名前

XSelectInput - 入力イベントを選択する

書式

XSelectInput(display, w, event_mask)

      Display *display;

      Window w;

      long event_mask;

引き数

display: X サーバへの接続を指定する。
event_mask: イベントマスクを指定する。注目するイベントが起きる
w: ウィンドウを指定する。

説明

関数 XSelectInput は、指定したイベントマスクに関連するイベントを通知するように X サーバに要求する。初期状態では、X サーバはこのようなイベントは一切通知しない。イベントはウィンドウに関連づけて通知される。ウィンドウがデバイスイベントに注目していなければ、このイベントは通常、そのイベントに注目している最も近い祖先ウィンドウに伝播する。

ウィンドウのイベントマスク属性の設定により、同じウィンドウに対する以前の設定を上書きできるが、他のクライアントのものは上書きできない。以下の制限付きで、複数クライアントが同じウィンドウの同じイベントを選択することができる。

*: 複数クライアントが同じウィンドウのイベントを選択できるのは、イベントマスクが互いに共通部分を持たないからである。 X サーバがイベントを生成したとき、そのイベントに注目する全てのクライアントに通知される。
*: 同時に1つのクライアントだけが CirculateRequest, ConfigureRequest, MapRequest イベントを選択できる。これらはイベントマスク SubstructureRedirectMask に関連づけられている。
*: 同時に1つのクライアントだけが ResizeRequest イベントを選択できる。これはイベントマスク ResizeRedirectMask に関連づけられている。
*: 同時に1つのクライアントだけが ButtonPress イベントを選択できる。これはイベントマスク ButtonPressMask に関連づけられている。

サーバはイベントに注目している全てのクライアントにイベントを通知する。

XSelectInput はエラー BadWindow を起こすことがある。

返り値

BadWindow: 引き数 Window の値が、定義されている Window を示していない。

jman

Time: 07:00:53 GMT, January 12, 2009

XSelectInput

名前

書式

引き数

説明

返り値

関連項目

Index