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