home *** CD-ROM | disk | FTP | other *** search
/ Geek Gadgets 1 / ADE-1.bin / ade-bin / x11r6.1 / man / cat3 / xallowdeviceevents.0 < prev    next >
Encoding:
Text File  |  1996-10-17  |  7.0 KB  |  199 lines
  1.  
  2.  
  3.  
  4. XAllowDeviceEvents(3X11)   X FUNCTIONS     XAllowDeviceEvents(3X11)
  5.  
  6.  
  7. NNAAMMEE
  8.        XAllowDeviceEvents - release queued events
  9.  
  10. SSYYNNTTAAXX
  11.        XAllowDeviceEvents(_d_i_s_p_l_a_y, _d_e_v_i_c_e, _e_v_e_n_t___m_o_d_e, _t_i_m_e)
  12.          Display *_d_i_s_p_l_a_y;
  13.          XDevice *_d_e_v_i_c_e;
  14.          int _e_v_e_n_t___m_o_d_e;
  15.          Time _t_i_m_e;
  16.  
  17. AARRGGUUMMEENNTTSS
  18.        _d_i_s_p_l_a_y       Specifies the connection to the X server.
  19.  
  20.        _d_e_v_i_c_e       Specifies  the device from which events are to
  21.            be allowed.
  22.  
  23.        _e_v_e_n_t___m_o_d_e  Specifies the event mode.  You can pass _A_s_y_n_c_-
  24.            _T_h_i_s_D_e_v_i_c_e,    _S_y_n_c_T_h_i_s_D_e_v_i_c_e, _R_e_p_l_a_y_T_h_i_s_D_e_v_i_c_e,
  25.            _A_s_y_n_c_O_t_h_e_r_D_e_v_i_c_e_s, _S_y_n_c_A_l_l, or _A_s_y_n_c_A_l_l.
  26.  
  27.        _t_i_m_e       Specifies the time.    You  can  pass    either    a
  28.            timestamp or _C_u_r_r_e_n_t_T_i_m_e.
  29.  
  30. DDEESSCCRRIIPPTTIIOONN
  31.        The   _X_A_l_l_o_w_D_e_v_i_c_e_E_v_e_n_t_s     function  releases  some  queued
  32.        events if the client has caused a device     to  freeze.   It
  33.        has  no    effect    if the specified time is earlier than the
  34.        last-grab time of the most  recent  active  grab     for  the
  35.        client  and device, or if the specified time is later than
  36.        the current X server time.
  37.  
  38.        The following describes the processing that occurs depend-
  39.        ing  on what constant you pass to the event_mode argument.
  40.  
  41.        _A_s_y_n_c_T_h_i_s_D_e_v_i_c_e
  42.            If the  specified  device  is  frozen  by  the
  43.            client,  event processing for that device con-
  44.            tinues as usual.  If the device is frozen mul-
  45.            tiple  times by the client on behalf of multi-
  46.            ple separate grabs, _A_s_y_n_c_T_h_i_s_D_e_v_i_c_e thaws  for
  47.            all.      _A_s_y_n_c_T_h_i_s_D_e_v_i_c_e  has    no  effect if the
  48.            specified device is not frozen by the  client,
  49.            but    the  device  need  not    be grabbed by the
  50.            client.
  51.  
  52.        _S_y_n_c_T_h_i_s_D_e_v_i_c_e
  53.            If the specified device is frozen and actively
  54.            grabbed  by    the  client, event processing for
  55.            that device continues normally until the  next
  56.            key or button event is reported to the client.
  57.            At  this  time,  the     specified  device  again
  58.            appears  to    freeze.     However, if the reported
  59.            event causes the  grab  to  be  released,  the
  60.            specified     device       does       not      freeze.
  61.  
  62.  
  63.  
  64. X Version 11           Release 6.1                1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. XAllowDeviceEvents(3X11)   X FUNCTIONS     XAllowDeviceEvents(3X11)
  71.  
  72.  
  73.            _S_y_n_c_T_h_i_s_D_e_v_i_c_e has no effect if the    specified
  74.            device  is  not frozen by the client or is not
  75.            grabbed by the client.
  76.  
  77.        _R_e_p_l_a_y_T_h_i_s_D_e_v_i_c_e
  78.            If the specified device is actively grabbed by
  79.            the    client    and is frozen as the result of an
  80.            event having been sent to the  client  (either
  81.            from     the  activation of a GrabDeviceButton or
  82.            from a previous  AllowDeviceEvents  with  mode
  83.            SyncThisDevice,  but     not  from a GrabDevice),
  84.            the grab is released and that  event     is  com-
  85.            pletely  reprocessed.  This time, however, the
  86.            request ignores any passive grabs at or  above
  87.            (toward  the root) that the grab-window of the
  88.            grab just released.    The request has no effect
  89.            if  the specified device is not grabbed by the
  90.            client or if it is not frozen as the result of
  91.            an event.
  92.  
  93.        _A_s_y_n_c_O_t_h_e_r_D_e_v_i_c_e_s
  94.            If  the  remaining  devices    are frozen by the
  95.            client, event processing for them continues as
  96.            usual.  If the other devices are frozen multi-
  97.            ple times by the client on behalf of     multiple
  98.            grabs,   _A_s_y_n_c_O_t_h_e_r_D_e_v_i_c_e_s  "thaws"    for  all.
  99.            _A_s_y_n_c_O_t_h_e_r_D_e_v_i_c_e_s has no effect if the devices
  100.            are not frozen by the client.
  101.  
  102.        _S_y_n_c_A_l_l       If all devices are frozen by the client, event
  103.            processing (for all    devices)  continues  nor-
  104.            mally  until     the  next button or key event is
  105.            reported to the client for a     grabbed  device,
  106.            at  which  time  all     devices  again appear to
  107.            freeze.  However, if the reported event causes
  108.            the    grab  to be released, then the devices do
  109.            not freeze.    If any device is  still     grabbed,
  110.            then     a  subsequent    event  for  it will still
  111.            cause all devices to freeze.     _S_y_n_c_A_l_l  has  no
  112.            effect  unless  all    devices are frozen by the
  113.            client.  If any device is frozen twice by  the
  114.            client  on  behalf of two separate grabs, _S_y_n_-
  115.            _c_A_l_l thaws for both.     A subsequent freeze  for
  116.            _S_y_n_c_A_l_l will only freeze each device once.
  117.  
  118.        _A_s_y_n_c_A_l_l       If all devices are frozen by the client, event
  119.            processing for all devices continues normally.
  120.            If  any device is frozen multiple times by the
  121.            client on behalf of multiple     separate  grabs,
  122.            _A_s_y_n_c_A_l_l  thaws  for     all.    _A_s_y_n_c_A_l_l  has  no
  123.            effect unless all devices are  frozen  by  the
  124.            client.
  125.  
  126.        _A_s_y_n_c_T_h_i_s_D_e_v_i_c_e, _S_y_n_c_T_h_i_s_D_e_v_i_c_e, and _R_e_p_l_a_y_T_h_i_s_D_e_v_i_c_e have
  127.  
  128.  
  129.  
  130. X Version 11           Release 6.1                2
  131.  
  132.  
  133.  
  134.  
  135.  
  136. XAllowDeviceEvents(3X11)   X FUNCTIONS     XAllowDeviceEvents(3X11)
  137.  
  138.  
  139.        no effect on the processing of events from  the    remaining
  140.        devices.      _A_s_y_n_c_O_t_h_e_r_D_e_v_i_c_e_s has no effect on the process-
  141.        ing  of    events    from  the  specified  device.    When  the
  142.        event_mode is _S_y_n_c_A_l_l or _A_s_y_n_c_A_l_l, the device parameter is
  143.        ignored.
  144.  
  145.        It is possible for several grabs of different  devices  by
  146.        the same or different clients to be active simultaneously.
  147.        If a device is frozen on behalf of any grab, no event pro-
  148.        cessing is performed for the device.  It is possible for a
  149.        single device to be frozen because of several  grabs.   In
  150.        this  case,  the freeze must be released on behalf of each
  151.        grab before events can again be processed.
  152.  
  153.        _X_A_l_l_o_w_D_e_v_i_c_e_E_v_e_n_t_s can generate a  _B_a_d_D_e_v_i_c_e  or     _B_a_d_V_a_l_u_e
  154.        error.
  155.  
  156. DDIIAAGGNNOOSSTTIICCSS
  157.        _B_a_d_D_e_v_i_c_e   An  invalid    device was specified.  The speci-
  158.            fied device does not exist  or  has    not  been
  159.            opened  by  this  client via _X_O_p_e_n_I_n_p_u_t_D_e_v_i_c_e.
  160.            This error may also    occur  if  the    specified
  161.            device  is the X keyboard or X pointer device.
  162.  
  163.        _B_a_d_V_a_l_u_e       An invalid mode was specified on the     request.
  164.  
  165. SSEEEE AALLSSOO
  166.        XGrabDevice(3X11)
  167.        _P_r_o_g_r_a_m_m_i_n_g _W_i_t_h _X_l_i_b
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.  
  196. X Version 11           Release 6.1                3
  197.  
  198.  
  199.