[ Previous | Next | Contents | Glossary | Home | Search ]
Motif 2.1 Widget Writer's Guide


XmeVirtualToActualKeysyms

Finds the physical keysyms associated with a given virtual keysym.

Format

#include <Xm/XmP.h>
int XmeVirtualToActualKeysymsDisplay
*displayKeySym
virtualKeysymXmKeyBinding
*physicalKeysyms

DESCRIPTION

XmeVirtualToActualKeysyms determines which physical keysym(s) and modifier(s) are associated with a given virtual keysym. A virtual keysym might match multiple physical keysyms. Therefore, XmeVirtualToActualKeysyms returns the number of physical keysyms matched. The returned physical keysym and modifiers are stored in an array of XmKeyBinding structures.

The XmeVirtualToActualKeysyms function allocates dynamic memory to hold the physicalKeysyms array. Your widget is responsible for freeing the memory used to hold this array. The amount of memory is equal to the number of physical keysyms that are matched times the size of one XmKeyBinding structure.

display
Specifies the display.

virtualKeysym
Specifies the virtual keysym that is to be translated.

physicalKeysym
Returns a pointer to an array of XmKeyBinding. The XmKeyBinding data type is a structure defined as follows:
typedef struct {
  KeySym         keysym;
  Modifiers      modifiers;
} *XmKeyBinding;

RETURN

Returns the number of physical keysyms that correspond to virtualKeysym. A returned value of 0 indicates that no physical keysyms matched virtualKeysym.

RELATED

VirtualBindings(3).


[ Previous | Next | Contents | Glossary | Home | Search ]