home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtinserteventhandler.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  6.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XtAddEventHandler(3Xt)       XT FUNCTIONS       XtAddEventHandler(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtAddEventHandler, XtAddRawEventHandler, XtRemoveEvent-
  9.        Handler, XtRemoveRawEventHandler, XtInsertEventHandler,
  10.        XtInsertRawEventHandler - add and remove event handlers
  11.  
  12. SSYYNNTTAAXX
  13.        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,
  14.        _c_l_i_e_n_t___d_a_t_a)
  15.          Widget _w;
  16.          EventMask _e_v_e_n_t___m_a_s_k;
  17.          Boolean _n_o_n_m_a_s_k_a_b_l_e;
  18.          XtEventHandler _p_r_o_c;
  19.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  20.  
  21.        void XtAddRawEventHandler(_w, _e_v_e_n_t___m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e,
  22.        _p_r_o_c, _c_l_i_e_n_t___d_a_t_a)
  23.          Widget _w;
  24.          EventMask _e_v_e_n_t___m_a_s_k;
  25.          Boolean _n_o_n_m_a_s_k_a_b_l_e;
  26.          XtEventHandler _p_r_o_c;
  27.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  28.  
  29.        void XtRemoveEventHandler(_w, _e_v_e_n_t___m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e,
  30.        _p_r_o_c, _c_l_i_e_n_t___d_a_t_a)
  31.          Widget _w;
  32.          EventMask _e_v_e_n_t___m_a_s_k;
  33.          Boolean _n_o_n_m_a_s_k_a_b_l_e;
  34.          XtEventHandler _p_r_o_c;
  35.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  36.  
  37.        void XtRemoveRawEventHandler(_w, _e_v_e_n_t___m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e,
  38.        _p_r_o_c, _c_l_i_e_n_t___d_a_t_a)
  39.          Widget _w;
  40.          EventMask _e_v_e_n_t___m_a_s_k;
  41.          Boolean _n_o_n_m_a_s_k_a_b_l_e;
  42.          XtEventHandler _p_r_o_c;
  43.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  44.  
  45.        void XtInsertEventHandler(_w, _e_v_e_n_t___m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e,
  46.        _p_r_o_c, _c_l_i_e_n_t___d_a_t_a, _p_o_s_i_t_i_o_n)
  47.          Widget _w;
  48.          EventMask _e_v_e_n_t___m_a_s_k;
  49.          Boolean _n_o_n_m_a_s_k_a_b_l_e;
  50.          XtEventHandler _p_r_o_c;
  51.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  52.          XtListPosition _p_o_s_i_t_i_o_n;
  53.  
  54.        void XtInsertRawEventHandler(_w, _e_v_e_n_t___m_a_s_k, _n_o_n_m_a_s_k_a_b_l_e,
  55.        _p_r_o_c, _c_l_i_e_n_t___d_a_t_a, _p_o_s_i_t_i_o_n)
  56.          Widget _w;
  57.          EventMask _e_v_e_n_t___m_a_s_k;
  58.          Boolean _n_o_n_m_a_s_k_a_b_l_e;
  59.          XtEventHandler _p_r_o_c;
  60.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtAddEventHandler(3Xt)       XT FUNCTIONS       XtAddEventHandler(3Xt)
  71.  
  72.  
  73.          XtListPosition _p_o_s_i_t_i_o_n;
  74.  
  75.        typedef enum { XtListHead, XtListTail } XtListPosition;
  76.  
  77. AARRGGUUMMEENNTTSS
  78.        _c_l_i_e_n_t___d_a_t_a
  79.          Specifies additional data to be passed to the
  80.          client's event handler.
  81.  
  82.        _e_v_e_n_t___m_a_s_k
  83.          Specifies the event mask for which to call or
  84.          unregister this procedure.
  85.  
  86.        _n_o_n_m_a_s_k_a_b_l_e
  87.          Specifies a Boolean value that indicates whether
  88.          this procedure should be called or removed on
  89.          the nonmaskable events (_G_r_a_p_h_i_c_s_E_x_p_o_s_e,
  90.          _N_o_E_x_p_o_s_e, _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,
  91.          _S_e_l_e_c_t_i_o_n_N_o_t_i_f_y, _C_l_i_e_n_t_M_e_s_s_a_g_e, and
  92.          _M_a_p_p_i_n_g_N_o_t_i_f_y).
  93.  
  94.        _p_r_o_c     Specifies the procedure that is to be added or
  95.          removed.
  96.  
  97.        _w     Specifies the widget for which this event han-
  98.          dler is being registered.
  99.  
  100.        _p_o_s_i_t_i_o_n     Specifies when the event handler is to be called
  101.          relative to other previously registered han-
  102.          dlers.
  103.  
  104. DDEESSCCRRIIPPTTIIOONN
  105.        The _X_t_A_d_d_E_v_e_n_t_H_a_n_d_l_e_r function registers a procedure with
  106.        the dispatch mechanism that is to be called when an event
  107.        that matches the mask occurs on the specified widget.  If
  108.        the procedure is already registered with the same
  109.        client_data, the specified mask is ORed into the existing
  110.        mask.  If the widget is realized, _X_t_A_d_d_E_v_e_n_t_H_a_n_d_l_e_r calls
  111.        _X_S_e_l_e_c_t_I_n_p_u_t, if necessary.
  112.  
  113.        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 _X_t_A_d_d_-
  114.        _E_v_e_n_t_H_a_n_d_l_e_r except that it does not affect the widget's
  115.        mask and never causes an _X_S_e_l_e_c_t_I_n_p_u_t for its events.
  116.        Note that the widget might already have those mask bits
  117.        set because of other nonraw event handlers registered on
  118.        it.
  119.  
  120.        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
  121.        procedure from receiving the specified events.  Because
  122.        the procedure is a raw event handler, this does not affect
  123.        the widget's mask and never causes a call on _X_S_e_l_e_c_t_I_n_p_u_t.
  124.  
  125.        _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
  126.        with the additional _p_o_s_i_t_i_o_n argument. if _p_o_s_i_t_i_o_n is
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XtAddEventHandler(3Xt)       XT FUNCTIONS       XtAddEventHandler(3Xt)
  137.  
  138.  
  139.        _X_t_L_i_s_t_H_e_a_d, the event handler is registered to that it
  140.        will be called before any event handlers that were previ-
  141.        ously registered for the same widget.  If _p_o_s_i_t_i_o_n is
  142.        _X_t_L_i_s_t_T_a_i_l, the event handler is registered to be called
  143.        after any previously registered event handlers. If the
  144.        procedure is already registered with the same _c_l_i_e_n_t___d_a_t_a
  145.        value, the specified mask augments the existing mask and
  146.        the procedure is repositioned in the list.
  147.  
  148.        _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
  149.        except that it does not modify the widget's event mask and
  150.        never causes an _X_S_e_l_e_c_t_I_n_p_u_t for the specified events. If
  151.        the procedure is already registered with the same
  152.        _c_l_i_e_n_t___d_a_t_a value, the specified mask augments the exist-
  153.        ing mask and the procedure is repositioned in the list.
  154.  
  155. SSEEEE AALLSSOO
  156.        XtAppNextEvent(3Xt), XtBuildEventMask(3Xt)
  157.        _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
  158.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  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.