XSetPointerMapping(3X)                     XSetPointerMapping(3X)



NAME
     XSetPointerMapping, XGetPointerMapping - get and set pointer
     settings

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

     int XGetPointerMapping (display, map-return, nmap)
     Display *display;
     unsigned char map[];
     int nmap;

DESCRIPTION
     The XSetPointerMapping function sets the mapping of the
     pointer and causes the X server to generate a MappingNotify
     event on a status of 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.

     The XGetPointerMapping function returns the current mapping
     of the pointer.  Pointer buttons are numbered starting from
     one.  XGetPointerMapping returns the number of physical but-
     tons 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.

   Arguments
     These functions accept the following 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.






November, 1990                                                  1

XSetPointerMapping(3X)                     XSetPointerMapping(3X)



ERRORS
     BadValue
             A numeric value falls outside the range of values
             accepted by the request.  Unless a range is speci-
             fied 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.

     The XSetPointerMapping function can generate a
     BadValue error.

SEE ALSO
     XChangeKeyboardControl(3X), XChangeKeyboardMapping(3X)

     Xlib - C Language Interface









































2                                                  November, 1990