Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

NAME

XGetModifierMapping − obtain a mapping of modifier keys (Shift, Control, etc.). 

Synopsis

XModifierKeymap *XGetModifierMapping(display)
Display *display;

Arguments

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

Description

XGetModifierMapping() returns the keycodes of the keys being used as modifiers.  There are eight modifiers, represented by the symbols ShiftMapIndex, LockMap­Index, ControlMapIndex, Mod1MapIndex, Mod2MapIndex, Mod3Map­Index, Mod4MapIndex, and Mod5MapIndex.  The modifiermap member of the XModifierKeymap() structure contains eight sets of keycodes, each set containing max_keypermod keycodes.  Zero keycodes are not meaningful.  If an entire modifiermap is filled with zero’s, the corresponding modifier is disabled.  No keycode will appear twice anywhere in the map. 

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;
 /* modifier names.  Used to build a SetModifierMapping request or
   to read a GetModifierMapping request. */
#define ShiftMapIndex0
#define LockMapIndex1
#define ControlMapIndex2
#define Mod1MapIndex3
#define Mod2MapIndex4
#define Mod3MapIndex5
#define Mod4MapIndex6
#define Mod5MapIndex7

See Also

XChangeKeyboardMapping(), XDeleteModifiermapEntry(), XFreeModifiermap(), XGetKeyboardMapping(), XInsertModifiermapEntry(), XKeycodeToKeysym(), XKeysymToKeycode(), XKeysymToString(), XLookupKeysym(), XLookupString(), XNewModifierMap, XQueryKeymap(), XRebindKeySym, XRefreshKeyboardMapping(), XSetModifierMapping(), XStringToKeysym(). 

Copyright O’Reilly & Assoc.  —  

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026