home *** CD-ROM | disk | FTP | other *** search
-
-
-
- XtInsertEventTypeHandler(3XtX)T FUNCTIOXNtSInsertEventTypeHandler(3Xt)
-
-
- NNAAMMEE
- XtInsertEventTypeHandler, XtRemoveEventTypeHandler, XtReg-
- isterExtensionSelector, XtSetEventDispatcher, XtDispatch-
- EventToWidget - extension event handling
-
- SSYYNNTTAAXX
- void XtInsertEventTypeHandler(_w_i_d_g_e_t, _e_v_e_n_t___t_y_p_e,
- _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)
- Widget _w_d_g_e_t;
- int _e_v_e_n_t___t_y_p_e;
- XtPointer _s_e_l_e_c_t___d_a_t_a;
- XtEventHandler _p_r_o_c;
- XtPointer _c_l_i_e_n_t___d_a_t_a;
- XtListPosition _p_o_s_i_t_i_o_n;
-
- void XtRemoveEventTypeHandler(_w_i_d_g_e_t, _e_v_e_n_t___t_y_p_e,
- _s_e_l_e_c_t___d_a_t_a, _p_r_o_c, _c_l_i_e_n_t___d_a_t_a)
- Widget _w_d_g_e_t;
- int _e_v_e_n_t___t_y_p_e;
- XtPointer _s_e_l_e_c_t___d_a_t_a;
- XtEventHandler _p_r_o_c;
- XtPointer _c_l_i_e_n_t___d_a_t_a;
-
- void XtRegisterExtensionSelector(_d_i_s_p_l_a_y, _m_i_n___e_v_e_n_t___t_y_p_e,
- _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)
- Display* _d_i_s_p_l_a_y;
- int _m_i_n___e_v_e_n_t___t_y_p_e;
- int _m_a_x___e_v_e_n_t___t_y_p_e;
- XtExtensionSelectProc _p_r_o_c;
- XtPointer _c_l_i_e_n_t___d_a_t_a;
-
- XtEventDispatchProc XtSetEventDispatcher(_d_i_s_p_l_a_y,
- _e_v_e_n_t___t_y_p_e, _p_r_o_c)
- Widget _w_i_d_g_e_t;
- int _e_v_e_n_t___t_y_p_e;
- XtEventDispatchProc _p_r_o_c;
-
- Boolean XtDispatchEventToWidget(_w_i_d_g_e_t, _e_v_e_n_t)
- Widget _w_i_d_g_e_t;
- XEvent* _e_v_e_n_t;
-
-
- AARRGGUUMMEENNTTSS
- _w_i_d_g_e_t Specifies the widget for this event handler.
- Must be of class Core or any subclass thereof.
-
- _e_v_e_n_t___t_y_p_e
- Specifies the event type.
-
- _s_e_l_e_c_t___d_a_t_a
- Specifies data used to select or deselect events
- from the server.
-
- _p_r_o_c Specifies the proc.
-
-
-
- X Version 11 Release 6.1 1
-
-
-
-
-
- XtInsertEventTypeHandler(3XtX)T FUNCTIOXNtSInsertEventTypeHandler(3Xt)
-
-
- _c_l_i_e_n_t___d_a_t_a
- Specifies additional data to be passed to the
- event handler.
-
- _p_o_s_i_t_i_o_n Specifies when the event handler is to be called
- relative to other previously registered han-
- dlers.
-
- _d_i_s_p_l_a_y Specifies the display.
-
- _m_i_n___e_v_e_n_t___t_y_p_e_, _m_a_x___e_v_e_n_t___t_y_p_e
- Specifies the range of event types for this
- extension.
-
- _e_v_e_n_t Specifies a pointer to the event to be dis-
- patched.
-
- DDEESSCCRRIIPPTTIIOONN
- 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-
- dure with the dispatch mechanism that is to be called when
- an event that matches the specified _e_v_e_n_t___t_y_p_e is dis-
- patched to the specified _w_i_d_g_e_t.
-
- If _e_v_e_n_t___t_y_p_e is one of the core X protocol events then
- _s_e_l_e_c_t___d_a_t_a must be a pointer to a value of type
- _E_v_e_n_t_M_a_s_k, indicating the event mask to be used to select
- for the desired event. This event mask will be included
- in the value returned by _X_t_B_u_i_l_d_E_v_e_n_t_M_a_s_k. If the widget
- 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
- necessary. Specifying NULL for _s_e_l_e_c_t___d_a_t_a is equivalent
- to specifying a pointer to an event mask containing 0.
- 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.
-
- If _e_v_e_n_t___t_y_p_e specifies an extension event type then the
- semantics of the data pointed to by _s_e_l_e_c_t___d_a_t_a are
- defined by the extension selector registered for the spec-
- ified event type.
-
- In either case the Intrinsics are not required to copy the
- data pointed to by _s_e_l_e_c_t___d_a_t_a, so the caller must ensure
- that it remains valid as long as the event handler remains
- registered with this value of _s_e_l_e_c_t___d_a_t_a.
-
- The _p_o_s_i_t_i_o_n argument allows the client to control the
- order of the invocation of event handlers registered for
- the same event type. If the client does not care about the
- order, it should normally specify _X_t_L_i_s_t_T_a_i_l, which regis-
- ters this event handler after any previously registered
- handlers for this event type.
-
- 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
- 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
- specified event type. The request is ignored if
- _c_l_i_e_n_t___d_a_t_a does not match the value given with the
-
-
-
- X Version 11 Release 6.1 2
-
-
-
-
-
- XtInsertEventTypeHandler(3XtX)T FUNCTIOXNtSInsertEventTypeHandler(3Xt)
-
-
- handler was registered.
-
- If _e_v_e_n_t___t_y_p_e specifies on of the core X protocol events,
- _s_e_l_e_c_t___d_a_t_a must be a pointer to a value of type
- _E_v_e_n_t_M_a_s_k, indicating the mask to be used to deselect for
- the appropriate event. If the widget is realized,
- _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.
- Specifying NULL for _s_e_l_e_c_t___d_a_t_a is equivalent to specify-
- ing a pointer to an event mask containing 0. This is simi-
- 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.
-
- If _e_v_e_n_t___t_y_p_e specifies an extension event type then the
- semantics of the data pointed to by _s_e_l_e_c_t___d_a_t_a are
- defined by the extension selector registered for the spec-
- ified event type.
-
- 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-
- cedure to arrange for the delivery of extension events to
- widgets.
-
- 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
- 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
- same display, the _p_r_o_c and _c_l_i_e_n_t___d_a_t_a replace the previ-
- ously registered values. If the range specified by
- _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
- the parameters to a previous call for the same display in
- any other way, an error results.
-
- 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-
- patcher procedure specified by _p_r_o_c for event swith the
- type _e_v_e_n_t___t_y_p_e. The previously registered dispatcher (or
- the default dispatcher if there was no previousl regis-
- tered dispatcher) is returned. If _p_r_o_c is NULL, the
- default procedure is restored for the specified type.
-
- In the future, when _X_t_D_i_s_p_a_t_c_h_E_v_e_n_t is called with an
- event of _e_v_e_n_t___t_y_p_e, the specified _p_r_o_c (or the default
- dispatcher) will be invoked to determine a widget ot which
- to dispatch the event.
-
- 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
- registered event handlers for the specified widget and
- calls each handler that has been registered for the speci-
- 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
- returned by each handler. The Intrinsics behave as if
- event handlers were registered at the head of the list for
- _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
- events to invoke the widget's expose procedure according
- to the exposure compression rules and to update the wid-
- 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
- internal event handlers never set _c_o_n_t_i_n_u_e___t_o___d_i_s_p_a_t_c_h to
- _F_a_l_s_e.
-
- _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
-
-
-
- X Version 11 Release 6.1 3
-
-
-
-
-
- XtInsertEventTypeHandler(3XtX)T FUNCTIOXNtSInsertEventTypeHandler(3Xt)
-
-
- was called and _F_a_l_s_e otherwise.
-
-
- SSEEEE AALLSSOO
- XtGetKeyboardFocusWidget(3Xt)
- _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
- _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
-
- X Version 11 Release 6.1 4
-
-
-