<HTML>
<HEAD>
<TITLE></TITLE>
</HEAD>
<BODY>
<PRE>



XChangeKeyboardDevice(3X11)X FUNCTIONSXChangeKeyboardDevice(3X11)


NAME
       XChangeKeyboardDevice - change which device is used as the
       X keyboard

SYNTAX
       Status XChangeKeyboardDevice(display, device)
	     Display *display;
	     XDevice *device;

ARGUMENTS
       display	   Specifies the connection to the X server.

       device	   Specifies the device to be used as the X  key
		   board.

DESCRIPTION
       The XChangeKeyboardDevice request causes the server to use
       the specified device as the X keyboard.	The  device  must
       have  been  previously opened by the requesting client via
       XOpenDevice or a BadDevice error will result.  The  device
       must  support  input  class Keys, or a BadMatch error will
       result.	If the server  implementation  does  not  support
       using  the requested device as the X keyboard, a BadDevice
       error will result.

       If the specified device	is  grabbed  by	 another  client,
       AlreadyGrabbed  is  returned.   If the specified device is
       frozen  by  a  grab  on	another	 device,  GrabFrozen   is
       returned.   If  the  request  is	 successful,  Success  is
       returned.

       If the request succeeds,	 a  ChangeDeviceNotify	event  is
       sent to all clients that have selected that event.  A Map_
       pingNotify event with request = MappingKeyboard is sent to
       all  clients.  The specified device becomes the X keyboard
       and the old X  keyboard	becomes	 accessible  through  the
       input extension protocol requests.

       XChangeKeyboardDevice  can  generate a BadDevice or a Bad_
       Match error.

DIAGNOSTICS
       BadDevice   An invalid device was specified.   The  speci
		   fied	 device	 does  not  exist,  has	 not been
		   opened by this  client  via	XOpenInputDevice,
		   or  is  already  one	 of  the  core	X  device
		   (pointer or keyboard).  This	 error	may  also
		   occur  if  the  server implementation does not
		   support using the specified device  as  the	X
		   keyboard.

       BadMatch	   This	 error may occur if an XChangeKeyboardDe_
		   vice request was made specifying a device that
		   has no keys.



X Version 11		   Release 6.1				1





XChangeKeyboardDevice(3X11)X FUNCTIONSXChangeKeyboardDevice(3X11)


SEE ALSO
       XChangePointerDevice
       Programming With Xlib






















































X Version 11		   Release 6.1				2


</PRE>
</BODY>
</HTML>
