home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / Xi / XSelectExtensionEvent.z / XSelectExtensionEvent
Encoding:
Text File  |  1998-10-30  |  9.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXSSSSeeeelllleeeeccccttttEEEExxxxtttteeeennnnssssiiiioooonnnnEEEEvvvveeeennnntttt((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXSSSSeeeelllleeeeccccttttEEEExxxxtttteeeennnnssssiiiioooonnnnEEEEvvvveeeennnntttt((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XSelectExtensionEvent, XGetSelectedExtensionEvents - select
  10.           extension events, get the list of currently selected
  11.           extension events
  12.  
  13.      SSSSYYYYNNNNTTTTAAAAXXXX
  14.           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)
  15.                 Display *_d_i_s_p_l_a_y;
  16.                 Window _w;
  17.                 XEventClass *_e_v_e_n_t__l_i_s_t;
  18.                 int _e_v_e_n_t__c_o_u_n_t;
  19.  
  20.           XGetSelectedExtensionEvents(_d_i_s_p_l_a_y, _w,
  21.           _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,
  22.           _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,
  23.           _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,
  24.           _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)
  25.                 Display *_d_i_s_p_l_a_y;
  26.                 Window _w;
  27.                 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;
  28.                 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;
  29.                 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;
  30.                 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;
  31.  
  32.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  33.           _d_i_s_p_l_a_y     Specifies the connection to the X server.
  34.  
  35.           _w           Specifies the window whose events you are
  36.                       interested in.
  37.  
  38.           _e_v_e_n_t__l_i_s_t  Specifies the list of event classes that
  39.                       describe the events you are interested in.
  40.  
  41.           _e_v_e_n_t__c_o_u_n_t Specifies the count of event classes in the
  42.                       event list.
  43.  
  44.           _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
  45.                       Returns the count of event classes selected by
  46.                       this client.
  47.  
  48.           _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
  49.                       Returns a pointer to the list of event classes
  50.                       selected by this client.
  51.  
  52.           _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
  53.                       Returns the count of event classes selected by
  54.                       all clients.
  55.  
  56.           _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
  57.                       Returns a pointer to the list of event classes
  58.                       selected by all clients.
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXSSSSeeeelllleeeeccccttttEEEExxxxtttteeeennnnssssiiiioooonnnnEEEEvvvveeeennnntttt((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXSSSSeeeelllleeeeccccttttEEEExxxxtttteeeennnnssssiiiioooonnnnEEEEvvvveeeennnntttt((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  75.           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
  76.           report the events associated with the specified list of
  77.           event classes.  Initially, X will not report any of these
  78.           events.  Events are reported relative to a window.  If a
  79.           window is not interested in a device event, it usually
  80.           propagates to the closest ancestor that is interested,
  81.           unless the do_not_propagate mask prohibits it.
  82.  
  83.           Multiple clients can select for the same events on the same
  84.           window with the following restrictions:
  85.  
  86.           +o    Multiple clients can select events on the same window
  87.                because their event masks are disjoint.  When the X
  88.                server generates an event, it reports it to all
  89.                interested clients.
  90.  
  91.           +o    Only one client at a time can select a
  92.                _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s event with automatic passive grabbing
  93.                enabled, which is associated with the event class
  94.                _D_e_v_i_c_e_B_u_t_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
  95.                events without automatic passive grabbing, use event
  96.                class _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s but do not specify event class
  97.                _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s_G_r_a_b.
  98.  
  99.           The server reports the event to all interested clients.
  100.  
  101.           Information contained in the _X_D_e_v_i_c_e structure returned by
  102.           _X_O_p_e_n_D_e_v_i_c_e is used by macros to obtain the event classes
  103.           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.
  104.           Currently defined macros include _D_e_v_i_c_e_K_e_y_P_r_e_s_s,
  105.           _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,
  106.           _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,
  107.           _P_r_o_x_i_m_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,
  108.           _D_e_v_i_c_e_M_a_p_p_i_i_n_g_N_o_t_i_f_y, _C_h_a_n_g_e_D_e_v_i_c_e_N_o_t_i_f_y,
  109.           _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_B_u_t_t_o_n_1_M_o_t_i_o_n,
  110.           _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,
  111.           _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,
  112.           _D_e_v_i_c_e_B_u_t_t_o_n_M_o_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,
  113.           _D_e_v_i_c_e_B_u_t_t_o_n_P_r_e_s_s_G_r_a_b, and _N_o_E_x_t_e_n_s_i_o_n_E_v_e_n_t.
  114.  
  115.           To obtain the proper event class for a particular device,
  116.           one of the above macros is invoked using the _X_D_e_v_i_c_e
  117.           structure for that device.  For example,
  118.  
  119.           DeviceKeyPress (*device, type, eventclass);
  120.  
  121.           returns the _D_e_v_i_c_e_K_e_y_P_r_e_s_s event type and the eventclass for
  122.           selecting _D_e_v_i_c_e_K_e_y_P_r_e_s_s events from this device.
  123.  
  124.           _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
  125.           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 the
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 4/30/98)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXSSSSeeeelllleeeeccccttttEEEExxxxtttteeeennnnssssiiiioooonnnnEEEEvvvveeeennnntttt((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....3333))))XXXXSSSSeeeelllleeeeccccttttEEEExxxxtttteeeennnnssssiiiioooonnnnEEEEvvvveeeennnntttt((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.           extension events selected by this client and all clients for
  141.           the specified window.  This request returns pointers to two
  142.           _X_E_v_e_n_t_C_l_a_s_s arrays.  One lists the input extension events
  143.           selected by this client from the specified window.  The
  144.           other lists the event classes selected by all clients from
  145.           the specified window.  You should use _X_F_r_e_e to free these
  146.           two arrays.
  147.  
  148.           _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 error.
  149.  
  150.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  151.           _B_a_d_W_i_n_d_o_w   A value for a Window argument does not name a
  152.                       defined Window.
  153.  
  154.           _B_a_d_C_l_a_s_s    A value for an XEventClass argument is invalid.
  155.  
  156.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  157.           _P_r_o_g_r_a_m_m_i_n_g _w_i_t_h _X_l_i_b
  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.      Page 3                                          (printed 4/30/98)
  196.  
  197.  
  198.  
  199.