XSelectInput

Syntax

XSelectInput(display, w, event_mask)
      Display *display;
      Window w;
      long event_mask;

Arguments

display Specifies the connection to the X server.
X サーバへの接続を指定する。
w Specifies the window whose events you are interested in.
ウィンドウを指定する。このウィンドウが受け取るイベントに注目する。
event_mask Specifies the event mask.
イベントマスクを指定する。

Description

The XSelectInput() function requests that the X server report the events associated with the specified event mask. Initially, X will not report any of these events. Events are reported relative to a window. If a window is not interested in a device event, it usually propagates to the closest ancestor that is interested, unless the do_not_propagate mask prohibits it.
XSelectInput()は指定されたイベントマスクに対応するイベントを X サーバが通知することを要求する。 最初は X はこれらのイベントを全く通知しない。 イベントはウィンドウに関して通知される。 ウィンドウがデバイスイベントに注目していなければ、 デバイスイベントは通常デバイスイベントに注目している最も近い祖先ウィンドウに伝播する。 ただし do_not_propagate マスクによって禁止されている場合には伝播は行われない。

Setting the event-mask attribute of a window overrides any previous call for the same window but not for other clients. Multiple clients can select for the same events on the same window with the following restrictions:
あるウィンドウの イベントマスク 属性を設定すると同じウィンドウに対する以前の設定は全て上書きされるが、 他のウィンドウに対する設定は上書きされない。 以下の制限の下で同じウィンドウ上の同じイベントを複数のクライアントで受け取ることができる:

The server reports the event to all interested clients.
サーバはそのイベントに注目している全てのクライアントに通知を行う。

XSelectInput() can generate a BadWindow error.
関数 XSelectInput()はエラーBadWindowを生成することがある。

Diagnostics

BadWindow A value for a Window argument does not name a defined Window.

See also

"Selecting Events".
Christophe Tronche, ch.tronche@computer.org