NAME¶

XSetPointerMapping, XGetPointerMapping - manipulate pointer settings

SYNTAX¶

int XSetPointerMapping(Display *display, _Xconst 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¶

TheXSetPointerMappingfunction sets the mapping of the pointer.If it succeeds, the X server generates aMappingNotifyevent, andXSetPointerMappingreturnsMappingSuccess.Element map[i] defines the logical button number for the physical buttoni+1.The length of the list must be the same asXGetPointerMappingwould return,or aBadValueerror results.A zero element disables a button, and elements are not restricted invalue by the number of physical buttons.However, no two elements can have the same nonzero value,or aBadValueerror results.If any of the buttons to be altered are logically in the down state,XSetPointerMappingreturnsMappingBusy,and the mapping is not changed.

XSetPointerMappingcan generate aBadValueerror.

TheXGetPointerMappingfunction returns the current mapping of the pointer.Pointer buttons are numbered starting from one.XGetPointerMappingreturns 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 pointermapping is returned, and only the first nmap elements are returnedin 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 definedby the argument's type is accepted.Any argument defined as a set ofalternatives can generate this error.

SEE ALSO¶

XChangeKeyboardControl(3),XChangeKeyboardMapping(3)
Xlib - C Language X Interface