XSetPointerMapping(3X11)  XLIB FUNCTIONS XSetPointerMapping(3X11)


NAME
       XSetPointerMapping, XGetPointerMapping - manipulate
       pointer settings

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

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

ARGUMENTS
       display   Specifies the connection to the X server.

       map       Specifies the mapping list.

       mapreturn
                 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



X Version 11                Release 5                           1

XSetPointerMapping(3X11)  XLIB FUNCTIONS XSetPointerMapping(3X11)


                 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                Release 5                           2