home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xgetdevicebuttonmapping.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  4.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4. XSetDeviceButtonMapping(3X11X)FUNCTIONXSSetDeviceButtonMapping(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XSetDeviceButtonMapping,     XGetDeviceButtonMapping  - query
  9.        or change device button mappings
  10.  
  11. SSYYNNTTAAXX
  12.        int XSetDeviceButtonMapping(_d_i_s_p_l_a_y, _d_e_v_i_c_e, _m_a_p, _n_m_a_p)
  13.          Display *_d_i_s_p_l_a_y;
  14.          XDevice *_d_e_v_i_c_e;
  15.          unsigned char _m_a_p[];
  16.          int _n_m_a_p;
  17.  
  18.        int XGetDeviceButtonMapping(_d_i_s_p_l_a_y,  _d_e_v_i_c_e,  _m_a_p___r_e_t_u_r_n,
  19.        _n_m_a_p)
  20.          Display *_d_i_s_p_l_a_y;
  21.          XDevice *_d_e_v_i_c_e;
  22.          unsigned char _m_a_p___r_e_t_u_r_n[];
  23.          int _n_m_a_p;
  24.  
  25. AARRGGUUMMEENNTTSS
  26.        _d_i_s_p_l_a_y       Specifies the connection to the X server.
  27.  
  28.        _d_e_v_i_c_e       Specifies  the  device whose button mapping is
  29.            to be queried or changed.
  30.  
  31.        _m_a_p       Specifies the mapping list.
  32.  
  33.        _m_a_p___r_e_t_u_r_n  Returns the mapping list.
  34.  
  35.        _n_m_a_p       Specifies the number of items in  the  mapping
  36.            list.
  37.  
  38. DDEESSCCRRIIPPTTIIOONN
  39.        The  _X_S_e_t_D_e_v_i_c_e_B_u_t_t_o_n_M_a_p_p_i_n_g  request  sets the mapping of
  40.        the specified device.  If it succeeds, the X server gener-
  41.        ates a _D_e_v_i_c_e_M_a_p_p_i_n_g_N_o_t_i_f_y event, and _X_S_e_t_D_e_v_i_c_e_B_u_t_t_o_n_M_a_p_-
  42.        _p_i_n_g returns _M_a_p_p_i_n_g_S_u_c_c_e_s_s.  Element map[i]  defines  the
  43.        logical    button    number    for the physical button i+1.  The
  44.        length of the list must be the same  as    _X_G_e_t_D_e_v_i_c_e_B_u_t_t_o_n_-
  45.        _M_a_p_p_i_n_g would return, or a _B_a_d_V_a_l_u_e error results.  A zero
  46.        element disables a button, and elements are not restricted
  47.        in  value  by the number of physical buttons.  However, no
  48.        two elements can have the same nonzero value,  or  a  _B_a_d_-
  49.        _V_a_l_u_e  error results.  If any of the buttons to be altered
  50.        are logically in the down  state,  _X_S_e_t_D_e_v_i_c_e_B_u_t_t_o_n_M_a_p_p_i_n_g
  51.        returns _M_a_p_p_i_n_g_B_u_s_y, and the mapping is not changed.
  52.  
  53.        _X_S_e_t_D_e_v_i_c_e_B_u_t_t_o_n_M_a_p_p_i_n_g    can generate _B_a_d_D_e_v_i_c_e, _B_a_d_M_a_t_c_h,
  54.        and  _B_a_d_V_a_l_u_e errors.
  55.  
  56.        The _X_G_e_t_D_e_v_i_c_e_B_u_t_t_o_n_M_a_p_p_i_n_g request  returns  the  current
  57.        mapping    of  the     specified  device.  Buttons are numbered
  58.        starting from one.   _X_G_e_t_D_e_v_i_c_e_B_u_t_t_o_n_M_a_p_p_i_n_g  returns  the
  59.        number  of  physical  buttons actually on the device.  The
  60.        nominal mapping for a  device  is  map[i]=i+1.    The  nmap
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XSetDeviceButtonMapping(3X11X)FUNCTIONXSSetDeviceButtonMapping(3X11)
  71.  
  72.  
  73.        argument     specifies  the     length     of  the  array where the
  74.        device mapping is returned, and only the first  nmap  ele-
  75.        ments are returned in map_return.
  76.  
  77.        _X_G_e_t_D_e_v_i_c_e_B_u_t_t_o_n_M_a_p_p_i_n_g can generate _B_a_d_D_e_v_i_c_e or _B_a_d_M_a_t_c_h
  78.        errors.
  79.  
  80. DDIIAAGGNNOOSSTTIICCSS
  81.        _B_a_d_D_e_v_i_c_e   An invalid device was specified.   The  speci-
  82.            fied     device     does  not  exist or has not been
  83.            opened by this  client  via    _X_O_p_e_n_I_n_p_u_t_D_e_v_i_c_e.
  84.            This     error    may  also  occur if the specified
  85.            device is the X keyboard or X pointer  device.
  86.  
  87.        _B_a_d_M_a_t_c_h       This     error    may occur if an _X_G_e_t_D_e_v_i_c_e_B_u_t_t_o_n_-
  88.            _M_a_p_p_i_n_g or _X_S_e_t_D_e_v_i_c_e_B_u_t_t_o_n_M_a_p_p_i_n_g request was
  89.            made     specifying a device that has no buttons.
  90.  
  91.        _B_a_d_V_a_l_u_e       Some numeric value falls outside the range  of
  92.            values accepted by the request.  Unless a spe-
  93.            cific range is specified for an argument,  the
  94.            full     range    defined by the argument's type is
  95.            accepted.  Any argument defined as  a  set  of
  96.            alternatives can generate this error.
  97.  
  98. SSEEEE AALLSSOO
  99.        XChangeDeviceKeyboardControl(3X),
  100.        XChangeDeviceKeyMapping(3X)
  101.        XChangeDeviceModifierMapping(3X)
  102.        _P_r_o_g_r_a_m_m_i_n_g _W_i_t_h _X_l_i_b
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.