1XSelectInput(3) XLIB FUNCTIONS XSelectInput(3)
2
3
4
6 XSelectInput - select input events
7
9 int XSelectInput(Display *display, Window w, long event_mask);
10
12 display Specifies the connection to the X server.
13
14 event_mask
15 Specifies the event mask.
16
17 w Specifies the window whose events you are interested in.
18
20 The XSelectInput function requests that the X server report the events
21 associated with the specified event mask. Initially, X will not report
22 any of these events. Events are reported relative to a window. If a
23 window is not interested in a device event, it usually propagates to
24 the closest ancestor that is interested, unless the do_not_propagate
25 mask prohibits it.
26
27 Setting the event-mask attribute of a window overrides any previous
28 call for the same window but not for other clients. Multiple clients
29 can select for the same events on the same window with the following
30 restrictions:
31
32 · Multiple clients can select events on the same window because
33 their event masks are disjoint. When the X server generates an
34 event, it reports it to all interested clients.
35
36 · Only one client at a time can select CirculateRequest, Configur‐
37 eRequest, or MapRequest events, which are associated with the
38 event mask SubstructureRedirectMask.
39
40 · Only one client at a time can select a ResizeRequest event, which
41 is associated with the event mask ResizeRedirectMask.
42
43 · Only one client at a time can select a ButtonPress event, which is
44 associated with the event mask ButtonPressMask.
45
46 The server reports the event to all interested clients.
47
48 XSelectInput can generate a BadWindow error.
49
51 BadWindow A value for a Window argument does not name a defined Window.
52
54 Xlib - C Language X Interface
55
56
57
58X Version 11 libX11 1.6.4 XSelectInput(3)