|
|
MyNmap 0.50 (Default branch)
08-20-2008
|
|
XSetPointerMapping(3X11) MIT X11R4 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 function sets the mapping of the pointer. If it succeeds, the X server generates a event, and returns Element map[i] defines the logi- cal button number for the physical button i+1. The length of the list must be the same as would return, or a error results. A zero ele- ment 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 error results. If any of the buttons to be altered are logically in the down state, returns and the mapping is not changed. can generate a error. The function returns the current mapping of the pointer. Pointer buttons are numbered starting from one. 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 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(3X11), XChangeKeyboardMapping(3X11) X Window System: The Complete Reference, Second Edition, Robert W. Scheifler and James Gettys XSetPointerMapping(3X11)