home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xselectextensionevent.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  7.4 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XSelectExtensionEvent(3X11)X FUNCTIONSXSelectExtensionEvent(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XSelectExtensionEvent,     XGetSelectedExtensionEvents    -
  9.        select  extension  events,  get    the  list  of    currently
  10.        selected extension events
  11.  
  12. SSYYNNTTAAXX
  13.        XSelectExtensionEvent(_d_i_s_p_l_a_y, _w, _e_v_e_n_t___l_i_s_t, _e_v_e_n_t___c_o_u_n_t)
  14.          Display *_d_i_s_p_l_a_y;
  15.          Window _w;
  16.          XEventClass *_e_v_e_n_t___l_i_s_t;
  17.          int _e_v_e_n_t___c_o_u_n_t;
  18.  
  19.        XGetSelectedExtensionEvents(_d_i_s_p_l_a_y,               _w,
  20.        _t_h_i_s___c_l_i_e_n_t___e_v_e_n_t___c_o_u_n_t___r_e_t_u_r_n,
  21.        _t_h_i_s___c_l_i_e_n_t___e_v_e_n_t___l_i_s_t___r_e_t_u_r_n,
  22.        _a_l_l___c_l_i_e_n_t_s___e_v_e_n_t___c_o_u_n_t___r_e_t_u_r_n,
  23.        _a_l_l___c_l_i_e_n_t_s___e_v_e_n_t___l_i_s_t___r_e_t_u_r_n)
  24.          Display *_d_i_s_p_l_a_y;
  25.          Window _w;
  26.          int _t_h_i_s___c_l_i_e_n_t___e_v_e_n_t___c_o_u_n_t___r_e_t_u_r_n;
  27.          XEventClass *_t_h_i_s___c_l_i_e_n_t___e_v_e_n_t___l_i_s_t___r_e_t_u_r_n;
  28.          int _a_l_l___c_l_i_e_n_t_s___e_v_e_n_t___c_o_u_n_t___r_e_t_u_r_n;
  29.          XEventClass *_a_l_l___c_l_i_e_n_t_s___e_v_e_n_t___l_i_s_t___r_e_t_u_r_n;
  30.  
  31. AARRGGUUMMEENNTTSS
  32.        _d_i_s_p_l_a_y       Specifies the connection to the X server.
  33.  
  34.        _w       Specifies  the  window  whose  events  you are
  35.            interested in.
  36.  
  37.        _e_v_e_n_t___l_i_s_t  Specifies  the  list     of  event  classes  that
  38.            describe the events you are interested in.
  39.  
  40.        _e_v_e_n_t___c_o_u_n_t Specifies  the  count  of event classes in the
  41.            event list.
  42.  
  43.        _t_h_i_s___c_l_i_e_n_t___e_v_e_n_t___c_o_u_n_t___r_e_t_u_r_n
  44.            Returns the count of event classes selected by
  45.            this client.
  46.  
  47.        _t_h_i_s___c_l_i_e_n_t___e_v_e_n_t___l_i_s_t___r_e_t_u_r_n
  48.            Returns a pointer to the list of event classes
  49.            selected by this client.
  50.  
  51.        _a_l_l___c_l_i_e_n_t_s___e_v_e_n_t___c_o_u_n_t___r_e_t_u_r_n
  52.            Returns the count of event classes selected by
  53.            all clients.
  54.  
  55.        _a_l_l___c_l_i_e_n_t_s___e_v_e_n_t___l_i_s_t___r_e_t_u_r_n
  56.            Returns a pointer to the list of event classes
  57.            selected by all clients.
  58.  
  59. DDEESSCCRRIIPPTTIIOONN
  60.        The _X_S_e_l_e_c_t_E_x_t_e_n_s_i_o_n_E_v_e_n_t request causes the X  server  to
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XSelectExtensionEvent(3X11)X FUNCTIONSXSelectExtensionEvent(3X11)
  71.  
  72.  
  73.        report  the  events  associated with the specified list of
  74.        event classes.  Initially, X will not report any of  these
  75.        events.     Events     are reported relative to a window.  If a
  76.        window is not interested in a  device  event,  it  usually
  77.        propagates  to  the  closest  ancestor that is interested,
  78.        unless the do_not_propagate mask prohibits it.
  79.  
  80.        Multiple clients can select for the  same  events  on  the
  81.        same window with the following restrictions:
  82.  
  83.        +o    Multiple clients can select events on the same window
  84.         because their event masks are disjoint.  When  the    X
  85.         server  generates  an  event,  it  reports    it to all
  86.         interested clients.
  87.  
  88.        +o    Only one client at a time can select a  _D_e_v_i_c_e_B_u_t_t_o_n_-
  89.         _P_r_e_s_s  event with automatic passive grabbing enabled,
  90.         which is associated with the event    class  _D_e_v_i_c_e_B_u_t_-
  91.         _t_o_n_P_r_e_s_s_G_r_a_b.   To    receive     _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s events
  92.         without automatic passive grabbing, use  event  class
  93.         _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s  but  do    not  specify  event class
  94.         _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s_G_r_a_b.
  95.  
  96.        The server reports the event to all interested clients.
  97.  
  98.        Information contained in the _X_D_e_v_i_c_e structure returned by
  99.        _X_O_p_e_n_D_e_v_i_c_e  is used by macros to obtain the event classes
  100.        that clients use in making _X_S_e_l_e_c_t_E_x_t_e_n_s_i_o_n_E_v_e_n_t requests.
  101.        Currently    defined    macros    include      _D_e_v_i_c_e_K_e_y_P_r_e_s_s,
  102.        _D_e_v_i_c_e_K_e_y_R_e_l_e_a_s_e,  _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s,  _D_e_v_i_c_e_B_u_t_t_o_n_R_e_l_e_s_e,
  103.        _D_e_v_i_c_e_M_o_t_i_o_n_N_o_t_i_f_y, _D_e_v_i_c_e_F_o_c_u_s_I_n, _D_e_v_i_c_e_F_o_c_u_s_O_u_t, _P_r_o_x_i_m_-
  104.        _i_t_y_I_n, _P_r_o_x_i_m_i_t_y_O_u_t, _D_e_v_i_c_e_S_t_a_t_e_N_o_t_i_f_y,    _D_e_v_i_c_e_M_a_p_p_i_i_n_g_N_o_-
  105.        _t_i_f_y, _C_h_a_n_g_e_D_e_v_i_c_e_N_o_t_i_f_y, _D_e_v_i_c_e_P_o_i_n_t_e_r_M_o_t_i_o_n_H_i_n_t, _D_e_v_i_c_e_-
  106.        _B_u_t_t_o_n_1_M_o_t_i_o_n,  _D_e_v_i_c_e_B_u_t_t_o_n_2_M_o_t_i_o_n,  _D_e_v_i_c_e_B_u_t_t_o_n_3_M_o_t_i_o_n,
  107.        _D_e_v_i_c_e_B_u_t_t_o_n_4_M_o_t_i_o_n,  _D_e_v_i_c_e_B_u_t_t_o_n_5_M_o_t_i_o_n, _D_e_v_i_c_e_B_u_t_t_o_n_M_o_-
  108.        _t_i_o_n,  _D_e_v_i_c_e_O_w_n_e_r_G_r_a_b_B_u_t_t_o_n,  _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s_G_r_a_b,  and
  109.        _N_o_E_x_t_e_n_s_i_o_n_E_v_e_n_t.
  110.  
  111.        To  obtain the proper event class for a particular device,
  112.        one of the above     macros     is  invoked  using  the  _X_D_e_v_i_c_e
  113.        structure for that device.  For example,
  114.  
  115.        DeviceKeyPress (*device, type, eventclass);
  116.  
  117.        returns    the  _D_e_v_i_c_e_K_e_y_P_r_e_s_s event type and the eventclass
  118.        for selecting _D_e_v_i_c_e_K_e_y_P_r_e_s_s events from this device.
  119.  
  120.        _X_S_e_l_e_c_t_E_x_t_e_n_s_i_o_n_E_v_e_n_t can generate a _B_a_d_W_i_n_d_o_w or _B_a_d_C_l_a_s_s
  121.        error.    The  _X_G_e_t_S_e_l_e_c_t_e_d_E_x_t_e_n_s_i_o_n_E_v_e_n_t_s  request reports
  122.        the extension events  selected  by  this     client     and  all
  123.        clients    for  the  specified window.  This request returns
  124.        pointers to two _X_E_v_e_n_t_C_l_a_s_s arrays.  One lists  the  input
  125.        extension  events  selected by this client from the speci-
  126.        fied window.  The other lists the event    classes     selected
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XSelectExtensionEvent(3X11)X FUNCTIONSXSelectExtensionEvent(3X11)
  137.  
  138.  
  139.        by  all clients from the specified window.  You should use
  140.        _X_F_r_e_e to free these two arrays.
  141.  
  142.        _X_G_e_t_S_e_l_e_c_t_e_d_E_x_t_e_n_s_i_o_n_E_v_e_n_t_s  can     generate   a    _B_a_d_W_i_n_d_o_w
  143.        error.
  144.  
  145. DDIIAAGGNNOOSSTTIICCSS
  146.        _B_a_d_W_i_n_d_o_w   A  value for a Window argument does not name a
  147.            defined Window.
  148.  
  149.        _B_a_d_C_l_a_s_s       A  value  for  an  XEventClass   argument   is
  150.            invalid.
  151.  
  152. SSEEEE AALLSSOO
  153.        _P_r_o_g_r_a_m_m_i_n_g _w_i_t_h _X_l_i_b
  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.