XSetPointerMapping(3X11) XLIB FUNCTIONS XSetPointerMapping(3X11)
NAME
XSetPointerMapping, XGetPointerMapping - manipulate pointer
settings
SYNTAX
int XSetPointerMapping(Display *display, 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 MappingNo-
tify event, and XSetPointerMapping 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. XGetPointerMapping returns the number of physical but-
tons 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 gen-
erate this error.
XFree86 Version 4.5.0 1
XSetPointerMapping(3X11) XLIB FUNCTIONS XSetPointerMapping(3X11)
SEE ALSO
XChangeKeyboardControl(3X11), XChangeKeyboardMapping(3X11)
Xlib - C Language X Interface
XFree86 Version 4.5.0 2