NAME
XtGrabKey, XtUngrabKey, XtGrabKeyboard, XtUngrabKeyboard, XtGrabButton, XtUngrabButton, XtGrabPointer, XtUngrabPointer - manage grabs
SYNTAX
void XtGrabKey(Widget _w_i_d_g_e_t, KeyCode _k_e_y_c_o_d_e, Modifiers
_m_o_d_i_f_i_e_r_s, Boolean _o_w_n_e_r___e_v_e_n_t_s, int _p_o_i_n_t_e_r___m_o_d_e, int
_k_e_y_b_o_a_r_d___m_o_d_e);
void XtUngrabKey(Widget _w_i_d_g_e_t, KeyCode _k_e_y_c_o_d_e, Modifiers
_m_o_d_i_f_i_e_r_s);
int XtGrabKeyboard(Widget _w_i_d_g_e_t, Boolean _o_w_n_e_r___e_v_e_n_t_s, int
_p_o_i_n_t_e_r___m_o_d_e, int _k_e_y_b_o_a_r_d___m_o_d_e, Time _t_i_m_e);
void XtUngrabKeyboard(Widget _w_i_d_g_e_t, Time _t_i_m_e);
void XtGrabButton(Widget _w_i_d_g_e_t, int _b_u_t_t_o_n, Modifiers
_m_o_d_i_f_i_e_r_s, Boolean _o_w_n_e_r___e_v_e_n_t_s, unsigned int _e_v_e_n_t___m_a_s_k,
int _p_o_i_n_t_e_r___m_o_d_e, int _k_e_y_b_o_a_r_d___m_o_d_e, Window _c_o_n_f_i_n_e___t_o,
Cursor _c_u_r_s_o_r);
void XtUngrabButton(Widget _w_i_d_g_e_t, KeyCode _b_u_t_t_o_n, Modifiers
_m_o_d_i_f_i_e_r_s);
int XtGrabPointer(Widget _w_i_d_g_e_t, Boolean _o_w_n_e_r___e_v_e_n_t_s, unsigned
int _e_v_e_n_t___m_a_s_k, int _p_o_i_n_t_e_r___m_o_d_e, int _k_e_y_b_o_a_r_d___m_o_d_e, Window
_c_o_n_f_i_n_e___t_o, Cursor _c_u_r_s_o_r, Time _t_i_m_e);
void XtUngrabPointer(Widget _w_i_d_g_e_t, Time _t_i_m_e);
ARGUMENTS
-
_w_i_d_g_e_t
Specifies the widget in whose window the grab will occur. Must be of
-
class Core or a subclass thereof.
-
_k_e_y_c_o_d_e
-
-
_m_o_d_i_f_i_e_r_s
-
-
_o_w_n_e_r___e_v_e_n_t_s
-
-
_p_o_i_n_t_e_r___m_o_d_e
-
-
_k_e_y_b_o_a_r_d___m_o_d_e
-
-
_t_i_m_e
-
-
_b_u_t_t_o_n
-
-
_c_o_n_f_i_n_e___t_o
-
-
_c_u_r_s_o_r
Specifies arguments to the associated Xlib function call.
-
DESCRIPTION
_X_t_G_r_a_b_K_e_y
calls
_X_G_r_a_b_K_e_y
specifying the widget's window as the grab window if the widget is
realized. The remaining arguments are exactly as for
_X_G_r_a_b_K_e_y.
If the widget is not realized, or is later unrealized, the call to
_X_G_r_a_b_K_e_y
will be performed (again) when the widget is realized and its window
becomes mapped. In the future, if
_X_t_D_i_s_p_a_t_c_h_E_v_e_n_t
is called with a
_K_e_y_P_r_e_s_s
event matching the specified keycode and modifiers (which may be
_A_n_y_K_e_y
or
_A_n_y_M_o_d_i_f_i_e_r,
respectively) for the widget's window, the Intrinsics will call
_X_t_U_n_g_r_a_b_K_e_y_b_o_a_r_d
with the timestamp from the
_K_e_y_P_r_e_s_s
event if either of the following conditions is true:
-
·
There is a modal cascade and the widget is not in the active subset
-
of the cascade and the keyboard was not previously grabbed, or
-
·
_X_F_i_l_t_e_r_E_v_e_n_t
-
returns
_T_r_u_e.
_X_t_U_n_g_r_a_b_K_e_y
calls
_X_U_n_g_r_a_b_K_e_y
specifying the widget's window as the ungrab window if the widget is
realized. The remaining arguments are exactly as for
_X_U_n_g_r_a_b_K_e_y.
If the widget is not realized,
_X_t_U_n_g_r_a_b_K_e_y
removes a deferred
_X_t_G_r_a_b_K_e_y
request, if any, for the specified widget, keycode, and modifiers.
If the specified widget is realized
_X_t_G_r_a_b_K_e_y_b_o_a_r_d
calls
_X_G_r_a_b_K_e_y_b_o_a_r_d
specifying the widget's window as the grab window. The remaining
arguments and return value are exactly as for
_X_G_r_a_b_K_e_y_b_o_a_r_d.
If the widget is not realized,
_X_t_G_r_a_b_K_e_y_b_o_a_r_d
immediately returns
_G_r_a_b_N_o_t_V_i_e_w_a_b_l_e.
No future ungrab is implied by
_X_t_G_r_a_b_K_e_y_b_o_a_r_d.
_X_t_U_n_g_r_a_b_K_e_y_b_o_a_r_d
calls
_X_U_n_g_r_a_b_K_e_y_b_o_a_r_d
with the specified time.
_X_t_G_r_a_b_B_u_t_t_o_n
calls
_X_G_r_a_b_B_u_t_t_o_n
specifying the widget's window as the grab window if the widget is
realized. The remaining arguments are exactly as for
_X_G_r_a_b_B_u_t_t_o_n.
If the widget is not realized, or is later unrealized, the call to
_X_G_r_a_b_B_u_t_t_o_n
will be performed (again) when the widget is realized and its window
becomes mapped. In the future, if
_X_t_D_i_s_p_a_t_c_h_E_v_e_n_t
is called with a
_B_u_t_t_o_n_P_r_e_s_s
event matching the specified button and modifiers (which may be
_A_n_y_B_u_t_t_o_n
or
_A_n_y_M_o_d_i_f_i_e_r,
respectively) for the widget's window, the Intrinsics will call
_X_t_U_n_g_r_a_b_P_o_i_n_t_e_r
with the timestamp from the
_B_u_t_t_o_n_P_r_e_s_s
event if either of the following conditions is true:
-
·
There is a modal cascade and the widget is not in the active subset
-
of the cascade and the pointer was not previously grabbed, or
-
·
_X_F_i_l_t_e_r_E_v_e_n_t
-
returns
_T_r_u_e.
_X_t_U_n_g_r_a_b_B_u_t_t_o_n
calls
_X_U_n_g_r_a_b_B_u_t_t_o_n
specifying the widget's window as the ungrab window if the widget is
realized. The remaining arguments are exactly as for
_X_U_n_g_r_a_b_B_u_t_t_o_n.
If the widget is not realized,
_X_t_U_n_g_r_a_b_B_u_t_t_o_n
removes a deferred
_X_t_G_r_a_b_B_u_t_t_o_n
request, if any, for the specified widget, button, and modifiers.
_X_t_G_r_a_b_P_o_i_n_t_e_r
calls
_X_G_r_a_b_P_o_i_n_t_e_r
specifying the widget's window as the grab window. The remaining
arguments and return value are exactly as for
_X_G_r_a_b_P_o_i_n_t_e_r.
If the widget is not realized,
_X_t_G_r_a_b_P_o_i_n_t_e_r
immediately returns
_G_r_a_b_N_o_t_V_i_e_w_a_b_l_e.
No future ungrab is implied by
_X_t_G_r_a_b_P_o_i_n_t_e_r.
_X_t_U_n_g_r_a_b_P_o_i_n_t_e_r
calls
_X_U_n_g_r_a_b_P_o_i_n_t_e_r
with the specified time.
SEE ALSO
_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