XSetPointerMapping(3X11)

NAME
       XSetPointerMapping, XGetPointerMapping - manipulate
       pointer settings

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

       int XGetPointerMapping(display, map_return, nmap)
             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
       MappingSuccess.  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 BadValue 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