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

FreeBSD Manual Pages

  
 
  

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

NAME
       XkbResizeKeyActions - Change the	number of actions bound	to a key

SYNOPSIS

       XkbAction * XkbResizeKeyActions (XkbDescRec *xkb, int key, int needed);

ARGUMENTS
       xkb    keyboard description to change

       key    keycode of key to	change

       needed new number of actions required

DESCRIPTION
       The xkb parameter points	to the keyboard	description containing the key
       whose number of actions is to be	changed. The key parameter is the key-
       code  of	 the key to change, and	needed specifies the new number	of ac-
       tions required for the key.

       XkbResizeKeyActions reserves the	space needed for the actions  and  re-
       turns  a	 pointer  to the beginning of the new array that holds the ac-
       tions. It can change  the  acts,	 num_acts,  and	 size_acts  fields  of
       xkb->server if it is necessary to reallocate the	acts array.

       If  needed  is  greater than the	current	number of keysyms for the key,
       XkbResizeKeyActions initializes all new actions in the array  to	 NoAc-
       tion.

       Because	the  number of actions needed by a key is normally computed as
       width * number of groups, and XkbResizeKeyActions does not  modify  ei-
       ther the	width or number	of groups for the key, a discrepancy exists on
       return from XkbResizeKeyActions between the space allocated for the ac-
       tions  and  the	number required. The unused entries in the list	of ac-
       tions returned by XkbResizeKeyActions are not preserved	across	future
       calls  to  any of the map editing functions, so you must	update the key
       actions (which updates the width	and number of groups for the key)  be-
       fore  calling another allocator function. A call	to XkbChangeTypesOfKey
       updates these.

       If any allocation errors	occur while resizing  the  number  of  actions
       bound to	the key, XkbResizeKeyActions returns NULL.

SEE ALSO
       XkbChangeTypesOfKey(3), XkbResizeKeySyms(3)

NOTES
       A  change to the	number of actions bound	to a key should	be accompanied
       by a change in the number of symbols bound to a key.  Refer  to	XkbRe-
       sizeKeySyms  for	 more  information  on	changing the number of symbols
       bound to	a key.

X Version 11			 libX11	1.8.12		XkbResizeKeyActions(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XkbResizeKeyActions&sektion=3&manpath=FreeBSD+Ports+14.3.quarterly>

home | help