XmeVirtualToActualKeysyms()



     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 1/22/99)
Museum
