xsetpointermapping(3) [hpux man page]
XSetPointerMapping() XSetPointerMapping() Name XSetPointerMapping - 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. Description XSetPointerMapping() 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 ele- ment 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 ButtonPress 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 physical 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. XSetPointerMapping() generates a MappingNotify event when it returns Mapping- Success. Errors BadValue Two elements of map[] have same non-zero value. nmap not equal to XGetPointerMapping() return value. See Also XChangeActivePointerGrab(), XChangePointerControl(), XGetPointerControl(), XGetPointerMapping(), XGrabPointer(), XQueryPointer(), XUngrab- Pointer(), XWarpPointer(). Xlib - Pointer XSetPointerMapping()
Check Out this Related Man Page
XSetPointerMapping(3X11) XLIB FUNCTIONS XSetPointerMapping(3X11) NAME
XSetPointerMapping, XGetPointerMapping - manipulate pointer settings SYNTAX
int XSetPointerMapping(display, map, nmap) Display *display; unsigned char map[]; int nmap; int XGetPointerMapping(display, map_return, nmap) 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 XSet- PointerMapping 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 argu- ment 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 argu- ment, 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 Release 6.6 XSetPointerMapping(3X11)