Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ XSInput(XS) — OpenDesktop Software Development System 3.0.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought


 XSelectInput(XS)  X Version 11 (Release 5) 6 January 1993   XSelectInput(XS)


 Name

    XSelectInput - select input events

 Syntax


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


 Arguments


    display      Specifies the connection to the X server.

    eventmask   Specifies the event mask.

    w            Specifies the window whose events you are interested in.

 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 donotpropagate mask
    prohibits it.

    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 restric-
    tions:

    +  Multiple clients can select events on the same window because their
       event masks are disjoint.  When the X server generates an event, it
       reports it to all interested clients.

    +  Only one client at a time can select CirculateRequest, Config-
       ureRequest, or MapRequest events, which are associated with the event
       mask SubstructureRedirectMask.

    +  Only one client at a time can select a ResizeRequest event, which is
       associated with the event mask ResizeRedirectMask.

    +  Only one client at a time can select a ButtonPress event, which is
       associated with the event mask ButtonPressMask.

    The server reports the event to all interested clients.

    XSelectInput can generate a ``BadWindow'' error.

 Diagnostics


    ``BadWindow''  A value for a Window argument does not name a defined Win-
                   dow.

 See also

    Xlib - C Language X Interface


Typewritten Software • bear@typewritten.org • Edmonds, WA 98026