XmeVirtualToActualKeysyms
Prev Xme Reference Pages Next

Name

XmeVirtualToActualKeysyms — Finds the physical keysyms associated with a given virtual keysym.

Synopsis

#include <Xm/XmP.h>
int XmeVirtualToActualKeysyms(display, virtualKeysym, 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).

Prev Table of Contents Next
XmeTransferAddDoneProc  XmeWarning