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

FreeBSD Manual Pages


home | help
XkbGetCompatMap(3)		 XKB FUNCTIONS		    XkbGetCompatMap(3)

       XkbGetCompatMap	-  Fetch  any combination of the current compatibility
       map components from the server

       Status XkbGetCompatMap (Display *display, unsigned  int	which,	XkbDe-
	      scRec *xkb);

       - display
	      connection to server

       - which
	      mask of compatibility map	components to fetch

       - xkb  keyboard description where results placed

       When another client modifies the	compatibility map, you are notified if
       you have	selected for XkbCompatMapNotify	 events.   XkbGetCompatMap  is
       particularly  useful  when you receive an event of this type, as	it al-
       lows you	to update your program's version of the	compatibility  map  to
       match  the modified version now in the server. If your program is deal-
       ing with	multiple servers and needs to configure	them all in a  similar
       manner,	the updated compatibility map may be used to reconfigure other

       XkbGetCompatMap fetches the components of the compatibility map	speci-
       fied  in	 which from the	server specified by display and	places them in
       the compat structure of the keyboard description	xkb.  Valid values for
       which are an inclusive OR of the	values shown in	Table 1.

		 Table 1 Compatibility Map Component Masks
       Mask		    Value    Affecting
       XkbSymInterpMask	    (1<<0)   Symbol interpretations
       XkbGroupCompatMask   (1<<1)   Group maps
       XkbAllCompatMask	    (0x3)    All compatibility map components

       If  no  compatibility map structure is allocated	in xkb upon entry, Xk-
       bGetCompatMap allocates one. If one already exists,  its	 contents  are
       overwritten with	the returned results.

       XkbGetCompatMap	fetches	 compatibility	map information	for the	device
       specified by the	device_spec field of xkb.  Unless  you	have  specifi-
       cally  modified this field, it is the default keyboard device.  XkbGet-
       CompatMap returns Success if successful,	BadAlloc if it	is  unable  to
       obtain  necessary  storage  for either the return values	or work	space,
       BadMatch	if the dpy field of the	xkb argument is	non-NULL and does  not
       match  the  display  argument,  and  BadLength under certain conditions
       caused by server	or Xkb implementation errors.

       BadAlloc	      Unable to	allocate storage

       BadLength      The length of a request is shorter or longer  than  that
		      required to minimally contain the	arguments

       BadMatch	      A	 compatible  version  of  Xkb was not available	in the
		      server or	an argument has	correct	type and range,	but is
		      otherwise	invalid

X Version 11			 libX11	1.6.12		    XkbGetCompatMap(3)


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

home | help