XSetPointerMapping()XSetPointerMapping()NameXSetPointerMapping – set the pointer button mapping.
Synopsis
int XSetPointerMapping(display, map, nmap)
Display *display;
unsigned char map[];
int nmap;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
map Specifies the mapping list.
nmap Specifies the number of items in the mapping list.
Returns
MappingSuccess on success; MappingBusy on failure.
DescriptionXSetPointerMapping() sets the mapping of the pointer buttons. Elements
of the map list are indexed starting from 1. The length of the list
nmap must be the same as XGetPointerMapping() returns (you must call
that first). The index is a physical button number, and the element of
the list defines the effective button number. In other words, if
map[2] is set to 1, when the second physical button is pressed, a But‐
tonPress event will be generated if Button1Mask was selected but not if
Button2Mask was selected. The button member in the event will read
Button1.
No two elements can have the same non-zero value (else a BadValue
error). A value of zero for an element of map disables a button, and
values for elements are not restricted in value by the number of physi‐
cal buttons. If any of the buttons to be altered are currently in the
down state, the returned value is MappingBusy and the mapping is not
changed.
This function returns either MappingSuccess or MappingBusy. XSetPoint‐
erMapping() generates a MappingNotify event when it returns MappingSuc‐
cess.
Errors
BadValue Two elements of map[] have same non-zero value.
nmap not equal to XGetPointerMapping() return value.
See AlsoXChangeActivePointerGrab(), XChangePointerControl(), XGetPointerCon‐
trol(), XGetPointerMapping(), XGrabPointer(), XQueryPointer(), XUngrab‐
Pointer(), XWarpPointer().
Xlib - Pointer XSetPointerMapping()
