home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xrefreshkeyboardmapping.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  6.1 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XLookupKeysym(3X11)      XLIB FUNCTIONS      XLookupKeysym(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XLookupKeysym, XRefreshKeyboardMapping, XLookupString,
  9.        XRebindKeySym - handle keyboard input events in Latin-1
  10.  
  11. SSYYNNTTAAXX
  12.        KeySym XLookupKeysym(_k_e_y___e_v_e_n_t, _i_n_d_e_x)
  13.          XKeyEvent *_k_e_y___e_v_e_n_t;
  14.          int _i_n_d_e_x;
  15.  
  16.        XRefreshKeyboardMapping(_e_v_e_n_t___m_a_p)
  17.          XMappingEvent *_e_v_e_n_t___m_a_p;
  18.  
  19.        int XLookupString(_e_v_e_n_t___s_t_r_u_c_t, _b_u_f_f_e_r___r_e_t_u_r_n,
  20.        _b_y_t_e_s___b_u_f_f_e_r, _k_e_y_s_y_m___r_e_t_u_r_n, _s_t_a_t_u_s___i_n___o_u_t)
  21.          XKeyEvent *_e_v_e_n_t___s_t_r_u_c_t;
  22.          char *_b_u_f_f_e_r___r_e_t_u_r_n;
  23.          int _b_y_t_e_s___b_u_f_f_e_r;
  24.          KeySym *_k_e_y_s_y_m___r_e_t_u_r_n;
  25.          XComposeStatus *_s_t_a_t_u_s___i_n___o_u_t;
  26.  
  27.        XRebindKeysym(_d_i_s_p_l_a_y, _k_e_y_s_y_m, _l_i_s_t, _m_o_d___c_o_u_n_t, _s_t_r_i_n_g,
  28.        _n_u_m___b_y_t_e_s)
  29.          Display *_d_i_s_p_l_a_y;
  30.          KeySym _k_e_y_s_y_m;
  31.          KeySym _l_i_s_t[];
  32.          int _m_o_d___c_o_u_n_t;
  33.          unsigned char *_s_t_r_i_n_g;
  34.          int _n_u_m___b_y_t_e_s;
  35.  
  36. AARRGGUUMMEENNTTSS
  37.        _b_u_f_f_e_r___r_e_t_u_r_n
  38.          Returns the translated characters.
  39.  
  40.        _b_y_t_e_s___b_u_f_f_e_r
  41.          Specifies the length of the buffer.  No more
  42.          than bytes_buffer of translation are returned.
  43.  
  44.        _n_u_m___b_y_t_e_s Specifies the number of bytes in the string
  45.          argument.
  46.  
  47.        _d_i_s_p_l_a_y     Specifies the connection to the X server.
  48.  
  49.        _e_v_e_n_t___m_a_p Specifies the mapping event that is to be used.
  50.  
  51.        _e_v_e_n_t___s_t_r_u_c_t
  52.          Specifies the key event structure to be used.
  53.          You can pass _X_K_e_y_P_r_e_s_s_e_d_E_v_e_n_t or
  54.          _X_K_e_y_R_e_l_e_a_s_e_d_E_v_e_n_t.
  55.  
  56.        _i_n_d_e_x     Specifies the index into the KeySyms list for
  57.          the event's KeyCode.
  58.  
  59.        _k_e_y___e_v_e_n_t Specifies the _K_e_y_P_r_e_s_s or _K_e_y_R_e_l_e_a_s_e event.
  60.  
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XLookupKeysym(3X11)      XLIB FUNCTIONS      XLookupKeysym(3X11)
  71.  
  72.  
  73.        _k_e_y_s_y_m     Specifies the KeySym that is to be .
  74.  
  75.        _k_e_y_s_y_m___r_e_t_u_r_n
  76.          Returns the KeySym computed from the event if
  77.          this argument is not NULL.
  78.  
  79.        _l_i_s_t     Specifies the KeySyms to be used as modifiers.
  80.  
  81.        _m_o_d___c_o_u_n_t Specifies the number of modifiers in the modi-
  82.          fier list.
  83.  
  84.        _s_t_a_t_u_s___i_n___o_u_t
  85.          Specifies or returns the _X_C_o_m_p_o_s_e_S_t_a_t_u_s struc-
  86.          ture or NULL.
  87.  
  88.        _s_t_r_i_n_g     Specifies the string that is copied and will be
  89.          returned by _X_L_o_o_k_u_p_S_t_r_i_n_g.
  90.  
  91. DDEESSCCRRIIPPTTIIOONN
  92.        The _X_L_o_o_k_u_p_K_e_y_s_y_m function uses a given keyboard event and
  93.        the index you specified to return the KeySym from the list
  94.        that corresponds to the KeyCode member in the _X_K_e_y_-
  95.        _P_r_e_s_s_e_d_E_v_e_n_t or _X_K_e_y_R_e_l_e_a_s_e_d_E_v_e_n_t structure.  If no KeySym
  96.        is defined for the KeyCode of the event, _X_L_o_o_k_u_p_K_e_y_s_y_m
  97.        returns _N_o_S_y_m_b_o_l.
  98.  
  99.        The _X_R_e_f_r_e_s_h_K_e_y_b_o_a_r_d_M_a_p_p_i_n_g function refreshes the stored
  100.        modifier and keymap information.     You usually call this
  101.        function when a _M_a_p_p_i_n_g_N_o_t_i_f_y event with a request member
  102.        of _M_a_p_p_i_n_g_K_e_y_b_o_a_r_d or _M_a_p_p_i_n_g_M_o_d_i_f_i_e_r occurs.  The result
  103.        is to update Xlib's knowledge of the keyboard.
  104.  
  105.        The _X_L_o_o_k_u_p_S_t_r_i_n_g function translates a key event to a
  106.        KeySym and a string.  The KeySym is obtained by using the
  107.        standard interpretation of the _S_h_i_f_t, _L_o_c_k, group, and
  108.        numlock modifiers as defined in the X Protocol specifica-
  109.        tion.  If the KeySym has been rebound (see _X_R_e_b_i_n_d_K_e_y_s_y_m),
  110.        the bound string will be stored in the buffer.  Otherwise,
  111.        the KeySym is mapped, if possible, to an ISO Latin-1 char-
  112.        acter or (if the Control modifier is on) to an ASCII con-
  113.        trol character, and that character is stored in the
  114.        buffer.    _X_L_o_o_k_u_p_S_t_r_i_n_g returns the number of characters
  115.        that are stored in the buffer.
  116.  
  117.        If present (non-NULL), the _X_C_o_m_p_o_s_e_S_t_a_t_u_s structure
  118.        records the state, which is private to Xlib, that needs
  119.        preservation across calls to _X_L_o_o_k_u_p_S_t_r_i_n_g to implement
  120.        compose processing.  The creation of _X_C_o_m_p_o_s_e_S_t_a_t_u_s struc-
  121.        tures is implementation-dependent; a portable program must
  122.        pass NULL for this argument.
  123.  
  124.        The _X_R_e_b_i_n_d_K_e_y_s_y_m function can be used to rebind the mean-
  125.        ing of a KeySym for the client.    It does not redefine any
  126.        key in the X server but merely provides an easy way for
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XLookupKeysym(3X11)      XLIB FUNCTIONS      XLookupKeysym(3X11)
  137.  
  138.  
  139.        long strings to be attached to keys.  _X_L_o_o_k_u_p_S_t_r_i_n_g
  140.        returns this string when the appropriate set of modifier
  141.        keys are pressed and when the KeySym would have been used
  142.        for the translation.  No text conversions are performed;
  143.        the client is responsible for supplying appropriately
  144.        encoded strings.     Note that you can rebind a KeySym that
  145.        may not exist.
  146.  
  147. SSEEEE AALLSSOO
  148.        XButtonEvent(3X11), XMapEvent(3X11), XStringToKeysym(3X11)
  149.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.