XSetPointerMapping(3) - NetBSD Manual Pages

XSetPointerMapping(3)                                    XSetPointerMapping(3)




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
The XSetPointerMapping function sets the mapping of the pointer. If it succeeds, the X server generates a MappingNotify event, and XSetPoint- erMapping 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 numbered starting from one. XGetPoint- erMapping 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(3), XChangeKeyboardMapping(3) Xlib - C Language X Interface XLIB FUNCTIONS X Version 11 XSetPointerMapping(3)

Powered by man-cgi (2024-08-26). Maintained for NetBSD by Kimmo Suominen. Based on man-cgi by Panagiotis Christias.