This manual page is for Mac OS X version 10.6.3

Reading manual pages

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 gener-ates generates
       ates a MappingNotify 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 mapping of the pointer.  Pointer buttons are num-bered numbered
       bered starting 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 mapping 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
                 specific 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.2.1                           XSetPointerMapping(3)