home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xt / XtAddEventHandler.z / XtAddEventHandler
Encoding:
Text File  |  2002-10-03  |  8.9 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXttttAAAAddddddddEEEEvvvveeeennnnttttHHHHaaaannnnddddlllleeeerrrr((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttAAAAddddddddEEEEvvvveeeennnnttttHHHHaaaannnnddddlllleeeerrrr((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtAddEventHandler, XtAddRawEventHandler,
  10.           XtRemoveEventHandler, XtRemoveRawEventHandler,
  11.           XtInsertEventHandler, XtInsertRawEventHandler - add and
  12.           remove event handlers
  13.  
  14.      SSSSYYYYNNNNTTTTAAAAXXXX
  15.           void XtAddEventHandler(_w, _e_v_e_n_t__m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e, _p_r_o_c,
  16.           _c_l_i_e_n_t__d_a_t_a)
  17.                 Widget _w;
  18.                 EventMask _e_v_e_n_t__m_a_s_k;
  19.                 Boolean _n_o_n_m_a_s_k_a_b_l_e;
  20.                 XtEventHandler _p_r_o_c;
  21.                 XtPointer _c_l_i_e_n_t__d_a_t_a;
  22.  
  23.           void XtAddRawEventHandler(_w, _e_v_e_n_t__m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e, _p_r_o_c,
  24.           _c_l_i_e_n_t__d_a_t_a)
  25.                 Widget _w;
  26.                 EventMask _e_v_e_n_t__m_a_s_k;
  27.                 Boolean _n_o_n_m_a_s_k_a_b_l_e;
  28.                 XtEventHandler _p_r_o_c;
  29.                 XtPointer _c_l_i_e_n_t__d_a_t_a;
  30.  
  31.           void XtRemoveEventHandler(_w, _e_v_e_n_t__m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e, _p_r_o_c,
  32.           _c_l_i_e_n_t__d_a_t_a)
  33.                 Widget _w;
  34.                 EventMask _e_v_e_n_t__m_a_s_k;
  35.                 Boolean _n_o_n_m_a_s_k_a_b_l_e;
  36.                 XtEventHandler _p_r_o_c;
  37.                 XtPointer _c_l_i_e_n_t__d_a_t_a;
  38.  
  39.           void XtRemoveRawEventHandler(_w, _e_v_e_n_t__m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e,
  40.           _p_r_o_c, _c_l_i_e_n_t__d_a_t_a)
  41.                 Widget _w;
  42.                 EventMask _e_v_e_n_t__m_a_s_k;
  43.                 Boolean _n_o_n_m_a_s_k_a_b_l_e;
  44.                 XtEventHandler _p_r_o_c;
  45.                 XtPointer _c_l_i_e_n_t__d_a_t_a;
  46.  
  47.           void XtInsertEventHandler(_w, _e_v_e_n_t__m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e, _p_r_o_c,
  48.           _c_l_i_e_n_t__d_a_t_a, _p_o_s_i_t_i_o_n)
  49.                 Widget _w;
  50.                 EventMask _e_v_e_n_t__m_a_s_k;
  51.                 Boolean _n_o_n_m_a_s_k_a_b_l_e;
  52.                 XtEventHandler _p_r_o_c;
  53.                 XtPointer _c_l_i_e_n_t__d_a_t_a;
  54.                 XtListPosition _p_o_s_i_t_i_o_n;
  55.  
  56.           void XtInsertRawEventHandler(_w, _e_v_e_n_t__m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e,
  57.           _p_r_o_c, _c_l_i_e_n_t__d_a_t_a, _p_o_s_i_t_i_o_n)
  58.                 Widget _w;
  59.                 EventMask _e_v_e_n_t__m_a_s_k;
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttAAAAddddddddEEEEvvvveeeennnnttttHHHHaaaannnnddddlllleeeerrrr((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttAAAAddddddddEEEEvvvveeeennnnttttHHHHaaaannnnddddlllleeeerrrr((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.                 Boolean _n_o_n_m_a_s_k_a_b_l_e;
  75.                 XtEventHandler _p_r_o_c;
  76.                 XtPointer _c_l_i_e_n_t__d_a_t_a;
  77.                 XtListPosition _p_o_s_i_t_i_o_n;
  78.  
  79.           typedef enum { XtListHead, XtListTail } XtListPosition;
  80.  
  81.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  82.           _c_l_i_e_n_t__d_a_t_a
  83.                     Specifies additional data to be passed to the
  84.                     client's event handler.
  85.  
  86.           _e_v_e_n_t__m_a_s_k
  87.                     Specifies the event mask for which to call or
  88.                     unregister this procedure.
  89.  
  90.           _n_o_n_m_a_s_k_a_b_l_e
  91.                     Specifies a Boolean value that indicates whether
  92.                     this procedure should be called or removed on the
  93.                     nonmaskable events (_G_r_a_p_h_i_c_s_E_x_p_o_s_e, _N_o_E_x_p_o_s_e,
  94.                     _S_e_l_e_c_t_i_o_n_C_l_e_a_r, _S_e_l_e_c_t_i_o_n_R_e_q_u_e_s_t, _S_e_l_e_c_t_i_o_n_N_o_t_i_f_y,
  95.                     _C_l_i_e_n_t_M_e_s_s_a_g_e, and _M_a_p_p_i_n_g_N_o_t_i_f_y).
  96.  
  97.           _p_r_o_c      Specifies the procedure that is to be added or
  98.                     removed.
  99.  
  100.           _w         Specifies the widget for which this event handler
  101.                     is being registered.
  102.  
  103.           _p_o_s_i_t_i_o_n  Specifies when the event handler is to be called
  104.                     relative to other previously registered handlers.
  105.  
  106.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  107.           The _X_t_A_d_d_E_v_e_n_t_H_a_n_d_l_e_r function registers a procedure with
  108.           the dispatch mechanism that is to be called when an event
  109.           that matches the mask occurs on the specified widget.  If
  110.           the procedure is already registered with the same
  111.           client_data, the specified mask is ORed into the existing
  112.           mask.  If the widget is realized, _X_t_A_d_d_E_v_e_n_t_H_a_n_d_l_e_r calls
  113.           _X_S_e_l_e_c_t_I_n_p_u_t, if necessary.
  114.  
  115.           The _X_t_A_d_d_R_a_w_E_v_e_n_t_H_a_n_d_l_e_r function is similar to
  116.           _X_t_A_d_d_E_v_e_n_t_H_a_n_d_l_e_r except that it does not affect the
  117.           widget's mask and never causes an _X_S_e_l_e_c_t_I_n_p_u_t for its
  118.           events.  Note that the widget might already have those mask
  119.           bits set because of other nonraw event handlers registered
  120.           on it.
  121.  
  122.           The _X_t_R_e_m_o_v_e_R_a_w_E_v_e_n_t_H_a_n_d_l_e_r function stops the specified
  123.           procedure from receiving the specified events.  Because the
  124.           procedure is a raw event handler, this does not affect the
  125.           widget's mask and never causes a call on _X_S_e_l_e_c_t_I_n_p_u_t.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXttttAAAAddddddddEEEEvvvveeeennnnttttHHHHaaaannnnddddlllleeeerrrr((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttAAAAddddddddEEEEvvvveeeennnnttttHHHHaaaannnnddddlllleeeerrrr((((3333XXXXtttt))))
  137.  
  138.  
  139.  
  140.           _X_t_I_n_s_e_r_t_E_v_e_n_t_H_a_n_d_l_e_r is identical to _X_t_A_d_d_E_v_e_n_t_H_a_n_d_l_e_r with
  141.           the additional _p_o_s_i_t_i_o_n argument. if _p_o_s_i_t_i_o_n is _X_t_L_i_s_t_H_e_a_d,
  142.           the event handler is registered to that it will be called
  143.           before any event handlers that were previously registered
  144.           for the same widget.  If _p_o_s_i_t_i_o_n is _X_t_L_i_s_t_T_a_i_l, the event
  145.           handler is registered to be called after any previously
  146.           registered event handlers. If the procedure is already
  147.           registered with the same _c_l_i_e_n_t__d_a_t_a value, the specified
  148.           mask augments the existing mask and the procedure is
  149.           repositioned in the list.
  150.  
  151.           _X_t_I_n_s_e_r_t_R_a_w_E_v_e_n_t_H_a_n_d_l_e_r is similar to _X_t_I_n_s_e_r_t_E_v_e_n_t_H_a_n_d_l_e_r
  152.           except that it does not modify the widget's event mask and
  153.           never causes an _X_S_e_l_e_c_t_I_n_p_u_t for the specified events. If
  154.           the procedure is already registered with the same
  155.           _c_l_i_e_n_t__d_a_t_a value, the specified mask augments the existing
  156.           mask and the procedure is repositioned in the list.
  157.  
  158.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  159.           XtAppNextEvent(3Xt), XtBuildEventMask(3Xt)
  160.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  161.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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 10/3/02)
  196.  
  197.  
  198.  
  199.