XSelectInput

Section: XLIB FUNCTIONS (3X11)
Updated: Release 6.3
Index xjman/web INDEX

名前

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 を示していない。

This document was created by man2html, using the manual pages.
Time: 15:55:57 GMT, February 12, 2001

XSelectInput

名前

書式

引き数

説明

返り値

関連項目

Index