XmeVirtualToActualKeysyms(UNIX SysteXmeVirtualToActualKeysyms(3X)
NAME
XmeVirtualToActualKeysyms - Finds the physical keysyms
associated with a given virtual keysym.
SYNOPSIS
#include <Xm/XmP.h>
int XmeVirtualToActualKeysyms(
Display *display,
KeySym virtualKeysym,
XmKeyBinding *physicalKeysyms);
VERSION
This page documents Motif 2.1.
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,
XmeVirtualToActualKeysymsreturns 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).
Page 1 (printed 7/20/06)
