Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

XStringToKeysym − convert a keysym name string to a keysym.

Synopsis

KeySym XStringToKeysym(string)
char *string;

Arguments

stringSpecifies the name of the keysym that is to be converted. 

Description

XStringToKeysym() translates the character string version of a keysym name ("Shift") to the matching keysym which is a constant (XK_Shift).  Valid keysym names are listed in <X11/keysymdef.h>.  If the keysym name is not in the Host Portable Character Encoding, the result is implementation-dependent.  If the specified string does not match a valid keysym, XStringToKeysym() returns NoSymbol.  This string is not the string returned in the buffer argument of XLookupString(), which can be set with XRebindKeysym().  If that string is used, XStringToKeysym() will return NoSymbol except by coincidence.  In Release 4, XStringToKeysym() can return keysyms that are not defined by the Xlib standard.  Note that the set of keysyms that are available in this manner and the mechanisms by which Xlib obtains them is implementation dependent.  (In the MIT sample implementation, the resource file /usr/lib/X11/XKeysymDB is used starting in Release 4.  The keysym name is used as the resource name, and the resource value is the keysym value in uppercase hexadecimal.)  For more information, see Volume One, Chapter 9, The Keyboard and Pointer. 

See Also

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

Copyright O’Reilly & Assoc.  —  

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