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  keycode
     of  the  key  to change, and needed specifies the new number of actions re-
     quired for the key.

     XkbResizeKeyActions reserves the space needed for the actions and returns a
     pointer to the beginning of the new array that holds the  actions.  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, XkbRe-
     sizeKeyActions initializes all new actions in the array to NoAction.

     Because the number of actions needed by a key is normally computed as width
     * number of groups, and XkbResizeKeyActions  does	not  modify  either  the
     width  or number of groups for the key, a discrepancy exists on return from
     XkbResizeKeyActions between the space allocated for  the  actions	and  the
     number  required. The unused entries in the list of actions returned by Xk-
     bResizeKeyActions 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) before  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	XkbResizeKeySyms
     for more information on changing the number of symbols bound to a key.

X Version 11			  libX11 1.8.13 	  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+15.1.quarterly>

home | help