home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xtungrabpointer.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  8.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XtGrabKey(3Xt)           XT FUNCTIONS           XtGrabKey(3Xt)
  5.  
  6.  
  7. NNAAMMEE
  8.        XtGrabKey, XtUngrabKey, XtGrabKeyboard, XtUngrabKeyboard,
  9.        XtGrabButton, XtUngrabButton, XtGrabPointer, XtUngrab-
  10.        Pointer - manage grabs
  11.  
  12. SSYYNNTTAAXX
  13.        void XtGrabKey(_w_i_d_g_e_t, _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,
  14.        _p_o_i_n_t_e_r___m_o_d_e, _k_e_y_b_o_a_r_d___m_o_d_e)
  15.          Widget _w_i_d_g_e_t;
  16.          KeyCode _k_e_y_c_o_d_e;
  17.          Modifiers _m_o_d_i_f_i_e_r_s;
  18.          Boolean _o_w_n_e_r___e_v_e_n_t_s;
  19.          int _p_o_i_n_t_e_r___m_o_d_e;
  20.          int _k_e_y_b_o_a_r_d___m_o_d_e;
  21.  
  22.        void XtUngrabKey(_w_i_d_g_e_t, _k_e_y_c_o_d_e, _m_o_d_i_f_i_e_r_s)
  23.          Widget _w_i_d_g_e_t;
  24.          KeyCode _k_e_y_c_o_d_e;
  25.          Modifiers _m_o_d_i_f_i_e_r_s;
  26.  
  27.        int XtGrabKeyboard(_w_i_d_g_e_t, _o_w_n_e_r___e_v_e_n_t_s, _p_o_i_n_t_e_r___m_o_d_e,
  28.        _k_e_y_b_o_a_r_d___m_o_d_e, _t_i_m_e)
  29.          Widget _w_i_d_g_e_t;
  30.          Boolean _o_w_n_e_r___e_v_e_n_t_s;
  31.          int _p_o_i_n_t_e_r___m_o_d_e;
  32.          int _k_e_y_b_o_a_r_d___m_o_d_e;
  33.          Time _t_i_m_e;
  34.  
  35.        void XtUngrabKeyboard(_w_i_d_g_e_t, _t_i_m_e)
  36.          Widget _w_i_d_g_e_t;
  37.          Time _t_i_m_e;
  38.  
  39.        void XtGrabButton(_w_i_d_g_e_t, _b_u_t_t_o_n, _m_o_d_i_f_i_e_r_s, _o_w_n_e_r___e_v_e_n_t_s,
  40.        _e_v_e_n_t___m_a_s_k, _p_o_i_n_t_e_r___m_o_d_e, _k_e_y_b_o_a_r_d___m_o_d_e, _c_o_n_f_i_n_e___t_o, _c_u_r_-
  41.        _s_o_r)
  42.          Widget _w_i_d_g_e_t;
  43.          int _b_u_t_t_o_n;
  44.          Modifiers _m_o_d_i_f_i_e_r_s;
  45.          Boolean _o_w_n_e_r___e_v_e_n_t_s;
  46.          unsigned int _e_v_e_n_t___m_a_s_k;
  47.          int _p_o_i_n_t_e_r___m_o_d_e;
  48.          int _k_e_y_b_o_a_r_d___m_o_d_e;
  49.          Window _c_o_n_f_i_n_e___t_o;
  50.          Cursor _c_u_r_s_o_r;
  51.  
  52.        void XtUngrabButton(_w_i_d_g_e_t, _b_u_t_t_o_n, _m_o_d_i_f_i_e_r_s)
  53.          Widget _w_i_d_g_e_t;
  54.          KeyCode _b_u_t_t_o_n;
  55.          Modifiers _m_o_d_i_f_i_e_r_s;
  56.  
  57.        int XtGrabPointer(_w_i_d_g_e_t, _o_w_n_e_r___e_v_e_n_t_s, _e_v_e_n_t___m_a_s_k,
  58.        _p_o_i_n_t_e_r___m_o_d_e, _k_e_y_b_o_a_r_d___m_o_d_e, _c_o_n_f_i_n_e___t_o, _c_u_r_s_o_r, _t_i_m_e)
  59.          Widget _w_i_d_g_e_t;
  60.          Boolean _o_w_n_e_r___e_v_e_n_t_s;
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XtGrabKey(3Xt)           XT FUNCTIONS           XtGrabKey(3Xt)
  71.  
  72.  
  73.          unsigned int _e_v_e_n_t___m_a_s_k;
  74.          int _p_o_i_n_t_e_r___m_o_d_e;
  75.          int _k_e_y_b_o_a_r_d___m_o_d_e;
  76.          Window _c_o_n_f_i_n_e___t_o;
  77.          Cursor _c_u_r_s_o_r;
  78.          Time _t_i_m_e;
  79.  
  80.        void XtUngrabPointer(_w_i_d_g_e_t, _t_i_m_e)
  81.          Widget _w_i_d_g_e_t;
  82.          Time _t_i_m_e;
  83.  
  84.  
  85. AARRGGUUMMEENNTTSS
  86.        _w_i_d_g_e_t     Specifies the widget in whose window the grab
  87.          will occur. Must be of class Core or a subclass
  88.          thereof.
  89.  
  90.        _k_e_y_c_o_d_e
  91.        _m_o_d_i_f_i_e_r_s
  92.        _o_w_n_e_r___e_v_e_n_t_s
  93.        _p_o_i_n_t_e_r___m_o_d_e
  94.        _k_e_y_b_o_a_r_d___m_o_d_e
  95.        _t_i_m_e
  96.        _b_u_t_t_o_n
  97.        _c_o_n_f_i_n_e___t_o
  98.        _c_u_r_s_o_r     Specifies arguments to the associated Xlib func-
  99.          tion call.
  100.  
  101. DDEESSCCRRIIPPTTIIOONN
  102.        _X_t_G_r_a_b_K_e_y calls _X_G_r_a_b_K_e_y specifying the widget's window as
  103.        the grab window if the widget is realized. The remaining
  104.        arguments are exactly as for _X_G_r_a_b_K_e_y.  If the widget is
  105.        not realized, or is later unrealized, the call to _X_G_r_a_b_K_e_y
  106.        will be performed (again) when the widget is realized and
  107.        its window becomes mapped. In the future, if _X_t_D_i_s_-
  108.        _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
  109.        specified keycode and modifiers (which may be _A_n_y_K_e_y or
  110.        _A_n_y_M_o_d_i_f_i_e_r, respectively) for the widget's window, the
  111.        Intrinsics will call _X_t_U_n_g_r_a_b_K_e_y_b_o_a_r_d with the timestamp
  112.        from the _K_e_y_P_r_e_s_s event if either of the following condi-
  113.        tions is true:
  114.  
  115.        +o  There is a modal cascade and the widget is not in the
  116.       active subset of the cascade and the keyboard was not
  117.       previously grabbed, or
  118.  
  119.        +o  _X_F_i_l_t_e_r_E_v_e_n_t returns _T_r_u_e.
  120.  
  121.        _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 win-
  122.        dow as the ungrab window if the widget is realized. The
  123.        remaining arguments are exactly as for _X_U_n_g_r_a_b_K_e_y.  If the
  124.        widget is not realized, _X_t_U_n_g_r_a_b_K_e_y removes a deferred
  125.        _X_t_G_r_a_b_K_e_y request, if any, for the specified widget, key-
  126.        code, and modifiers.
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XtGrabKey(3Xt)           XT FUNCTIONS           XtGrabKey(3Xt)
  137.  
  138.  
  139.        If the specified widget is realized _X_t_G_r_a_b_K_e_y_b_o_a_r_d calls
  140.        _X_G_r_a_b_K_e_y_b_o_a_r_d specifying the widget's window as the grab
  141.        window. The remaining arguments and return value are
  142.        exactly as for _X_G_r_a_b_K_e_y_b_o_a_r_d.  If the widget is not real-
  143.        ized, _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.
  144.        No future ungrab is implied by _X_t_G_r_a_b_K_e_y_b_o_a_r_d.
  145.  
  146.        _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
  147.        time.
  148.  
  149.        _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
  150.        window as the grab window if the widget is realized. The
  151.        remaining arguments are exactly as for _X_G_r_a_b_B_u_t_t_o_n.  If
  152.        the widget is not realized, or is later unrealized, the
  153.        call to _X_G_r_a_b_B_u_t_t_o_n will be performed (again) when the
  154.        widget is realized and its window becomes mapped. In the
  155.        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
  156.        event matching the specified button and modifiers (which
  157.        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
  158.        widget's window, the Intrinsics will call _X_t_U_n_g_r_a_b_P_o_i_n_t_e_r
  159.        with the timestamp from the _B_u_t_t_o_n_P_r_e_s_s event if either of
  160.        the following conditions is true:
  161.  
  162.        +o  There is a modal cascade and the widget is not in the
  163.       active subset of the cascade and the pointer was not
  164.       previously grabbed, or
  165.  
  166.        +o  _X_F_i_l_t_e_r_E_v_e_n_t returns _T_r_u_e.
  167.  
  168.        _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
  169.        window as the ungrab window if the widget is realized. The
  170.        remaining arguments are exactly as for _X_U_n_g_r_a_b_B_u_t_t_o_n.  If
  171.        the widget is not realized, _X_t_U_n_g_r_a_b_B_u_t_t_o_n removes a
  172.        deferred _X_t_G_r_a_b_B_u_t_t_o_n request, if any, for the specified
  173.        widget, button, and modifiers.
  174.  
  175.        _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
  176.        window as the grab window. The remaining arguments and
  177.        return value are exactly as for _X_G_r_a_b_P_o_i_n_t_e_r.  If the wid-
  178.        get is not realized, _X_t_G_r_a_b_P_o_i_n_t_e_r immediately returns
  179.        _G_r_a_b_N_o_t_V_i_e_w_a_b_l_e.     No future ungrab is implied by
  180.        _X_t_G_r_a_b_P_o_i_n_t_e_r.
  181.  
  182.        _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
  183.        time.
  184.  
  185. SSEEEE AALLSSOO
  186.        _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
  187.        _X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.