XSetPointerMapping(3X11) X11R5 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 element
disables a button, and elements are not restricted in value by the num‐
ber 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 but‐
tons 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 ALSOXChangeKeyboardControl(3X11), XChangeKeyboardMapping(3X11)
Xlib - C Language X Interface
XSetPointerMapping(3X11)