hpux man page for xinsertmodifiermapentry

XInsertModifiermapEntry()												 XInsertModifiermapEntry()

Name
  XInsertModifiermapEntry - add a new entry to an XModifierKeymap structure.

Synopsis
  XModifierKeymap *XInsertModifiermapEntry(modmap,
	    keycode_entry, modifier)
	  XModifierKeymap *modmap;
	  KeyCode keycode_entry;
	  int modifier;

Arguments
  modmap    Specifies a pointer to an XModifierKeymap() structure.

  keycode_entry
	    Specifies the keycode of the key to be added to modmap.

  modifier  Specifies  the  modifier you want mapped to the keycode specified in keycode_entry.  This should be one of the constants:  Shift-
	    MapIndex, LockMapIndex, ControlMapIndex, Mod1MapIndex, Mod2MapIndex, Mod3MapIndex, Mod4MapIndex, or Mod5MapIndex.

Returns
  The modifier map structure with the keycode added.

Description
  XInsertModifiermapEntry() returns an XModifierKeymap structure suitable for calling XSetModifierMapping(), in which the  specified  keycode
  is  added  to  the  set  of  keycodes that is mapped to the specified modifier (like Shift or Control).  XInsertModifiermapEntry() does not
  change the mapping itself.

  This function is normally used by calling XGetModifierMapping() to get a pointer to the current XModifierKeymap structure for  use  as  the
  modmap argument to XInsertModifiermapEntry().

  Note	that  the structure pointed to by modmap is freed by XInsertModifiermapEntry().  It should not be freed or otherwise used by applica-
  tions.

  For a description of the modifier map, see XSetModifierMapping().

Structures
     typedef struct {
	 int max_keypermod;	  /* server's max number of keys per modifier */
	 KeyCode *modifiermap;	  /* an 8 by max_keypermod array of
				       * keycodes to be used as modifiers */
     } XModifierKeymap;

     #define ShiftMapIndex    0
     #define LockMapIndex     1
     #define ControlMapIndex  2
     #define Mod1MapIndex     3
     #define Mod2MapIndex     4
     #define Mod3MapIndex     5
     #define Mod4MapIndex     6
     #define Mod5MapIndex     7

See Also
  XDeleteModifiermapEntry(),  XFreeModifiermap(),  XGetKeyboardMapping(),  XGetModifierMapping(),   XKeycodeToKeysym(),   XKeysymToKeycode(),
  XKeysymToString(),  XLookupKeysym(),	XLookupString(), XNewModifierMap, XQueryKeymap(), XRebindKeySym, XRefreshKeyboardMapping(), XSetModi-
  fierMapping(), XStringToKeysym().

Xlib - Resource Manager 												 XInsertModifiermapEntry()