名称

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

形式

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

引数

displayX サーバへのコネクションを指定します。

event_maskイベントマスクを指定します。

w関心をもっているイベントが存在する ウィンドウを指定します。

解説

XSelectInput 関数は、X サーバが、指定されたイベントマスクと対応するイベントを 通知することを要求します。 最初は、X は、これらのイベントを何も通知しません。 イベントは、ウィンドウに相対して通知されます。 ウィンドウが、device イベントに興味を示さない場合は、 それは一般に、do_not_propagate マスクがそれを禁じない限りは、 興味を示す一番近い子孫へ転送されます。 ウィンドウのイベントマスク属性を設定すると、同じウィンドウの以前の 呼び出しをオーバライドするが、 他のクライアントの呼び出しはオーバライドしません。 複数のクライアントが、次の制限付きで、同じウィンドウ上に同じイベント を選択することができます。

•クライアントのイベントマスクは、分離しているので、 複数のクライアントが、同一のウィンドウ上のイベントを選択できる。 X サーバがイベントを発生するときは、そのイベントをすべての興味をもつ クライアントに通知する。

•たった 1 つのクライアントだけが、一度に、 CirculateRequest、 ConfigureRequest または MapRequest イベントを選択でき、 それは、イベントマスク SubstructureRedirectMask と対応する。

•たった 1 つのクライアントだけが、一度に、 ResizeRequest イベントを選択でき、 それは、イベントマスク ResizeRedirectMask と対応する。

•たった 1 つのクライアントだけが、一度に ButtonPress イベントを選択でき、 それは、イベントマスク ButtonPressMask と対応する。 サーバは、イベントを、興味を示すすべてのクライアントに通知します。 XSelectInput は、 BadWindow エラーを生じることがあります。

診断

BadWindow
Window 引数の値が、定義された Window を指さない。

関連事項

Xlib − C Language X Interface
 

NEWS-OSRelease 4.2.1R