1XSelectInput(3)                 XLIB FUNCTIONS                 XSelectInput(3)
2
3
4

NAME

6       XSelectInput - select input events
7

SYNTAX

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

ARGUMENTS

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

DESCRIPTION

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

DIAGNOSTICS

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

SEE ALSO

54       Xlib - C Language X Interface
55
56
57
58X Version 11                     libX11 1.7.2                  XSelectInput(3)
Impressum