home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtremoveeventtypehandler.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  9.5 KB  |  265 lines
  1.  
  2.  
  3.  
  4. XtInsertEventTypeHandler(3XtX)T FUNCTIOXNtSInsertEventTypeHandler(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtInsertEventTypeHandler, XtRemoveEventTypeHandler, XtReg-
  9.        isterExtensionSelector, XtSetEventDispatcher, XtDispatch-
  10.        EventToWidget - extension event handling
  11.  
  12. SSYYNNTTAAXX
  13.        void XtInsertEventTypeHandler(_w_i_d_g_e_t, _e_v_e_n_t___t_y_p_e,
  14.        _s_e_l_e_c_t___d_a_t_a, _p_r_o_c, _c_l_i_e_n_t___d_a_t_a, _p_o_s_i_t_i_o_n)
  15.          Widget _w_d_g_e_t;
  16.          int _e_v_e_n_t___t_y_p_e;
  17.          XtPointer _s_e_l_e_c_t___d_a_t_a;
  18.          XtEventHandler _p_r_o_c;
  19.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  20.          XtListPosition _p_o_s_i_t_i_o_n;
  21.  
  22.        void XtRemoveEventTypeHandler(_w_i_d_g_e_t, _e_v_e_n_t___t_y_p_e,
  23.        _s_e_l_e_c_t___d_a_t_a, _p_r_o_c, _c_l_i_e_n_t___d_a_t_a)
  24.          Widget _w_d_g_e_t;
  25.          int _e_v_e_n_t___t_y_p_e;
  26.          XtPointer _s_e_l_e_c_t___d_a_t_a;
  27.          XtEventHandler _p_r_o_c;
  28.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  29.  
  30.        void XtRegisterExtensionSelector(_d_i_s_p_l_a_y, _m_i_n___e_v_e_n_t___t_y_p_e,
  31.        _m_a_x___e_v_e_n_t___t_y_p_e, _p_r_o_c, _c_l_i_e_n_t___d_a_t_a)
  32.          Display* _d_i_s_p_l_a_y;
  33.          int _m_i_n___e_v_e_n_t___t_y_p_e;
  34.          int _m_a_x___e_v_e_n_t___t_y_p_e;
  35.          XtExtensionSelectProc _p_r_o_c;
  36.          XtPointer _c_l_i_e_n_t___d_a_t_a;
  37.  
  38.        XtEventDispatchProc XtSetEventDispatcher(_d_i_s_p_l_a_y,
  39.        _e_v_e_n_t___t_y_p_e, _p_r_o_c)
  40.          Widget _w_i_d_g_e_t;
  41.          int _e_v_e_n_t___t_y_p_e;
  42.          XtEventDispatchProc _p_r_o_c;
  43.  
  44.        Boolean XtDispatchEventToWidget(_w_i_d_g_e_t, _e_v_e_n_t)
  45.          Widget _w_i_d_g_e_t;
  46.          XEvent* _e_v_e_n_t;
  47.  
  48.  
  49. AARRGGUUMMEENNTTSS
  50.        _w_i_d_g_e_t     Specifies the widget for this event handler.
  51.          Must be of class Core or any subclass thereof.
  52.  
  53.        _e_v_e_n_t___t_y_p_e
  54.          Specifies the event type.
  55.  
  56.        _s_e_l_e_c_t___d_a_t_a
  57.          Specifies data used to select or deselect events
  58.          from the server.
  59.  
  60.        _p_r_o_c     Specifies the proc.
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtInsertEventTypeHandler(3XtX)T FUNCTIOXNtSInsertEventTypeHandler(3Xt)
  71.  
  72.  
  73.        _c_l_i_e_n_t___d_a_t_a
  74.          Specifies additional data to be passed to the
  75.          event handler.
  76.  
  77.        _p_o_s_i_t_i_o_n     Specifies when the event handler is to be called
  78.          relative to other previously registered han-
  79.          dlers.
  80.  
  81.        _d_i_s_p_l_a_y     Specifies the display.
  82.  
  83.        _m_i_n___e_v_e_n_t___t_y_p_e_, _m_a_x___e_v_e_n_t___t_y_p_e
  84.          Specifies the range of event types for this
  85.          extension.
  86.  
  87.        _e_v_e_n_t     Specifies a pointer to the event to be dis-
  88.          patched.
  89.  
  90. DDEESSCCRRIIPPTTIIOONN
  91.        The _X_t_I_n_s_e_r_t_E_v_e_n_t_T_y_p_e_H_a_n_d_l_e_r function registeres a proce-
  92.        dure with the dispatch mechanism that is to be called when
  93.        an event that matches the specified _e_v_e_n_t___t_y_p_e is dis-
  94.        patched to the specified _w_i_d_g_e_t.
  95.  
  96.        If _e_v_e_n_t___t_y_p_e is one of the core X protocol events then
  97.        _s_e_l_e_c_t___d_a_t_a must be a pointer to a value of type
  98.        _E_v_e_n_t_M_a_s_k, indicating the event mask to be used to select
  99.        for the desired event.  This event mask will be included
  100.        in the value returned by _X_t_B_u_i_l_d_E_v_e_n_t_M_a_s_k.  If the widget
  101.        is realized _X_t_I_n_s_e_r_t_E_v_e_n_t_T_y_p_e_H_a_n_d_l_e_r calls _X_S_e_l_e_c_t_I_n_p_u_t if
  102.        necessary. Specifying NULL for _s_e_l_e_c_t___d_a_t_a is equivalent
  103.        to specifying a pointer to an event mask containing 0.
  104.        This is similar to the _X_t_I_n_s_e_r_t_R_a_w_E_v_e_n_t_H_a_n_d_l_e_r function.
  105.  
  106.        If _e_v_e_n_t___t_y_p_e specifies an extension event type then the
  107.        semantics of the data pointed to by _s_e_l_e_c_t___d_a_t_a are
  108.        defined by the extension selector registered for the spec-
  109.        ified event type.
  110.  
  111.        In either case the Intrinsics are not required to copy the
  112.        data pointed to by _s_e_l_e_c_t___d_a_t_a, so the caller must ensure
  113.        that it remains valid as long as the event handler remains
  114.        registered with this value of _s_e_l_e_c_t___d_a_t_a.
  115.  
  116.        The _p_o_s_i_t_i_o_n argument allows the client to control the
  117.        order of the invocation of event handlers registered for
  118.        the same event type. If the client does not care about the
  119.        order, it should normally specify _X_t_L_i_s_t_T_a_i_l, which regis-
  120.        ters this event handler after any previously registered
  121.        handlers for this event type.
  122.  
  123.        The _X_t_R_e_m_o_v_e_E_v_e_n_t_T_y_p_e_H_a_n_d_l_e_r function unregisters an even
  124.        handler registered with _X_t_I_n_s_e_r_t_E_v_e_n_t_T_y_p_e_H_a_n_d_l_e_r for the
  125.        specified event type. The request is ignored if
  126.        _c_l_i_e_n_t___d_a_t_a does not match the value given with the
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XtInsertEventTypeHandler(3XtX)T FUNCTIOXNtSInsertEventTypeHandler(3Xt)
  137.  
  138.  
  139.        handler was registered.
  140.  
  141.        If _e_v_e_n_t___t_y_p_e specifies on of the core X protocol events,
  142.        _s_e_l_e_c_t___d_a_t_a must be a pointer to a value of type
  143.        _E_v_e_n_t_M_a_s_k, indicating the mask to be used to deselect for
  144.        the appropriate event.  If the widget is realized,
  145.        _X_t_R_e_m_o_v_e_E_v_e_n_t_T_y_p_e_H_a_n_d_l_e_r calls _X_S_e_l_e_c_t_I_n_p_u_t if necessary.
  146.        Specifying NULL for _s_e_l_e_c_t___d_a_t_a is equivalent to specify-
  147.        ing a pointer to an event mask containing 0. This is simi-
  148.        lar to 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.
  149.  
  150.        If _e_v_e_n_t___t_y_p_e specifies an extension event type then the
  151.        semantics of the data pointed to by _s_e_l_e_c_t___d_a_t_a are
  152.        defined by the extension selector registered for the spec-
  153.        ified event type.
  154.  
  155.        The _X_t_R_e_g_i_s_t_e_r_E_x_t_e_n_s_i_o_n_S_e_l_e_c_t_o_r function registers a pro-
  156.        cedure to arrange for the delivery of extension events to
  157.        widgets.
  158.  
  159.        If _m_i_n___e_v_e_n_t___t_y_p_e and _m_a_x___e_v_e_n_t___t_y_p_e match the parameters
  160.        to a previous call to _X_t_R_e_g_i_s_t_e_r_E_x_t_e_n_s_i_o_n_S_e_l_e_c_t_o_r for the
  161.        same display, the _p_r_o_c and _c_l_i_e_n_t___d_a_t_a replace the previ-
  162.        ously registered values. If the range specified by
  163.        _m_i_n___e_v_e_n_t___t_y_p_e and _m_a_x___e_v_e_n_t___t_y_p_e overlaps the range of
  164.        the parameters to a previous call for the same display in
  165.        any other way, an error results.
  166.  
  167.        The _X_t_S_e_t_E_v_e_n_t_D_i_s_p_a_t_c_h_e_r function registes the event dis-
  168.        patcher procedure specified by _p_r_o_c for event swith the
  169.        type _e_v_e_n_t___t_y_p_e. The previously registered dispatcher (or
  170.        the default dispatcher if there was no previousl regis-
  171.        tered dispatcher) is returned. If _p_r_o_c is NULL, the
  172.        default procedure is restored for the specified type.
  173.  
  174.        In the future, when _X_t_D_i_s_p_a_t_c_h_E_v_e_n_t is called with an
  175.        event of _e_v_e_n_t___t_y_p_e, the specified _p_r_o_c (or the default
  176.        dispatcher) will be invoked to determine a widget ot which
  177.        to dispatch the event.
  178.  
  179.        The _X_t_D_i_s_p_a_t_c_h_E_v_e_n_t_T_o_W_i_d_g_e_t function scans the list of
  180.        registered event handlers for the specified widget and
  181.        calls each handler that has been registered for the speci-
  182.        fied event type, subject to the _c_o_n_t_i_n_u_e___t_o___d_i_s_p_a_t_c_h value
  183.        returned by each handler. The Intrinsics behave as if
  184.        event handlers were registered at the head of the list for
  185.        _E_x_p_o_s_e, _N_o_E_x_p_o_s_e, _G_r_a_p_h_i_c_s_E_x_p_o_s_e, and _V_i_s_i_b_i_l_i_t_y_N_o_t_i_f_y
  186.        events to invoke the widget's expose procedure according
  187.        to the exposure compression rules and to update the wid-
  188.        get's _v_i_s_i_b_l_e field if _v_i_s_i_b_l_e___i_n_t_e_r_e_s_t is _T_r_u_e.     These
  189.        internal event handlers never set _c_o_n_t_i_n_u_e___t_o___d_i_s_p_a_t_c_h to
  190.        _F_a_l_s_e.
  191.  
  192.        _X_t_D_i_s_p_a_t_c_h_E_v_e_n_t_T_o_W_i_d_g_e_t returns _T_r_u_e if any event handler
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.  
  200.  
  201.  
  202. XtInsertEventTypeHandler(3XtX)T FUNCTIOXNtSInsertEventTypeHandler(3Xt)
  203.  
  204.  
  205.        was called and _F_a_l_s_e otherwise.
  206.  
  207.  
  208. SSEEEE AALLSSOO
  209.        XtGetKeyboardFocusWidget(3Xt)
  210.        _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
  211.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262. X Version 11           Release 6.1                4
  263.  
  264.  
  265.