Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
XSetPointerMapping(3)		XLIB FUNCTIONS		 XSetPointerMapping(3)

       XSetPointerMapping, XGetPointerMapping -	manipulate pointer settings

       int  XSetPointerMapping(Display	*display, _Xconst unsigned char	map[],
	      int nmap);

       int XGetPointerMapping(Display *display,	 unsigned  char	 map_return[],
	      int nmap);

       display	 Specifies the connection to the X server.

       map	 Specifies the mapping list.

		 Returns the mapping list.

       nmap	 Specifies the number of items in the mapping list.

       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 re-
       sults.  A zero element disables a button,  and  elements	 are  not  re-
       stricted	 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.

       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.

       XChangeKeyboardControl(3), XChangeKeyboardMapping(3)
       Xlib - C	Language X Interface

X Version 11			 libX11	1.7.2		 XSetPointerMapping(3)


Want to link to this manual page? Use this URL:

home | help