XSetPointerMapping(3)     XLIB FUNCTIONS    XSetPointerMapping(3)



NAME
       XSetPointerMapping, XGetPointerMapping - manipulate
       pointer settings

SYNTAX
       int XSetPointerMapping(Display *display, unsigned char
              map[], int nmap);

       int XGetPointerMapping(Display *display, unsigned char
              map_return[], int nmap);

ARGUMENTS
       display   Specifies the connection to the X server.

       map       Specifies the mapping list.

       map_return
                 Returns the mapping list.

       nmap      Specifies the number of items in the mapping
                 list.

DESCRIPTION
       The XSetPointerMapping function sets the mapping of the
       pointer.  If it succeeds, the X server generates a Map-
       pingNotify event, and XSetPointerMapping returns Mapping-
       Success.  Element map[i] defines the logical button number
       for the physical button i+1.  The length of the list must
       be the same as XGetPointerMapping would return, or a Bad-
       Value error results.  A zero element disables a button,
       and elements are not restricted in value by the number of
       physical buttons.  However, no two elements can have the
       same nonzero value, or a BadValue error results.  If any
       of the buttons to be altered are logically in the down
       state, XSetPointerMapping returns MappingBusy, and the
       mapping is not changed.

       XSetPointerMapping can generate a BadValue error.

       The XGetPointerMapping function returns the current map-
       ping of the pointer.  Pointer buttons are numbered start-
       ing from one.  XGetPointerMapping returns the number of
       physical buttons actually on the pointer.  The nominal
       mapping for a pointer is map[i]=i+1.  The nmap argument
       specifies the length of the array where the pointer map-
       ping is returned, and only the first nmap elements are
       returned in map_return.

DIAGNOSTICS
       BadValue  Some numeric value falls outside the range of
                 values accepted by the request.  Unless a spe-
                 cific range is specified for an argument, the
                 full range defined by the argument's type is
                 accepted.  Any argument defined as a set of
                 alternatives can generate this error.

SEE ALSO
       XChangeKeyboardControl(3X11), XChangeKeyboardMapping(3X11)
       Xlib - C Language X Interface



X Version 11               libX11 1.1.5     XSetPointerMapping(3)